ttmg-pack 0.4.8 → 0.4.9

package/CHANGELOG.md

@@ -405,4 +405,7 @@ for  unity plugin
 ## 0.4.7
  wasm 不校验必接能力，避免误提示
 ## 0.4.8
- packConfig 扩展 __engine_meta__ 字段，用于后续 C 端数据分析使用
+ packConfig 扩展 __engine_meta__ 字段，用于后续 C 端数据分析使用
+
+## 0.4.9
+支持子包收集优化需求

package/__TEST__/tests/fixtures/game-preload/game.json

@@ -0,0 +1,20 @@
+{
+  "gameEngine": "unity",
+  "parallelPreloadSubpackages": [
+    { "subPkgName": "sub1", "is_startup": true, "size": "100KB" }
+  ],
+  "subpackages": [
+    {
+      "name": "sub1",
+      "root": "subpackages/sub1"
+    },
+    {
+      "name": "sub2",
+      "root": "subpackages/sub2",
+      "independent": true,
+      "parallelPreloadSubpackages": [
+        { "subPkgName": "sub1", "is_startup": false, "size": "100KB" }
+      ]
+    }
+  ]
+}

package/dist/index.js

@@ -1,9 +1,9 @@
 /**
  * ==========================================
  *  @Description: ttmg pack
- *  @Version: 0.4.8
+ *  @Version: 0.4.9
  *  @Author: zhanghongyang.mocha
- *  @Date: 2026-04-09 16:30:51
+ *  @Date: 2026-06-04 17:34:30
  * ==========================================
  */
 'use strict';
@@ -1753,6 +1753,9 @@ async function checkPkgs(config, context = {}) {
     ];
 }
 
+function isNonEmptyArray(value) {
+    return Array.isArray(value) && value.length > 0;
+}
 async function setup(config) {
     const t = getPackTranslator();
     const { entry: entryDir, output: outputDir } = config;
@@ -1786,7 +1789,13 @@ async function setup(config) {
         type: 'game',
         dependencies: []
     };
-    transformSubPackages(gameJson.subpackages).forEach(({ name, root, main, independent }) => {
+    // 启动并行预下载配置同构透传：源码主包写在 game.json 顶层，
+    // 编译产物挂到主包 __GAME__ 条目，保证运行时消费的编译产物与线下采集一致。
+    if (isNonEmptyArray(gameJson.parallelPreloadSubpackages)) {
+        packages[GAME_MAIN_PACKAGE_NAME].parallelPreloadSubpackages =
+            gameJson.parallelPreloadSubpackages;
+    }
+    transformSubPackages(gameJson.subpackages).forEach(({ name, root, main, independent, parallelPreloadSubpackages }) => {
         // root 是目录
         packages[name] = {
             url: '',
@@ -1798,6 +1807,16 @@ async function setup(config) {
             type: 'game',
             dependencies: []
         };
+        // 启动并行预下载配置 normalize：仅合法启动 root 允许携带该字段。
+        // 独立分包是合法启动入口 -> 同构挂到对应 packages[name] 条目；
+        // 普通分包不是启动 root，源码侧禁止配置，编译期直接拒绝
+        // （防止 DevTool CLI 写入前校验被绕过的非法 game.json 流入产物）。
+        if (isNonEmptyArray(parallelPreloadSubpackages)) {
+            if (!independent) {
+                throw new Error(`普通分包 ${name} 不是合法启动 root，不允许配置 parallelPreloadSubpackages`);
+            }
+            packages[name].parallelPreloadSubpackages = parallelPreloadSubpackages;
+        }
         if (independent) {
             fyfPackages.push({
                 value: name,
@@ -1849,7 +1868,13 @@ function transformSubPackages(configs) {
         let main = getMainFromRoot(config.root);
         // test
         let root = normalizeRoot(config.root);
-        return { main, root, name, independent: config.independent || false };
+        return {
+            main,
+            root,
+            name,
+            independent: config.independent || false,
+            parallelPreloadSubpackages: config.parallelPreloadSubpackages,
+        };
     });
 }
 
@@ -2563,7 +2588,7 @@ async function buildPkgs(config, context = {}) {
     let startTime = Date.now();
     logger.init(outputDir, true);
     logger.info(t('log.build.version', {
-        version: "0.4.8",
+        version: "0.4.9",
     }));
     logger.info(t('log.build.start', { startTime }));
     /**