@playcraft/build 0.0.11 → 0.0.14

package/dist/vite-builder.d.ts

@@ -10,37 +10,55 @@ export interface ViteBuildOutput {
  *
  * 职责：
  * 1. 验证输入是有效的基础构建
- * 2. 创建 Vite 配置
+ * 2. 根据引擎类型创建对应的 Vite 配置
  * 3. 执行 Vite 构建
  * 4. 将输出复制到最终目录
  * 5. 验证输出大小
  * 6. 生成报告
+ *
+ * 引擎路由：
+ * - PlayCanvas：使用 ViteConfigBuilder（处理 config.json、__start__.js 等）
+ * - 其他引擎：使用 GenericViteConfigBuilder（通用 HTML 内联 + 平台 SDK 注入）
  */
 export declare class ViteBuilder {
     private baseBuildDir;
     private options;
     private sizeReport;
+    private engine;
     constructor(baseBuildDir: string, options: BuildOptions);
     /**
      * 执行构建
      */
     build(): Promise<string>;
     /**
-     * 将 Vite 输出复制到最终目录
+     * 读取构建元数据
      */
-    private copyOutputToFinalDir;
+    private readBuildMetadata;
     /**
-     * 递归复制所有文件
+     * 验证基础构建
+     * 根据引擎类型使用不同的验证规则
      */
-    private copyAllFiles;
+    private validateBaseBuild;
+    /**
+     * 验证 PlayCanvas 构建
+     */
+    private validatePlayCanvasBuild;
+    /**
+     * 验证通用构建（外部引擎）
+     */
+    private validateGenericBuild;
     /**
      * 检测是否为 ESM 格式
      */
     private detectESMFormat;
     /**
-     * 验证基础构建
+     * 将 Vite 输出复制到最终目录
      */
-    private validateBaseBuild;
+    private copyOutputToFinalDir;
+    /**
+     * 递归复制所有文件
+     */
+    private copyAllFiles;
     /**
      * 获取输出路径
      */

package/dist/vite-builder.js

@@ -2,20 +2,26 @@ import { build as viteBuild } from 'vite';
 import fs from 'fs/promises';
 import path from 'path';
 import { ViteConfigBuilder } from './vite/config-builder.js';
+import { GenericViteConfigBuilder } from './vite/config-builder-generic.js';
 import { PLATFORM_CONFIGS } from './vite/platform-configs.js';
 /**
  * Vite 构建器 - 使用 Vite 构建 Playable Ads
  *
  * 职责：
  * 1. 验证输入是有效的基础构建
- * 2. 创建 Vite 配置
+ * 2. 根据引擎类型创建对应的 Vite 配置
  * 3. 执行 Vite 构建
  * 4. 将输出复制到最终目录
  * 5. 验证输出大小
  * 6. 生成报告
+ *
+ * 引擎路由：
+ * - PlayCanvas：使用 ViteConfigBuilder（处理 config.json、__start__.js 等）
+ * - 其他引擎：使用 GenericViteConfigBuilder（通用 HTML 内联 + 平台 SDK 注入）
  */
 export class ViteBuilder {
     constructor(baseBuildDir, options) {
+        this.engine = 'playcanvas';
         this.baseBuildDir = baseBuildDir;
         this.options = options;
         const platformConfig = PLATFORM_CONFIGS[options.platform];
@@ -30,26 +36,151 @@ export class ViteBuilder {
      * 执行构建
      */
     async build() {
-        // 1. 验证输入
-        await this.validateBaseBuild();
-        // 2. 创建 Vite 配置
-        const configBuilder = new ViteConfigBuilder(this.baseBuildDir, this.options.platform, this.options);
+        // 1. 读取构建元数据获取引擎类型
+        const metadata = await this.readBuildMetadata();
+        this.engine = this.options.engine ?? metadata?.engine ?? 'playcanvas';
+        console.log(`[ViteBuilder] 使用引擎: ${this.engine}`);
+        // 2. 验证输入
+        await this.validateBaseBuild(metadata);
+        // 3. 根据引擎类型创建对应的配置构建器
+        let configBuilder;
+        if (this.engine === 'playcanvas') {
+            console.log('[ViteBuilder] 使用 PlayCanvas 配置构建器');
+            configBuilder = new ViteConfigBuilder(this.baseBuildDir, this.options.platform, this.options);
+        }
+        else {
+            console.log('[ViteBuilder] 使用通用配置构建器（外部引擎）');
+            configBuilder = new GenericViteConfigBuilder(this.baseBuildDir, this.options.platform, this.options, metadata);
+        }
         const viteConfig = await configBuilder.create();
-        // 3. 执行 Vite 构建
-        await viteBuild(viteConfig);
-        // 4. 将输出从临时目录复制到最终目录
+        // 4. 执行 Vite 构建
+        try {
+            await viteBuild(viteConfig);
+        }
+        catch (error) {
+            // 打印完整的 Vite/Rollup 错误信息，便于定位构建失败原因
+            console.error('[ViteBuilder] Vite 构建失败:');
+            if (error.id) {
+                console.error(`  - 问题文件: ${error.id}`);
+            }
+            if (error.loc) {
+                console.error(`  - 位置: 行 ${error.loc.line}, 列 ${error.loc.column}`);
+            }
+            if (error.frame) {
+                console.error(`  - 代码片段:\n${error.frame}`);
+            }
+            if (error.plugin) {
+                console.error(`  - 插件: ${error.plugin}`);
+            }
+            if (error.pluginCode) {
+                console.error(`  - 插件错误码: ${error.pluginCode}`);
+            }
+            if (error.cause) {
+                console.error(`  - 原因:`, error.cause);
+            }
+            console.error(`  - 完整错误:`, error.stack || error.message || error);
+            throw error;
+        }
+        // 5. 将输出从临时目录复制到最终目录
         const viteOutputDir = configBuilder.getViteOutputDir();
         const finalOutputDir = configBuilder.getFinalOutputDir();
         if (viteOutputDir && finalOutputDir && viteOutputDir !== finalOutputDir) {
             await this.copyOutputToFinalDir(viteOutputDir, finalOutputDir);
         }
-        // 5. 验证输出大小
+        // 6. 验证输出大小
         const outputPath = this.getOutputPath();
         await this.validateSize(outputPath);
-        // 6. 生成报告
+        // 7. 生成报告
         this.generateReport(outputPath);
         return outputPath;
     }
+    /**
+     * 读取构建元数据
+     */
+    async readBuildMetadata() {
+        const metadataPath = path.join(this.baseBuildDir, '.build-metadata.json');
+        try {
+            const content = await fs.readFile(metadataPath, 'utf-8');
+            const metadata = JSON.parse(content);
+            console.log(`[ViteBuilder] 读取构建元数据: engine=${metadata.engine}, mode=${metadata.mode}`);
+            return metadata;
+        }
+        catch (error) {
+            console.warn('[ViteBuilder] 无法读取构建元数据，假设为 PlayCanvas');
+            return null;
+        }
+    }
+    /**
+     * 验证基础构建
+     * 根据引擎类型使用不同的验证规则
+     */
+    async validateBaseBuild(metadata) {
+        const engine = this.options.engine ?? metadata?.engine ?? 'playcanvas';
+        if (engine === 'playcanvas') {
+            await this.validatePlayCanvasBuild();
+        }
+        else {
+            await this.validateGenericBuild();
+        }
+    }
+    /**
+     * 验证 PlayCanvas 构建
+     */
+    async validatePlayCanvasBuild() {
+        const isESM = await this.detectESMFormat();
+        const requiredFiles = isESM
+            ? ['index.html', 'config.json']
+            : ['index.html', 'config.json', '__start__.js'];
+        const missingFiles = [];
+        for (const file of requiredFiles) {
+            try {
+                await fs.access(path.join(this.baseBuildDir, file));
+            }
+            catch {
+                missingFiles.push(file);
+            }
+        }
+        if (missingFiles.length > 0) {
+            const formatType = isESM ? 'ESM' : 'Classic';
+            throw new Error(`PlayCanvas 基础构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
+                `检测到 ${formatType} 格式，请确保输入目录包含完整的构建产物。`);
+        }
+        console.log('[ViteBuilder] PlayCanvas 构建验证通过');
+    }
+    /**
+     * 验证通用构建（外部引擎）
+     */
+    async validateGenericBuild() {
+        // 外部引擎只需要 index.html
+        try {
+            await fs.access(path.join(this.baseBuildDir, 'index.html'));
+        }
+        catch {
+            throw new Error(`外部引擎构建产物缺少 index.html\n` +
+                `构建目录: ${this.baseBuildDir}\n` +
+                `请确保 Base Build 成功生成了有效的 HTML 入口文件。`);
+        }
+        console.log('[ViteBuilder] 外部引擎构建验证通过');
+    }
+    /**
+     * 检测是否为 ESM 格式
+     */
+    async detectESMFormat() {
+        const esmIndicators = [
+            path.join(this.baseBuildDir, 'js/index.mjs'),
+            path.join(this.baseBuildDir, 'esm-scripts'),
+        ];
+        for (const indicator of esmIndicators) {
+            try {
+                await fs.access(indicator);
+                return true;
+            }
+            catch {
+                // 继续检查
+            }
+        }
+        return false;
+    }
     /**
      * 将 Vite 输出复制到最终目录
      */
@@ -116,48 +247,6 @@ export class ViteBuilder {
         }
         console.log(`[ViteBuilder] 已将输出复制到: ${destDir}`);
     }
-    /**
-     * 检测是否为 ESM 格式
-     */
-    async detectESMFormat() {
-        const esmIndicators = [
-            path.join(this.baseBuildDir, 'js/index.mjs'),
-            path.join(this.baseBuildDir, 'esm-scripts'),
-        ];
-        for (const indicator of esmIndicators) {
-            try {
-                await fs.access(indicator);
-                return true;
-            }
-            catch {
-                // 继续检查
-            }
-        }
-        return false;
-    }
-    /**
-     * 验证基础构建
-     */
-    async validateBaseBuild() {
-        const isESM = await this.detectESMFormat();
-        const requiredFiles = isESM
-            ? ['index.html', 'config.json']
-            : ['index.html', 'config.json', '__start__.js'];
-        const missingFiles = [];
-        for (const file of requiredFiles) {
-            try {
-                await fs.access(path.join(this.baseBuildDir, file));
-            }
-            catch (error) {
-                missingFiles.push(file);
-            }
-        }
-        if (missingFiles.length > 0) {
-            const formatType = isESM ? 'ESM' : 'Classic';
-            throw new Error(`基础构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
-                `检测到 ${formatType} 格式，请确保输入目录包含完整的构建产物。`);
-        }
-    }
     /**
      * 获取输出路径
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/build",
-  "version": "0.0.11",
+  "version": "0.0.14",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -39,7 +39,8 @@
     "lightningcss": "^1.31.1",
     "mime-types": "^2.1.35",
     "rollup-plugin-visualizer": "^6.0.5",
-    "sharp": "^0.33.5",
+    "sharp": "^0.34.5",
+    "javascript-obfuscator": "^5.3.0",
     "terser": "^5.46.0",
     "vite": "^6.4.1",
     "vite-plugin-singlefile": "^2.3.0"
@@ -48,6 +49,7 @@
     "@types/archiver": "^6.0.4",
     "@types/mime-types": "^2.1.4",
     "@types/node": "^22.19.8",
+    "fflate": "^0.8.2",
     "typescript": "^5.9.3"
   }
 }