共通の依存関係を持つTypeScriptプロジェクトを構成して、複数のプレーンJavaScript出力ファイルをビルドします

現在、ボットランド用のスクリプトをいくつか書いています。Bot Landは、マウスとキーボードでユニットを制御する代わりに、APIを介してボットを制御するコードを記述し、ボットが他のボットと戦うリアルタイム戦略ゲームです。SC2のユニットに精通している場合は、まばたきストーカー、攻城戦車、メディック、ウルトラリスクに似たボットを作成できます。（これはソフトウェアエンジニアにとって非常に楽しいゲームですが、それはこの質問の範囲外です。）

ボット制御には、3つのレベルの複雑さの増加があります。デフォルトのAI、スクラッチのようなプログラミング言語、およびBotLandScriptと呼ばれるJavaScriptの削減されたセットです。BotLandScriptの組み込みエディターは妥当ですが、すべてのコードを、グローバルなトップレベル関数がどこにでもある単一のファイルとしてアップロードする必要があります。当然、コードが長くなり始め、異なるボットが同じ機能を共有する場合、これはしばらくすると痛みを伴い始めます。

複数のボット用のコードの記述を容易にし、裸のJSでコーディングするときの意図しないエラーの可能性を減らし、他のプレーヤーを倒す可能性を高めるために、上記のTypeScriptプロジェクトをセットアップして、ボットごとに共通のライブラリとコードを提供しました。現在のディレクトリ構造は、次のようになります。

lib/ 
  bot.land.d.ts
  common.ts
BlinkStalker/
  BlinkStalker.ts
  tsconfig.json
Artillery/
  Artillery.ts
  tsconfig.json
SmartMelee/
  SmartMelee.ts
  tsconfig.json

libボット間で共有される共通コードであり、（TS以外の）ボットランドAPIのTypeScript定義を提供します。次に、各ボットは独自のフォルダーを取得し、1つのファイルにはボットコードが含まれ、もう1つのファイルにはボイラープレートが含まれtsconfig.jsonます。

{
  "compilerOptions": {
    "target": "es3",
    "module": "none",
    "sourceMap": false,
    "outFile": "bot.js"
  },
  "files": [
    "MissileKite.ts"
  ],
  "include": [
    "../lib/**/*"
  ]
}

各々が場合tsconfig.json内蔵され、対応する作成bot.jsボット自体ならびにからそれがtranspiled含むコードのすべてのコードでのcommon.jsます。このセットアップは、いくつかの理由で最適ではありません。特に、ボイラープレートの複製が大量に必要であり、新しいボットを追加するのが難しくなり、ボットごとに不要なコードが多く含まれ、各ボットを個別にビルドする必要があります。

ただし、これまでの私の調査では、私がやりたいことを簡単に行う方法はないようです。特に、新しいtsc -bオプションと参照の使用は機能しません。コードをモジュール化する必要があり、Bot Landはすべての関数がトップレベルで定義された単一のファイルを必要とするためです。

次のことをできるだけ多く達成するための最良の方法は何ですか？

• 新しいボットを追加するために新しいボイラープレートは必要ありません（たとえば、tsconfig.jsonボットごとに不要）
• 使用import、未使用のコードを出力しないようにする一般的な機能のために、しかし、その後...
• すべての機能をボットランドの特定の形式で1つのファイルとして出力します
• ボットごとに1つ、複数の出力ファイルを生成する単一のビルドステップ
• おまけ：ビルドプロセスとVSコードの統合。現在、tasks.json各サブプロジェクトを構築するための対応する定型があります。

答えはおそらくに加えてGruntのようなものを含んでいるのではないかと漠然と推測しますtscが、確かにそれについて十分に知りません。

ここにあなたの要求に答える私の試みがあります。

注目すべきファイル：

• src/tsconfig-botland.jsonbot.landスクリプト（私がに移動したカスタム宣言を含む）の設定を保持しますtypes/bot-land/index.d.ts。strict私が使用した設定を変更する場合があります。
• src/tsconfig.jsonすべてのボットへの参照を保持します。これは、別のボットスクリプトを追加するときに編集するファイルです

ボットスクリプトは少なくとも2つのファイルです：ミニマリストtsconfig.jsonと1つ以上.tsスクリプトファイルです。

例src/AggroMiner/tsconfig.json：

