@playcraft/build 0.0.15 → 0.0.19

package/dist/engines/generic-adapter.js

@@ -17,41 +17,50 @@ export class GenericAdapter {
      * 执行通用基础构建
      * 流程：
      * 1. 检测包管理器
-     * 2. 执行 npm install（超时 3 分钟）
-     * 3. 检测 build script
-     * 4. 执行 npm run build（超时 5 分钟）
-     * 5. 查找构建产物目录
-     * 6. 复制构建产物到 outputDir
-     * 7. 写入 .build-metadata.json
+     * 2. 检查 node_modules（存在则跳过安装）
+     * 3. 执行 npm install（超时 3 分钟）
+     * 4. 检测 build script
+     * 5. 执行 npm run build（超时 5 分钟）
+     * 6. 查找构建产物目录
+     * 7. 复制构建产物到 outputDir
+     * 8. 写入 .build-metadata.json
      */
     async baseBuild() {
         console.log(`[GenericAdapter] 开始构建引擎: ${this.engine}`);
         // 1. 检测包管理器
         const packageManager = await this.detectPackageManager();
         console.log(`[GenericAdapter] 检测到包管理器: ${packageManager}`);
-        // 2. 执行安装
-        console.log('[GenericAdapter] 执行依赖安装...');
-        await this.runNpmInstall(packageManager);
-        // 3. 检测构建命令
+        // 2. 检查 node_modules 是否存在
+        const hasNodeModules = await this.checkNodeModules();
+        if (hasNodeModules) {
+            console.log('[GenericAdapter] node_modules 已存在，跳过依赖安装');
+        }
+        else {
+            // 3. 执行安装
+            console.log('[GenericAdapter] 执行依赖安装...');
+            await this.runNpmInstall(packageManager);
+        }
+        // 4. 检测构建命令
         const buildScript = await this.detectBuildScript();
         if (!buildScript) {
             throw new Error(`[GenericAdapter] 未找到 build script\n` +
                 `请确保 package.json 中包含 scripts.build 字段。`);
         }
         console.log(`[GenericAdapter] 检测到构建命令: ${buildScript}`);
-        // 4. 执行构建
+        // 5. 执行构建
         console.log('[GenericAdapter] 执行项目构建...');
         const originalBuildDir = await this.runNpmBuild(packageManager, buildScript);
-        // 5. 复制构建产物
+        // 6. 复制构建产物
         console.log('[GenericAdapter] 复制构建产物...');
         const files = await this.copyBuildOutput(originalBuildDir);
-        // 6. 构建元数据
+        // 7. 构建元数据
         const metadata = {
             mode: 'classic', // 外部引擎统一使用 classic 模式
             engine: this.engine,
+            buildTool: 'generic',
             buildOutputDir: originalBuildDir,
         };
-        // 7. 保存元数据
+        // 8. 保存元数据
         await this.saveBuildMetadata(metadata);
         return {
             outputDir: this.options.outputDir,
@@ -80,6 +89,25 @@ export class GenericAdapter {
         // 默认使用 npm
         return 'npm';
     }
+    /**
+     * 检查 node_modules 是否存在且不为空
+     * 用于判断是否需要执行安装
+     */
+    async checkNodeModules() {
+        try {
+            const nodeModulesPath = path.join(this.projectDir, 'node_modules');
+            const stat = await fs.stat(nodeModulesPath);
+            if (!stat.isDirectory()) {
+                return false;
+            }
+            // 检查目录是否不为空
+            const entries = await fs.readdir(nodeModulesPath);
+            return entries.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
     /**
      * 执行 npm install
      * 超时：3 分钟
@@ -97,7 +125,9 @@ export class GenericAdapter {
             timeout: 3 * 60 * 1000, // 3 分钟
             env: {
                 ...process.env,
-                NODE_ENV: 'production',
+                // 注意：install 阶段不设置 NODE_ENV=production，
+                // 否则 pnpm/npm 会跳过 devDependencies 安装
+                // （playable-scripts 等构建工具通常在 devDependencies 中）
                 CI: 'true', // 避免交互式提示
             },
         });
@@ -333,6 +363,7 @@ export class GenericAdapter {
                 env: options.env,
                 stdio: 'pipe',
                 signal,
+                shell: true, // Windows 下必须，否则无法找到 pnpm/yarn 等命令
             });
             let stdout = '';
             let stderr = '';

package/dist/engines/index.d.ts

@@ -5,3 +5,4 @@
 export { EngineDetector } from './engine-detector.js';
 export { PlayCanvasAdapter } from './playcanvas-adapter.js';
 export { GenericAdapter } from './generic-adapter.js';
+export { PlayableScriptsAdapter } from './playable-scripts-adapter.js';

package/dist/engines/index.js

@@ -5,3 +5,4 @@
 export { EngineDetector } from './engine-detector.js';
 export { PlayCanvasAdapter } from './playcanvas-adapter.js';
 export { GenericAdapter } from './generic-adapter.js';
+export { PlayableScriptsAdapter } from './playable-scripts-adapter.js';

package/dist/engines/playable-scripts-adapter.d.ts

@@ -0,0 +1,148 @@
+import type { BaseBuildOptions, BaseBuildOutput, PlayableScriptsConfig } from '../types.js';
+/**
+ * PlayableScripts 构建工具适配器
+ *
+ * 职责：作为 PlayCraft 和 @playcraft/devkit 之间的中间层
+ * - @playcraft/devkit 是 PlayCraft 平台内置的构建工具（已集成到 @playcraft/cli）
+ * - 用户项目只需依赖 @playcraft/adsdk（运行时 SDK），不需要安装构建工具
+ * - 通过平台内置的 devkit 调用 playable-scripts build/builds 命令
+ * - 将 playcraft.config.json 的参数转换为 playable-scripts CLI 参数
+ * - 收集构建产物并标记 skipChannelBuild
+ *
+ * 注意：产物已是最终格式（单 HTML），无需 ViteBuilder 二次处理
+ */
+export declare class PlayableScriptsAdapter {
+    private projectDir;
+    private options;
+    private config?;
+    private static readonly DEFAULTS;
+    constructor(projectDir: string, options: BaseBuildOptions, config?: PlayableScriptsConfig);
+    /**
+     * 执行 playable-scripts 构建
+     *
+     * 流程:
+     * 1. 合并配置（playcraft.config.json → builds.config.js）
+     * 2. 构建 CLI 参数
+     * 3. 调用平台内置的 playable-scripts build/builds
+     * 4. 收集构建产物
+     * 5. 复制到输出目录
+     * 6. 写入元数据（skipChannelBuild: true）
+     *
+     * 注意：不再在用户项目中执行 npm install，
+     * devkit 是 PlayCraft 平台内置的构建工具。
+     */
+    baseBuild(): Promise<BaseBuildOutput>;
+    /**
+     * 扫描项目中的可用主题
+     * 主题目录: src/theme/ 下的子目录（排除 index.ts 等文件）
+     */
+    private scanThemes;
+    /**
+     * 将 playcraft.config.json 的参数注入到项目的 builds.config.js
+     * - storeUrls → googlePlayUrl / appStoreUrl
+     * - naming → naming
+     * - themes.enabled → 批量构建时自动禁用主题
+     * - build.outputDir → 强制与 PlayCraft 输出目录一致
+     */
+    private mergeConfig;
+    /**
+     * 将 PlayCraft 配置转换为 playable-scripts CLI 参数
+     * ★ 始终显式传递 --obfuscate-level 和 --fflate-compression
+     */
+    private buildCLIArgs;
+    private logBuildParams;
+    /**
+     * 包名迁移映射表
+     * 旧包名 -> 新包名
+     */
+    private static readonly PACKAGE_MIGRATIONS;
+    /**
+     * 自动迁移用户项目中的旧包名引用
+     * 将源码中的旧包名替换为新包名
+     */
+    private migratePackageNames;
+    /**
+     * 递归查找源码文件
+     */
+    private findSourceFiles;
+    /**
+     * 准备构建环境
+     * - 执行包名迁移
+     * - 确保项目本地 devkit 和 loader 可用
+     */
+    private prepareBuildEnvironment;
+    /**
+     * 调用 playable-scripts 命令
+     *
+     * 流程:
+     * 1. 准备构建环境（包名迁移、安装本地 devkit 和 loader）
+     * 2. 执行构建（使用项目本地 devkit）
+     *
+     * 单渠道模式: <local-devkit> build <channel> [options]
+     * 批量模式:   <local-devkit> builds [options]
+     */
+    private executePlayableScripts;
+    /**
+     * 从参数列表中移除指定参数及其值
+     */
+    private removeArg;
+    /**
+     * 查找项目本地的 playable-scripts 可执行文件
+     * 优先查找项目 node_modules 中的版本，确保 webpack 能正确解析 loader
+     */
+    private findLocalPlayableScripts;
+    /**
+     * 确保项目本地存在 playable-scripts（@playcraft/devkit）
+     * 若缺失则执行 npm install 安装 package.json 中定义的所有依赖
+     */
+    private ensureLocalDevkit;
+    /**
+     * 检查构建所需 loader 是否存在（babel-loader）
+     * 注意：babel-loader 是必须的，esbuild-loader/esbuild 是 devkit 内部可选依赖
+     */
+    private ensureBuildLoaders;
+    /**
+     * 确保 package.json 中有 build/builds 脚本
+     * devkit 必须通过 npm script 调用，不能直接执行 .js 文件
+     */
+    private ensureBuildScripts;
+    /**
+     * 扫描 playable-scripts 的输出目录，收集构建产物
+     *
+     * 单渠道输出: dist/<file>.html
+     * 批量输出: dist/<theme>/<channel>/<file>.html
+     */
+    private collectOutputs;
+    /**
+     * 递归扫描输出目录，收集 HTML/ZIP 文件
+     *
+     * devkit 的输出结构:
+     * - 批量构建: dist/<theme>/<channel>/<file>.html|zip
+     * - 单渠道:   dist/<file>.html|zip
+     *
+     * 注意：只收集目标渠道的产物，过滤掉其他渠道
+     */
+    private scanOutputDir;
+    /**
+     * 清理输出目录，删除所有旧产物
+     */
+    private cleanOutputDir;
+    /**
+     * 递归删除目录
+     */
+    private removeDirRecursive;
+    private copyToOutputDir;
+    /**
+     * 判断目标平台是否为 ZIP 格式
+     */
+    private isZipFormatPlatform;
+    /**
+     * 获取平台默认的文件名格式
+     */
+    private getPlatformFilename;
+    private saveBuildMetadata;
+    /**
+     * 执行命令并设置超时
+     */
+    private runCommandWithTimeout;
+}