@next2d/builder 0.1.10 → 0.2.0

package/dist/xbox.js

@@ -1,12 +1,12 @@
 // Xbox (GDK ネイティブ) ビルド。V8 に Next2D の JS を載せ、Dawn(WebGPU/D3D12)で
 // 描画する C++ ホストを、テンプレートのスキャフォールド → 資材配置 → pak 埋め込み →
 // CMake/GDK ビルドの順で書き出す。
-import pc from "picocolors";
+import pc from "./colors.js";
 import fs from "fs";
 import os from "os";
 import path from "path";
 import cp from "child_process";
-import { minifySync } from "vite";
+import { loadProjectVite } from "./project-vite.js";
 import { ctx } from "./context.js";
 import { getTemplateDir } from "./utils.js";
 import { XBOX_DIR_NAME, XBOX_CONFIG_NAME, XBOX_V8_VERSION, XBOX_V8_REVISION, XBOX_SCAFFOLD_EXCLUDES } from "./constants.js";
@@ -184,9 +184,15 @@ export const renderAssetsRc = (pakAbsPath) => {
  * @method
  * @public
  */
-export const minifyJs = (name, code) => {
+export const minifyJs = async (name, code) => {
     try {
-        const result = minifySync(name, code);
+        const vite = await loadProjectVite();
+        if (typeof vite.minifySync !== "function") {
+            // Vite 7 exposes esbuild rather than the Oxc minifier used by Vite 8.
+            const result = await vite.transformWithEsbuild(code, name, { "minify": true, "legalComments": "none" });
+            return result.code;
+        }
+        const result = vite.minifySync(name, code);
         if (result.errors && result.errors.length > 0) {
             const msg = result.errors[0]?.message ?? String(result.errors[0]);
             console.log(pc.yellow(`Xbox: minify skipped for ${name} (${msg}); embedding as-is.`));
@@ -215,62 +221,59 @@ export const minifyJs = (name, code) => {
  * @method
  * @private
  */
-const embedXboxAssets = () => {
-    return new Promise((resolve, reject) => {
-        const xboxDir = `${process.cwd()}/${XBOX_DIR_NAME}`;
-        const pakPath = `${xboxDir}/assets.pak`;
-        const rcPath = `${xboxDir}/assets.rc`;
-        try {
-            // 収集: assets/app 一式 (キーは app 基準) + host スクリプト (js/ 基準)。
-            const entries = [];
-            entries.push(...walkFiles(`${xboxDir}/assets/app`, ""));
-            const bootstrap = `${xboxDir}/js/bootstrap.js`;
-            if (fs.existsSync(bootstrap)) {
-                entries.push(["js/bootstrap.js", bootstrap]);
-            }
-            const selftest = `${xboxDir}/js/selftest.js`;
-            if (fs.existsSync(selftest)) {
-                entries.push(["js/selftest.js", selftest]);
-            }
-            if (entries.length === 0) {
-                return reject("No Xbox assets found to embed (assets/app is empty).");
-            }
-            // (key, データ) を読み込み、pak バイナリへ直列化する。
-            // js/ のホストスクリプト(bootstrap.js/selftest.js)は minify + 難読化する。
-            // assets/app の JS は vite が本番ビルドで minify 済みのためそのまま。
-            let minified = 0;
-            const pakEntries = entries.map(([key, abs]) => {
-                if (key.startsWith("js/") && key.endsWith(".js")) {
-                    const src = fs.readFileSync(abs, { "encoding": "utf8" });
-                    const out = minifyJs(key, src);
-                    if (out.length < src.length) {
-                        ++minified;
-                    }
-                    return [key, Buffer.from(out, "utf8")];
+const embedXboxAssets = async () => {
+    const xboxDir = `${process.cwd()}/${XBOX_DIR_NAME}`;
+    const pakPath = `${xboxDir}/assets.pak`;
+    const rcPath = `${xboxDir}/assets.rc`;
+    try {
+        // 収集: assets/app 一式 (キーは app 基準) + host スクリプト (js/ 基準)。
+        const entries = [];
+        entries.push(...walkFiles(`${xboxDir}/assets/app`, ""));
+        const bootstrap = `${xboxDir}/js/bootstrap.js`;
+        if (fs.existsSync(bootstrap)) {
+            entries.push(["js/bootstrap.js", bootstrap]);
+        }
+        const selftest = `${xboxDir}/js/selftest.js`;
+        if (fs.existsSync(selftest)) {
+            entries.push(["js/selftest.js", selftest]);
+        }
+        if (entries.length === 0) {
+            throw new Error("No Xbox assets found to embed (assets/app is empty).");
+        }
+        // (key, データ) を読み込み、pak バイナリへ直列化する。
+        // js/ のホストスクリプト(bootstrap.js/selftest.js)は minify + 難読化する。
+        // assets/app の JS は vite が本番ビルドで minify 済みのためそのまま。
+        let minified = 0;
+        const pakEntries = await Promise.all(entries.map(async ([key, abs]) => {
+            if (key.startsWith("js/") && key.endsWith(".js")) {
+                const src = fs.readFileSync(abs, { "encoding": "utf8" });
+                const out = await minifyJs(key, src);
+                if (out.length < src.length) {
+                    ++minified;
                 }
-                return [key, fs.readFileSync(abs)];
-            });
-            const pak = buildPak(pakEntries);
-            if (minified > 0) {
-                console.log(pc.green(`Minified ${minified} host script(s) before embedding.`));
+                return [key, Buffer.from(out, "utf8")];
             }
-            fs.writeFileSync(pakPath, pak);
-            // rc.exe が assets.pak を RCDATA "N2DASSETS" として取り込む .rc を生成する。
-            fs.writeFileSync(rcPath, renderAssetsRc(path.resolve(pakPath)), "utf8");
-            console.log(pc.green(`Embedded ${entries.length} Xbox asset file(s) into assets.pak `
-                + `(${(pak.length / 1024 / 1024).toFixed(2)} MB).`));
-            // 埋め込み済みの平文 `assets/`・`js/` は書き出し一覧から除外する。
-            // これらは assets.pak (=exe 内 RCDATA) に格納済みで、CMake も埋め込みモードでは
-            // exe 隣へステージしないため、xbox/ 直下に残しても不要かつ平文流出になる。
-            fs.rmSync(`${xboxDir}/assets`, { "recursive": true, "force": true });
-            fs.rmSync(`${xboxDir}/js`, { "recursive": true, "force": true });
-            console.log(pc.green("Excluded plaintext `assets/` and `js/` from the export (embedded in exe)."));
-            resolve();
-        }
-        catch (error) {
-            reject(`Failed to embed Xbox assets. ${error}`);
+            return [key, fs.readFileSync(abs)];
+        }));
+        const pak = buildPak(pakEntries);
+        if (minified > 0) {
+            console.log(pc.green(`Minified ${minified} host script(s) before embedding.`));
         }
-    });
+        fs.writeFileSync(pakPath, pak);
+        // rc.exe が assets.pak を RCDATA "N2DASSETS" として取り込む .rc を生成する。
+        fs.writeFileSync(rcPath, renderAssetsRc(path.resolve(pakPath)), "utf8");
+        console.log(pc.green(`Embedded ${entries.length} Xbox asset file(s) into assets.pak `
+            + `(${(pak.length / 1024 / 1024).toFixed(2)} MB).`));
+        // 埋め込み済みの平文 `assets/`・`js/` は書き出し一覧から除外する。
+        // これらは assets.pak (=exe 内 RCDATA) に格納済みで、CMake も埋め込みモードでは
+        // exe 隣へステージしないため、xbox/ 直下に残しても不要かつ平文流出になる。
+        fs.rmSync(`${xboxDir}/assets`, { "recursive": true, "force": true });
+        fs.rmSync(`${xboxDir}/js`, { "recursive": true, "force": true });
+        console.log(pc.green("Excluded plaintext `assets/` and `js/` from the export (embedded in exe)."));
+    }
+    catch (error) {
+        throw new Error(`Failed to embed Xbox assets. ${error}`);
+    }
 };
 /**
  * @description Xbox ビルドに使う V8 のパスを解決する。優先順:

package/docs/capacitor.md

@@ -0,0 +1,201 @@
+# iOS / Android（Capacitor）
+
+[日本語](#日本語) | [English](#english)
+
+## 日本語
+
+### STEP1：対象OSのIDE・SDKを用意する
+
+| 対象 | ユーザーが用意するもの |
+|---|---|
+| iOS | macOS、Xcode本体とiOS SDK。Xcodeを初回起動してセットアップを完了する。 |
+| Android | Android Studio、Android SDK、使用するCapacitorに対応したJDK。 |
+| 実機・配布ビルド | 対象端末と、その配布方法に必要な署名証明書・プロビジョニング設定またはAndroidの署名鍵。 |
+
+使用するCapacitorのバージョンはbuilderの `src/tool-packages.ts` で固定している。
+対応するネイティブ環境は[Capacitorの開発フロー](https://capacitorjs.com/docs/basics/workflow)から確認する。
+Capacitorの `cli`・`core`・`ios`・`android` はbuilderが同じバージョンで取得するため、手動インストールは不要。
+
+#### iOS：Xcodeの選択を確認する
+
+```sh
+xcode-select -p
+xcodebuild -version
+```
+
+`/Library/Developer/CommandLineTools` が選択されていると、IPA生成時に `xcodebuild requires Xcode` で失敗する。
+今回のシェルだけXcodeを指定する場合は、次を設定してからSTEP3へ進む:
+
+```sh
+export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
+xcodebuild -version
+```
+
+システム全体の既定を変える場合は、代わりに次を使う:
+
+```sh
+sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
+xcodebuild -version
+```
+
+Xcodeの配置先が異なる場合はパスを変更する。builderは呼び出し元の `DEVELOPER_DIR` を引き継ぐ。
+[Appleのコマンドラインツール設定](https://developer.apple.com/documentation/xcode/configuring-command-line-tools-settings)
+
+### STEP2：アプリ設定とプラグインを用意する
+
+ゲームルートの `capacitor.config.json` にアプリ固有の値を設定する。
+
+```json
+{
+  "appId": "app.example.game",
+  "appName": "My Game",
+  "webDir": "dist/ios/prd/"
+}
+```
+
+| 項目 | 設定・管理方法 |
+|---|---|
+| `appId` / `appName` | 自分のアプリ識別子・表示名に変更する。 |
+| `webDir` | builderが今回のWeb出力先に更新するため、OSごとの手動切り替えは不要。 |
+| `ios.path` / `android.path` | 必要な場合だけネイティブプロジェクトのカスタム出力先を指定する。 |
+| ゲーム固有のCapacitor/Cordovaプラグイン | ゲームの依存として管理する。ゲーム側のフックも引き続き使用する。 |
+| `@capacitor/core` | ゲームのJavaScriptで直接importする場合だけ、builderのCapacitorと互換性のあるバージョンをゲームの直接依存に追加する。 |
+
+その他の項目は[Capacitor設定](https://capacitorjs.com/docs/config)を参照。
+
+### STEP3：ネイティブプロジェクトを開き、署名・アイコンを設定する
+
+対象OSのコマンドを実行する。
+
+```sh
+npx @next2d/builder --platform ios --env prd --open
+npx @next2d/builder --platform android --env prd --open
+```
+
+未作成の `ios/` / `android/` を生成し、Web資産とネイティブ依存を同期してIDEを開く。
+Xcode / Android Studioで、アプリのアイコン・署名・配布方法に必要な設定を行う。
+これらのネイティブプロジェクトはゲーム側で保持する。再実行時も既存の設定・ネイティブコードを維持する。
+
+### STEP4：ビルドして対象環境で確認する
+
+```sh
+npx @next2d/builder --platform ios --env prd --build
+npx @next2d/builder --platform android --env prd --build
+```
+
+実行前にWeb資産・ネイティブ依存を再同期する。対象端末やシミュレーター／エミュレーターで起動・入力・保存を確認する。
+Capacitorの `cap run` を使う場合は `--build` を `--preview` に置き換える。
+途中のコマンドが失敗した場合はbuilderも失敗する。
+
+テンプレートのnpmスクリプト `open:ios` / `open:android` / `build:ios` / `build:android` も使用できる。
+環境指定は `npm run build:ios -- --env prd` のように渡す。
+
+### 補足：既存プロジェクトの移行とSDKキャッシュ
+
+1. ゲームから不要になった `@capacitor/cli`・`@capacitor/ios`・`@capacitor/android` の直接依存を外す。
+   `@capacitor/core` とゲーム固有プラグインはSTEP2の条件に従う。
+2. 設定と `ios/` / `android/` は保持し、STEP3でネイティブ依存の参照先を再同期する。
+
+builderはゲームルートでCapacitor CLIを実行し、取得したSDKのパスを子プロセスの `NODE_PATH` に追加する。
+通常・ネストされたnpm依存配置や `file:../builder` に対応し、ゲーム側の補助スクリプトやSDKシンボリックリンクは不要。
+SDKキャッシュは書き出し後もGradle / CocoaPodsが参照するため保持する。
+npxキャッシュを削除した場合は、STEP3またはSTEP4で参照先を再同期する。
+
+## English
+
+### STEP1: Prepare the platform IDE and SDK
+
+| Target | What you need to prepare |
+|---|---|
+| iOS | macOS, the full Xcode application and the iOS SDK. Complete Xcode's first-launch setup. |
+| Android | Android Studio, the Android SDK and a JDK compatible with the Capacitor version in use. |
+| Device and distribution builds | Target devices and signing certificates/provisioning settings or an Android signing key, as required by the distribution method. |
+
+The builder pins the Capacitor version in `src/tool-packages.ts`.
+Check the corresponding native environment through the [Capacitor development workflow](https://capacitorjs.com/docs/basics/workflow).
+The builder acquires matching versions of Capacitor's `cli`, `core`, `ios` and `android`; no manual installation is needed.
+
+#### iOS: Check the selected Xcode
+
+```sh
+xcode-select -p
+xcodebuild -version
+```
+
+If `/Library/Developer/CommandLineTools` is selected, IPA generation fails with `xcodebuild requires Xcode`.
+To select Xcode for the current shell, set this before STEP3:
+
+```sh
+export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
+xcodebuild -version
+```
+
+Alternatively, to change the system-wide default:
+
+```sh
+sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
+xcodebuild -version
+```
+
+Adjust the path if Xcode is installed elsewhere. The builder inherits the caller's `DEVELOPER_DIR`.
+[Apple's command-line tools settings](https://developer.apple.com/documentation/xcode/configuring-command-line-tools-settings)
+
+### STEP2: Prepare app configuration and plugins
+
+Set game-specific values in `capacitor.config.json` at the game root.
+
+```json
+{
+  "appId": "app.example.game",
+  "appName": "My Game",
+  "webDir": "dist/ios/prd/"
+}
+```
+
+| Setting | Configuration / ownership |
+|---|---|
+| `appId` / `appName` | Replace with your app identifier and display name. |
+| `webDir` | The builder updates this to the current web output directory; no manual switching between operating systems is needed. |
+| `ios.path` / `android.path` | Set only when using custom native project locations. |
+| Game-specific Capacitor/Cordova plugins | Keep them in the game's dependencies. Game hooks continue to work. |
+| `@capacitor/core` | Add a compatible version as a direct game dependency only when the game's JavaScript imports it directly. |
+
+See [Capacitor configuration](https://capacitorjs.com/docs/config) for other settings.
+
+### STEP3: Open the native project and configure signing and icons
+
+Run the command for your target OS:
+
+```sh
+npx @next2d/builder --platform ios --env prd --open
+npx @next2d/builder --platform android --env prd --open
+```
+
+The builder creates missing `ios/` / `android/` projects, synchronizes web assets and native dependencies, then opens the IDE.
+Configure app icons, signing and distribution-specific settings in Xcode / Android Studio.
+Keep these native projects in the game. Subsequent runs preserve existing settings and native code.
+
+### STEP4: Build and verify on the target environment
+
+```sh
+npx @next2d/builder --platform ios --env prd --build
+npx @next2d/builder --platform android --env prd --build
+```
+
+Web assets and native dependencies are synchronized before building. Verify launch, input and saved data on target devices or simulators/emulators.
+Replace `--build` with `--preview` to use Capacitor's `cap run`.
+If any command fails, the builder fails as well.
+
+Template npm scripts `open:ios` / `open:android` / `build:ios` / `build:android` are also available.
+Pass the environment as in `npm run build:ios -- --env prd`.
+
+### Reference: Existing project migration and SDK cache
+
+1. Remove direct dependencies on `@capacitor/cli`, `@capacitor/ios` and `@capacitor/android` that are no longer needed by the game.
+   Follow STEP2 for `@capacitor/core` and game-specific plugins.
+2. Keep the configuration and `ios/` / `android/`, then use STEP3 to resynchronize native dependency paths.
+
+The builder runs the Capacitor CLI from the game root and adds acquired SDK paths to the child process's `NODE_PATH`.
+Regular and nested npm dependency layouts and `file:../builder` are supported; no game-side helper scripts or SDK symlinks are needed.
+Keep the SDK cache after export because Gradle / CocoaPods reference it.
+If you delete the npx cache, use STEP3 or STEP4 to resynchronize those paths.