私が開発すると、コードが多くのファイルに広がっている、typescriptプロジェクトがあります。Typescriptプロジェクトをビルドして配布します
私はそのプロジェクトに単一のjsファイルとdtsファイルを配布したいのですが、それを行うにはどうすればよいでしょうか?
私が開発すると、コードが多くのファイルに広がっている、typescriptプロジェクトがあります。Typescriptプロジェクトをビルドして配布します
私はそのプロジェクトに単一のjsファイルとdtsファイルを配布したいのですが、それを行うにはどうすればよいでしょうか?
ファイルをパッケージ化する場合、通常、ファイルを1つのファイルにまとめる必要はありません。パッケージマネージャー(NPMなど)を使用すると、ファイルをパッケージにまとめて保存したり、パブリックにすることができます。パッケージには、モジュールを実行するために必要なすべてのファイルが含まれています。
特にTypeScriptの場合、.js
と.d.ts
ファイルをパッケージ化します。これは、パッケージがTypeScriptとJavaScriptの両方のコンシューマで動作することを意味します。パッケージに.ts
ファイルを追加しないでください。
ブラウザとノードの両方の環境をターゲットにしている場合、両方の環境で動作するUMD
モジュールを使用できます。
実例 - TypeSpec。
注意 - 私は、コンテキストが存在することを確認するために以下のファイル全体を置いていますが、重要なビットは通常1行または2行です。
TypeScript設定ファイル - 重要なビットは「モジュール」種類であり、「宣言」ファイルを発行します。
{
"compileOnSave": true,
"compilerOptions": {
"target": "ES5",
"module": "umd", // <--
"strict": true,
"experimentalDecorators": true,
"noEmitOnError": false,
"noFallthroughCasesInSwitch": true,
"noImplicitReturns": true,
"sourceMap": true,
"removeComments": false,
"declaration": true, // <--
"downlevelIteration": true,
"noUnusedLocals": true,
"noUnusedParameters": false
}
}
ガルプファイル - これはpackage.jsonとreadmeファイルをincuding、dist
フォルダにファイルを移動しますが、最も重要なのは、すべてのJavaScriptと型定義の。
var gulp = require('gulp');
gulp.task('default', function() {
gulp.src('./node_modules/requirejs/require.js')
.pipe(gulp.dest('./lib'));
// This bit moves type definitions
gulp.src('./Scripts/TypeSpec/*.d.ts')
.pipe(gulp.dest('./dist/src'));
// And this bit moves the JavaScript
gulp.src('./Scripts/TypeSpec/*.js')
.pipe(gulp.dest('./dist/src'));
gulp.src('../README.md')
.pipe(gulp.dest('./dist'));
gulp.src('./package.json')
.pipe(gulp.dest('./dist'));
});
メインソースファイルpackage.jsonファイルのヒントや情報を入力するには、「メイン」と「種類」のセクションに記載されています:
{
"author": "Steve Fenton",
"name": "typespec-bdd",
"description": "BDD framework for TypeScript.",
"keywords": [
"typespec",
"typescript",
"bdd",
"behaviour",
"driven"
],
"version": "0.7.1",
"homepage": "https://github.com/Steve-Fenton/TypeSpec",
"bugs": "https://github.com/Steve-Fenton/TypeSpec/issues",
"license": "(Apache-2.0)",
"files": [
"src/"
],
"repository": {
"url": "https://github.com/Steve-Fenton/TypeSpec"
},
"main": "./src/TypeSpec.js", <-- main file
"types": "./src/TypeSpec.d.ts", <-- type information starts here
"dependencies": {},
"devDependencies": {
"gulp": "^3.9.1",
"requirejs": "^2.3.5"
},
"optionalDependencies": {},
"engines": {
"node": "*"
}
}
あなたは今、「DIST」フォルダを持っていますあなたがパッケージ化する必要があるファイルだけでNPMに公開することなく試してみることができます。
npm pack
詳細な回答ありがとうございます - 私はまだ明確ではないことが1つあります - 私はtypescriptで1つのimport文にすべてを入れるようにします。ちょうどimport * as utils from '@module.utils'
私が開発している間、私はファイルを別々に保守するのが簡単です。 どのように達成できますか? –
Noam
TypeSpecプロジェクトを見ると、コンシューマーが必要とするものを再エクスポートします。つまり、トップレベルのモジュールファイルについて知る必要があるだけです。つまり、誰かがトップレベルのモジュールをインポートした場合、彼らはモジュールのパブリックインターフェイスにアクセスできます...そして、彼らはそのインターフェイスをサポートする多くのファイルがあるかもしれないことを知る必要はありません。 – Fenton
ありがとう - 私は助けに感謝します – Noam
これは、プロジェクトをどこに配布するかによって異なります。あなたがそれを世界中に利用したいなら、npmを使うことができます。このプロジェクトがビジネス関連のものであれば、組織外に公開するべきではないでしょう。内部使用では、多くの場合、プロジェクトツールに依存します。 –
私はnpmを使用します。しかし、私の質問は、複数のファイルをマージし、簡単なステップで1つのjsファイルと1つのd.tsファイルを作成することに重点を置いています – Noam
BTWでは、配布方法に関する問題ではなく、単一のjsバンドルを作成する方法について、インポートと名前空間の参照スタイルを使用すると、typescriptは単独でバンドルを生成できます。 es6のインポートを使用する場合は、webpackなどの外部バンドルがあります。 –