ttmg-pack 0.4.5 → 0.4.7-beta.1

package/CHANGELOG.md

@@ -397,4 +397,10 @@ for  unity plugin
 
 ## 0.4.5
 
-1. 修复安卓调试模式下 dependencies 下载包失败的问题
+1. 修复安卓调试模式下 dependencies 下载包失败的问题
+
+## 0.4.6
+优化 wasmcode 分包提示问题
+
+## 0.4.7
+ wasm 不校验必接能力，避免误提示

package/dist/index.js

@@ -1,9 +1,9 @@
 /**
  * ==========================================
  *  @Description: ttmg pack
- *  @Version: 0.4.5
+ *  @Version: 0.4.7-beta.1
  *  @Author: zhanghongyang.mocha
- *  @Date: 2026-03-22 15:35:16
+ *  @Date: 2026-04-03 16:58:16
  * ==========================================
  */
 'use strict';
@@ -331,11 +331,14 @@ const messages = {
         'check.project.gameJson.subPackagesInvalid': "'subPackages' is found in game.json. Please use 'subpackages' (all lowercase) instead.",
         'check.project.gameJson.success': 'Check game.json config successfully.',
         'check.project.size.failed': 'Project size check failed: {sizeMB}MB. It must not exceed {limitMB}MB.',
+        'check.project.size.doc': 'View package size limits',
         'check.project.size.success': 'Project size check passed: {sizeMB}MB.',
         'check.project.perf.noSplitNeeded': 'wasmFuncCount < {limit}. No wasm code splitting is needed.',
         'check.project.perf.needSplit': 'The Wasm function count in wasmcode/ exceeds {limit}. Please enable code splitting to optimize performance.',
+        'check.project.perf.doc': 'View wasm split guide',
         'check.project.perf.splitEnabled': 'wasmFuncCount >= {limit}, and wasm split is enabled.',
         'check.main.size.failed': 'Main package size check failed: {sizeMB}MB. It must not exceed {limitMB}MB.',
+        'check.main.size.doc': 'View package size limits',
         'check.main.size.success': 'Main package size check passed: {sizeMB}MB.',
         'check.main.entry.missing': 'Main package entry check failed: game.js must exist in the main package.',
         'check.main.entry.success': 'Main package entry check passed: game.js exists in the main package.',
@@ -348,6 +351,7 @@ const messages = {
         'check.independent.config.success': 'Independent subpackage<{name}> config check passed.',
         'check.pkgSize.success': 'Package<{pkgName}> size check passed: {sizeMB}MB.',
         'check.pkgSize.exceeds': 'Package<{pkgName}> size check failed: {sizeMB}MB exceeds limit {limitMB}MB.',
+        'check.pkgSize.doc': 'View package size limits',
         'check.api.integrated': '{name} integrated.',
         'check.api.notIntegrated': '{name} not integrated.',
         'check.api.suggestedActionSuffix': 'Please resolve this before submission to avoid review rejection.',
@@ -404,11 +408,14 @@ const messages = {
         'check.project.gameJson.subPackagesInvalid': "在 game.json 中发现了 'subPackages' 字段，请改为全小写的 'subpackages'。",
         'check.project.gameJson.success': 'game.json 配置检查通过。',
         'check.project.size.failed': '项目大小检查失败：当前 {sizeMB}MB，不能超过 {limitMB}MB。',
+        'check.project.size.doc': '查看包大小限制说明',
         'check.project.size.success': '项目大小检查通过：当前 {sizeMB}MB。',
         'check.project.perf.noSplitNeeded': 'wasmFuncCount < {limit}，无需进行 wasm 代码拆分。',
         'check.project.perf.needSplit': 'wasmcode/ 中的 Wasm 函数数量超过 {limit}，请开启代码拆分以优化性能。',
+        'check.project.perf.doc': '查看分包文档',
         'check.project.perf.splitEnabled': 'wasmFuncCount >= {limit}，且已开启 wasm 拆分。',
         'check.main.size.failed': '主包大小检查失败：当前 {sizeMB}MB，不能超过 {limitMB}MB。',
+        'check.main.size.doc': '查看包大小限制说明',
         'check.main.size.success': '主包大小检查通过：当前 {sizeMB}MB。',
         'check.main.entry.missing': '主包入口检查失败：主包中必须存在 game.js。',
         'check.main.entry.success': '主包入口检查通过：主包中存在 game.js。',
@@ -421,6 +428,7 @@ const messages = {
         'check.independent.config.success': '独立分包<{name}> 配置检查通过。',
         'check.pkgSize.success': '包<{pkgName}> 大小检查通过：{sizeMB}MB。',
         'check.pkgSize.exceeds': '包<{pkgName}> 大小检查失败：当前 {sizeMB}MB，超过限制 {limitMB}MB。',
+        'check.pkgSize.doc': '查看包大小限制说明',
         'check.api.integrated': '{name} 已接入。',
         'check.api.notIntegrated': '{name} 未接入。',
         'check.api.suggestedActionSuffix': '请在提审之前完成问题处理，避免审核阶段被拒审。',
@@ -1133,6 +1141,7 @@ function checkGameJson(config, t) {
  * @returns
  */
 function checkProjectSize(config, t) {
+    const pkgSizeDocLink = 'https://bytedance.larkoffice.com/wiki/LkihwQCMfiBpr3khwNuceCBkn3e';
     logger.info(t('log.check.projectSize.start'));
     const { entry: entryDir, dev } = config;
     const { pkgSizeLimit } = getCheckConfig(config);
@@ -1144,7 +1153,10 @@ function checkProjectSize(config, t) {
         const errMsg = t('check.project.size.failed', { sizeMB: gameSizeMB, limitMB });
         logger.error(errMsg);
         if (enableDev) {
-            return Object.assign({ passed: false, name: 'project', msg: errMsg, type: 'size', level: 'warning', size: gameSize }, defaultCheckConfig$3);
+            return Object.assign({ passed: false, name: 'project', msg: errMsg, type: 'size', level: 'warning', detail: {
+                    link: pkgSizeDocLink,
+                    text: t('check.project.size.doc'),
+                }, size: gameSize }, defaultCheckConfig$3);
         }
         else {
             throw new Error(errMsg);
@@ -1160,6 +1172,7 @@ function checkProjectSize(config, t) {
     }
 }
 function checkPerformance(config, t) {
+    const wasmSplitDocLink = 'https://bytedance.larkoffice.com/wiki/DZDzwzYdDiJpBSkrhcTcWailnuh?from=from_parent_docx';
     const { entry } = config;
     if (!isUnityEngine(entry)) {
         return null;
@@ -1177,7 +1190,10 @@ function checkPerformance(config, t) {
     const splitConfigPath = path.join(entry, GAME_WASM_SPLIT_CONFIG_FILE_NAME);
     const errResult = Object.assign(Object.assign({}, defaultCheckConfig$3), { passed: false, msg: t('check.project.perf.needSplit', {
             limit: WASM_FUNC_COUNT_LIMIT,
-        }), type: 'performance', level: 'warning', name: 'project' });
+        }), type: 'performance', level: 'warning', detail: {
+            link: wasmSplitDocLink,
+            text: t('check.project.perf.doc'),
+        }, name: 'project' });
     if (!fs.existsSync(splitConfigPath)) {
         return errResult;
     }
@@ -1203,6 +1219,7 @@ const defaultCheckConfig$2 = {
  * @returns
  */
 function checkMainPackageSize(config, t) {
+    const pkgSizeDocLink = 'https://bytedance.larkoffice.com/wiki/LkihwQCMfiBpr3khwNuceCBkn3e';
     logger.info(t('log.check.mainPackageSize.start'));
     const { entry: entryDir, dev } = config;
     const { mainPkgSizeLimit } = getCheckConfig(config);
@@ -1216,7 +1233,10 @@ function checkMainPackageSize(config, t) {
         });
         logger.error(errMsg);
         if (dev === null || dev === void 0 ? void 0 : dev.enable) {
-            return Object.assign({ passed: false, msg: errMsg, size: mainPkgSize, type: 'size', level: 'warning' }, defaultCheckConfig$2);
+            return Object.assign({ passed: false, msg: errMsg, size: mainPkgSize, type: 'size', level: 'warning', detail: {
+                    link: pkgSizeDocLink,
+                    text: t('check.main.size.doc'),
+                } }, defaultCheckConfig$2);
         }
         else {
             throw new Error(errMsg);
@@ -1442,6 +1462,7 @@ function checkIndependentPackages(config, t) {
     return checkResults;
 }
 function checkPkgSize({ entryDir, limit, pkgName, dimension, level, t, }) {
+    const pkgSizeDocLink = 'https://bytedance.larkoffice.com/wiki/LkihwQCMfiBpr3khwNuceCBkn3e';
     const size = getDirSizeSync({
         rootDir: entryDir,
         entryDir,
@@ -1449,9 +1470,7 @@ function checkPkgSize({ entryDir, limit, pkgName, dimension, level, t, }) {
     const passed = size <= limit;
     const sizeMB = size / 1024 / 1024;
     const limitMB = limit / 1024 / 1024;
-    return {
-        passed,
-        msg: passed
+    return Object.assign(Object.assign({ passed, msg: passed
             ? t('check.pkgSize.success', {
                 pkgName,
                 sizeMB: sizeMB.toFixed(2),
@@ -1460,14 +1479,15 @@ function checkPkgSize({ entryDir, limit, pkgName, dimension, level, t, }) {
                 pkgName,
                 sizeMB: sizeMB.toFixed(2),
                 limitMB: limitMB.toFixed(2),
-            }),
-        type: 'size',
-        level,
-        size,
-        dimension,
-        required: true,
-        name: pkgName,
-    };
+            }), type: 'size', level }, (passed
+        ? {}
+        : {
+            detail: {
+                link: pkgSizeDocLink,
+                text: t('check.pkgSize.doc'),
+            },
+        })), { size,
+        dimension, required: true, name: pkgName });
 }
 
 /**
@@ -1504,6 +1524,11 @@ function checkAPI(config, t) {
     if (!((_a = config === null || config === void 0 ? void 0 : config.build) === null || _a === void 0 ? void 0 : _a.enableAPICheck)) {
         return [];
     }
+    // Unity 游戏产物通常无法通过源码/产物扫描稳定识别必接 API（多为 wasm/unityweb），
+    // 为避免误报，这里直接跳过必接能力扫描与结果透出。
+    if (isUnityEngine(config.entry)) {
+        return [];
+    }
     const exts = ['.js', '.ts'];
     // 预编译正则，尽量减少误报：匹配独立的标识符或对象调用形式
     // 例如：\b(login)\b 或 \.login\s*\( 或 =\s*login\b
@@ -2420,7 +2445,7 @@ async function buildPkgs(config, context = {}) {
     let startTime = Date.now();
     logger.init(outputDir, true);
     logger.info(t('log.build.version', {
-        version: "0.4.5",
+        version: "0.4.7-beta.1",
     }));
     logger.info(t('log.build.start', { startTime }));
     /**