ビルドとデプロイ

Modoki は、1 つのコードベースから 3 つの出力先へ届けられます。エディタで作り込んだゲームロジック、ECS、レンダリングは、（Capacitor を介した）デバイスシェル上でもブラウザ上でも、そのまま変更なしに動作します。ネイティブ移植版を別々に保守する必要はありません。Build メニューからターゲットを選ぶだけで、エディタが適切なパイプラインを実行し、その進捗をモーダルにストリーミング表示してくれます。

ビルドターゲット: iOS Device、Android Device、Web（modoki-engine.com のサブパスへデプロイ）、Playable Ad。加えて、ネイティブプロジェクトをスキャフォールドする「Add iOS/Android Target」もあります。

Build メニュー

エディタのメニューバーから Build を開きます。開いているプロジェクト名を冠した、次の項目が表示されます。

• iOS Device — <appName> — 接続された iPhone にビルドしてインストールします。
• Android Device — <appName> — 接続された Android デバイスにビルドしてインストールします。
• Web → modoki-engine.com/<base> — Web にデプロイするゲーム専用ビルドです。
• Playable Ad — <appName> — 広告ネットワーク向けに、ゲームを 1 つの自己完結型 MRAID HTML にまとめます。
• Add iOS Target… / Add Android Target… — まだネイティブプロジェクトを持たないゲームのために、ネイティブの Capacitor プロジェクトをスキャフォールドします。
• Build Support… — ビルドツールチェーン（Node、JDK 21、Android SDK）をインストール・管理するダイアログを開きます。

いずれのターゲットを選んでも、そのビルドパイプラインが実行され、出力が進捗モーダルにストリーミングされます。各ステップを見守りながら、失敗を捉えることができます。

ビルドの前にテストを

まずは GameView で Play を押し、ゲームを実際に操作してみましょう。GameView は 3 つのレンダリングレイヤーすべてをデバイスプリセット付きで実行するので、ロジックやレイアウトの問題を数秒で発見できます。デバイスへのフルインストールを待つよりもはるかに高速です。

Web ビルド

Web ターゲットはゲーム専用ビルドを生成します。エディタは取り除かれ、エンジンとあなたのゲームだけが残ります。ビルドは Google Cloud Storage バケットのサブパスにアップロードされ、CDN が無効化されるため、modoki-engine.com/<base>（Project Settings で設定したベースパス）でゲームが公開されます。これは、公開されている Modoki デモを支えているのとまったく同じビルドです。

ネイティブビルド

各ゲームは、それぞれ独自の Capacitor iOS / Android プロジェクトと独自のバンドル ID を持ちます。モバイルシェルは Web ビルドとまったく同じエンジンおよびゲームコードを実行し、違いはその周りを包むネイティブコンテナだけです。

デバイスビルドには 2 つの前提条件があります。

• iOS には Xcode の署名が必要です。プロジェクトに Apple Team ID を設定してください。
• Android にはマシンに JDK 21 が必要です。

ゲームにまだネイティブプロジェクトがない場合は、先に Add iOS Target… または Add Android Target… でスキャフォールドしてから、対応するデバイスビルドを実行してください。

Project settings

ビルドパラメータは Project Settings ダイアログにあり、プロジェクトごとに設定します。デバイス ID、Apple Team ID、そして Web ターゲットのデプロイ先となる Web バケット / CDN などです。一度設定すれば、Build メニューの各ターゲットがそれを参照します。

ウォークスルー: Web ビルドを公開する

1. Project Settings を開き、Web ターゲットがデプロイ先を把握できるよう、プロジェクトの Web バケット / CDN を入力します。
2. GameView で Play し、ゲームが期待どおりに動作することを確認します。
3. Build → Web → modoki-engine.com/<base> でゲーム専用パイプラインを開始し、各ステップが流れる進捗モーダルを見守ります。
4. バケットへのアップロードと CDN の無効化というデプロイの完了を待ちます。
5. modoki-engine.com/<base> を開いて、公開されたゲームを確認します。

ウォークスルー: デバイスにビルドする

1. 必要であれば、Add iOS Target… または Add Android Target… からネイティブプロジェクトをスキャフォールドします。
2. 前提条件を設定します。iOS なら Apple Team ID、Android なら JDK 21 を用意し、Project Settings にデバイス ID を入力します。
3. 時間のかかるデバイスへの往復に進む前に、GameView（Play）でテストします。
4. Build → iOS Device または Android Device を実行し、接続したデバイスへのビルドとインストールが進む進捗モーダルに従います。

iOS には署名が必須

iOS デバイスビルドは、ゲームのバンドル ID に対して Xcode の署名が設定されていないと完了しません。実行する前に、Project Settings で Apple Team ID を設定してください。