{
    "extends": "../tsconfig-botland",
    "compilerOptions": {
        "outFile": "../../build/AggroMiner.js"
    },
    "files": ["index.ts"],
    "include": ["**/*.ts", "../lib/**/*.ts"]
}

ほとんどの場合、新しいボットスクリプトを開始するには、次のことを行う必要があります。

1. ボットフォルダー（つまりsrc/AggroMiner）を下の新しいフォルダーにコピーするsrc
2. ボットの名前でsrc/<newBotFolder>/tsconfig.jsonを編集するには、を編集しoutFileます
3. src/tsconfig.jsonへの参照を編集して追加するsrc/<newBotFolder>

次のnpm/ yarnスクリプトが設定されています。

• build すべてのボットを構築する
• build-cleanbuild実行する前にフォルダをクリアしますbuild
• format.ts下のすべてのファイルでPrettierを実行するにはsrc
• lint すべてのボットスクリプトでtslintチェックを実行する

次に、要件を実行します。

• 新しいボットを追加するために新しいボイラープレートは必要ありません（たとえば、ボットごとにtsconfig.jsonはありません）

これを実現するには、ボットフォルダー/スクリプトを列挙するスクリプトを作成し、ボットごとに関連するものを設定してtsconfig.json実行する必要がありますtsc。厳密に必要でない限り、最小限の設定（上記を参照）で十分な場合があります。

• 未使用のコードの出力を回避するために一般的な関数のインポートを使用しますが、その後...

まず、モジュールexport/ importステートメントの使用を開始する場合は、単一のファイル出力を実現するために、/ treehakeをパックする追加のサードパーティが必要になることに注意してください。私がBot.landについて収集できたことから、スクリプトはサーバーで実行されています。デッドコードがボットのパフォーマンスに影響を与えない限り、私は本当に気にしません。

• すべての機能をボットランドの特定の形式で1つのファイルとして出力します

できました。

• ボットごとに1つ、複数の出力ファイルを生成する単一のビルドステップ

できました。

• おまけ：ビルドプロセスとVSコードの統合。現在、各サブプロジェクトをビルドするための対応するボイラープレートtasks.jsonがあります。

npmスクリプトは、このようにすること（少なくとも、彼らは鉱山で行う）VSCのタスクリストに表示されますtasks.json不要に。

実際にプロジェクト参照を使用できます。次の手順に従って、すべての関数を1つのファイルの最上位に配置して、元のファイルと同じ結果を得ます。しかし、ボットに必要な関数のみをインポートするソリューションは見つかりませんでした。つまり、インポートとエクスポートを使用しません。

ルートのtsconfig.json

{
    "files": [],
    "references": [
        { "path": "./lib" }
        { "path": "./AggroMiner" }
        { "path": "./ArtilleryMicro" }
        { "path": "./MissileKite" }
        { "path": "./SmartMelee" }
        { "path": "./ZapKite" }
    ]
}

次に、libフォルダーに次のようにtsconfig.jsonを追加します

{
  "compilerOptions": {
    "declaration": true,
    "declarationMap": true,
    "composite": true,
    "rootDir": ".",
    "outFile": "../build/lib.js",
    "target": "es3",
    "removeComments": true,
    "sourceMap": false,
  },
  "files": [
    "data.ts",
    "movement.ts",
    "utils.ts"
  ]
}

tsがコンパイルエラーに悩まされないように、data.ts、movement.ts、およびutils.tsにいくつかの調整を加える必要があります。

data.ts

/// <reference path="./bot.land.d.ts"/>

(...)

Movement.ts

/// <reference path="./data.ts"/>
/// <reference path="./utils.ts"/>
(...)

utils.ts

/// <reference path="./bot.land.d.ts"/>
(...)

次に、ルートにbase.jsonを追加します（ボットのtsconfig.jsonがそれを拡張します）。

base.json

{
  "compilerOptions": {
    "declaration": true,
    "composite": true,
    "rootDir": ".",
    "target": "es3",
    "removeComments": true,
    "sourceMap": false,
  }
}

およびボットのtsconfig.json（ボットに従って適応）

{
  "extends": "../base",
  "compilerOptions": {
    "outFile": "../build/AggroMiner.js",
  },
  "files": [
    "AggroMiner.ts"
  ],
  "references": [
      { "path": "../lib", "prepend": true } //note the prepend: true
  ]
}

それでおしまい。今すぐ実行

tsc -b