@playcraft/build 0.0.13 → 0.0.14

package/dist/generators/config-generator.js

@@ -11,9 +11,16 @@ function shouldIncludeAsset(asset, scriptIds, requiredScriptIds) {
         return false;
     }
     // 字体源文件（ttf/otf）不进入构建产物
+    // 但如果 type === 'font' 且包含运行时数据（data.chars 或 data.info），
+    // 说明这是 PlayCanvas 处理后的 MSDF/Bitmap 字体资源，必须保留
     const filename = asset.file?.filename?.toLowerCase?.();
     if (filename && (filename.endsWith('.ttf') || filename.endsWith('.otf'))) {
-        return false;
+        if (asset.type === 'font' && (asset.data?.chars || asset.data?.info)) {
+            // 这是已处理的字体数据资源（包含 MSDF chars 映射），保留
+        }
+        else {
+            return false;
+        }
     }
     // 仅保留在 settings.scripts 中声明的脚本资产
     if (asset.type === 'script' && asset.id != null) {
@@ -22,6 +29,53 @@ function shouldIncludeAsset(asset, scriptIds, requiredScriptIds) {
     }
     return true;
 }
+/**
+ * 修复不完整的字体资源
+ * 在 PlayCanvas/PlayCraft 项目中，可能存在两个同名的 font asset：
+ * - 一个包含完整的 data（chars、info 等 MSDF 数据）
+ * - 一个是空壳（被场景引用，但没有 data 和 file）
+ * 此函数将有数据的 font asset 的 data 复制到空壳 font asset 中，
+ * 并清除指向 .ttf/.otf 原始文件的 file 引用（运行时不需要加载这些文件，
+ * 因为 MSDF 字符数据已经在 data.chars 中了）
+ */
+function fixIncompleteFontAssets(assets, allAssets) {
+    // 收集有完整 data 的 font assets（按名称索引）
+    const fontDataByName = {};
+    for (const [, asset] of Object.entries(allAssets)) {
+        const a = asset;
+        if (a.type === 'font' && a.data?.chars && a.name) {
+            fontDataByName[a.name] = a;
+        }
+    }
+    // 修复没有 data 的 font assets
+    let fixedCount = 0;
+    for (const [, asset] of Object.entries(assets)) {
+        const a = asset;
+        if (a.type !== 'font') {
+            continue;
+        }
+        // 如果 font asset 没有 chars 数据，尝试从同名的有数据的 font asset 中获取
+        if (!a.data?.chars) {
+            const donor = fontDataByName[a.name];
+            if (donor) {
+                a.data = donor.data;
+                fixedCount++;
+            }
+        }
+        // 清除指向 .ttf/.otf 原始文件的 file 引用
+        // PlayCanvas 运行时会尝试 fetch file.url，但 .ttf 不是 font data JSON
+        // 实际的 MSDF chars 数据已经在 data.chars 中，不需要额外加载
+        const fileUrl = a.file?.url?.toLowerCase?.() || '';
+        const fileName = a.file?.filename?.toLowerCase?.() || '';
+        if (fileUrl.endsWith('.ttf') || fileUrl.endsWith('.otf') ||
+            fileName.endsWith('.ttf') || fileName.endsWith('.otf')) {
+            delete a.file;
+        }
+    }
+    if (fixedCount > 0) {
+        console.log(`[ConfigGenerator] 修复了 ${fixedCount} 个不完整的字体资源`);
+    }
+}
 function collectRequiredScriptIds(assets) {
     const required = new Set();
     for (const asset of Object.values(assets)) {
@@ -280,6 +334,8 @@ export async function generateConfig(projectConfig, options) {
                 filtered[assetId] = shouldStrip ? stripAssetMetadata(asset) : asset;
             }
             config.assets = filtered;
+            // 修复不完整的字体资源（从同名的有数据的 font asset 中补充 data）
+            fixIncompleteFontAssets(config.assets, pcProject.assets);
             // 输出精简统计
             if (shouldStrip && Object.keys(pcProject.assets).length > 0) {
                 const originalSize = JSON.stringify(pcProject.assets).length;
@@ -370,6 +426,8 @@ export async function generateConfig(projectConfig, options) {
                 filtered[assetId] = shouldStrip ? stripAssetMetadata(asset) : asset;
             }
             config.assets = filtered;
+            // 修复不完整的字体资源（从同名的有数据的 font asset 中补充 data）
+            fixIncompleteFontAssets(config.assets, pcProject.assets);
             // 输出精简统计
             if (shouldStrip && Object.keys(pcProject.assets).length > 0) {
                 const originalSize = JSON.stringify(pcProject.assets).length;

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export type { ViteBuildOutput } from './vite-builder.js';
 export { PlayableBuilder } from './playable-builder.js';
 export type { PlayableBuildOutput } from './playable-builder.js';
 export { OnePageConverter } from './converter.js';
+export { EngineDetector, PlayCanvasAdapter, GenericAdapter } from './engines/index.js';
 export { BuildStateManager, BUILD_STATE_VERSION } from './state/index.js';
 export type { AssetType, ProcessingStage, OptimizationType, AssetProcessingInfo, AssetState, BuildStageInfo, BuildState, } from './state/index.js';
 export { StateToReportConverter } from './state/index.js';
@@ -13,6 +14,9 @@ export { BuildAnalyzer } from './analyzers/build-analyzer.js';
 export type { BuildAnalysisReport, FileAnalysis } from './analyzers/build-analyzer.js';
 export { PlayableAnalyzer } from './analyzers/playable-analyzer.js';
 export type { PlayableAnalysisReport, PlayableAssetAnalysis } from './analyzers/playable-analyzer.js';
+export { analyzeSceneDependencies, collectScenesAssets, printSceneDependencies } from './analyzers/scene-asset-collector.js';
+export type { SceneDependencies } from './analyzers/scene-asset-collector.js';
+export { detectAmmoUsage } from './utils/ammo-detector.js';
 export { createPlatformAdapter, PlatformAdapter } from './platforms/index.js';
 export { FacebookAdapter } from './platforms/facebook.js';
 export { SnapchatAdapter } from './platforms/snapchat.js';

package/dist/index.js

@@ -3,12 +3,16 @@ export { BaseBuilder } from './base-builder.js';
 export { ViteBuilder } from './vite-builder.js';
 export { PlayableBuilder } from './playable-builder.js';
 export { OnePageConverter } from './converter.js';
+// 导出引擎检测器和适配器
+export { EngineDetector, PlayCanvasAdapter, GenericAdapter } from './engines/index.js';
 // 导出状态管理器
 export { BuildStateManager, BUILD_STATE_VERSION } from './state/index.js';
 export { StateToReportConverter } from './state/index.js';
 // 导出分析器
 export { BuildAnalyzer } from './analyzers/build-analyzer.js';
 export { PlayableAnalyzer } from './analyzers/playable-analyzer.js';
+export { analyzeSceneDependencies, collectScenesAssets, printSceneDependencies } from './analyzers/scene-asset-collector.js';
+export { detectAmmoUsage } from './utils/ammo-detector.js';
 // 导出平台适配器
 export { createPlatformAdapter, PlatformAdapter } from './platforms/index.js';
 export { FacebookAdapter } from './platforms/facebook.js';

package/dist/loaders/playcraft-loader.js

@@ -1,5 +1,178 @@
 import fs from 'fs/promises';
 import path from 'path';
+/**
+ * 将 PlayCraft git 仓库中的 API URL 转换为本地文件路径
+ * API URL 格式: /api/projects/{id}/files/assets/textures/ball.png?branchId=master
+ * 本地路径格式: assets/textures/ball.png
+ *
+ * 也处理 PlayCraft 的 treePath 格式:
+ * path 字段: assets/assets/{folderId}/filename
+ * 本地路径: assets/{folderName}/filename
+ */
+function resolvePlayCraftAssetUrl(asset, projectDir) {
+    const fileUrl = asset.file?.url;
+    if (!fileUrl || typeof fileUrl !== 'string')
+        return null;
+    // 如果已经是相对路径且不是 API URL，直接返回
+    if (!fileUrl.startsWith('/api/') && !fileUrl.startsWith('http')) {
+        return fileUrl;
+    }
+    // 解析 API URL: /api/projects/{id}/files/{path}?branchId=...
+    const match = fileUrl.match(/\/api\/projects\/\d+\/files\/(.+?)(?:\?|$)/);
+    if (match) {
+        const relativePath = decodeURIComponent(match[1]);
+        return relativePath;
+    }
+    return null;
+}
+/**
+ * 修正 PlayCraft 项目中所有资源的 file.url
+ * 将 API URL 转换为本地相对路径，并验证文件是否存在
+ */
+async function resolvePlayCraftUrls(assets, projectDir) {
+    let resolvedCount = 0;
+    let notFoundCount = 0;
+    for (const [assetId, asset] of Object.entries(assets)) {
+        const assetData = asset;
+        if (!assetData.file?.url)
+            continue;
+        const originalUrl = assetData.file.url;
+        const localPath = resolvePlayCraftAssetUrl(assetData, projectDir);
+        if (!localPath)
+            continue;
+        // 如果 URL 已经更改为本地路径
+        if (localPath !== originalUrl) {
+            // 验证文件是否存在
+            const absPath = path.join(projectDir, localPath);
+            try {
+                await fs.access(absPath);
+                assetData.file.url = localPath;
+                resolvedCount++;
+            }
+            catch {
+                // 文件不存在，尝试使用 asset 的 path 字段中的 treePath 信息
+                // PlayCraft 的 path 字段可能是 "assets/assets/{folderId}/{filename}"
+                if (assetData.path) {
+                    const pathUrl = assetData.path;
+                    const pathAbs = path.join(projectDir, pathUrl);
+                    try {
+                        await fs.access(pathAbs);
+                        assetData.file.url = pathUrl;
+                        resolvedCount++;
+                    }
+                    catch {
+                        notFoundCount++;
+                    }
+                }
+                else {
+                    notFoundCount++;
+                }
+            }
+        }
+    }
+    if (resolvedCount > 0 || notFoundCount > 0) {
+        console.log(`[PlayCraftLoader] 解析资源 URL: ${resolvedCount} 个成功${notFoundCount > 0 ? `, ${notFoundCount} 个未找到` : ''}`);
+    }
+}
+/**
+ * PlayCanvas 场景 settings 的默认值
+ * 当场景文件中缺少这些设置时，使用这些默认值以确保正常渲染
+ */
+const DEFAULT_SCENE_SETTINGS = {
+    render: {
+        skybox: null,
+        fog: 'none',
+        fog_color: [0, 0, 0],
+        fog_start: 1,
+        fog_end: 1000,
+        fog_density: 0.01,
+        tonemapping: 0,
+        exposure: 1,
+        gamma_correction: 1,
+        global_ambient: [0.2, 0.2, 0.2],
+        lightmapSizeMultiplier: 16,
+        lightmapMaxResolution: 2048,
+        lightmapMode: 0,
+        skyType: 'infinite',
+        skyMeshPosition: [0, 0, 0],
+        skyMeshRotation: [0, 0, 0],
+        skyMeshScale: [100, 100, 100],
+        skyCenter: [0, 0.1, 0],
+        skyboxIntensity: 1,
+        skyboxMip: 0,
+        skyboxRotation: [0, 0, 0],
+        lightmapFilterEnabled: false,
+        lightmapFilterRange: 10,
+        lightmapFilterSmoothness: 0.2,
+        ambientBake: false,
+        ambientBakeNumSamples: 1,
+        ambientBakeSpherePart: 0.4,
+        ambientBakeOcclusionBrightness: 0,
+        ambientBakeOcclusionContrast: 0,
+        clusteredLightingEnabled: true,
+        lightingCells: [10, 3, 10],
+        lightingMaxLightsPerCell: 255,
+        lightingCookieAtlasResolution: 2048,
+        lightingShadowAtlasResolution: 2048,
+        lightingShadowType: 0,
+        lightingCookiesEnabled: false,
+        lightingAreaLightsEnabled: false,
+        lightingShadowsEnabled: true,
+    },
+    physics: {
+        gravity: [0, -9.8, 0],
+    },
+    priority_scripts: [],
+};
+/**
+ * 深度合并对象：target 中缺少的字段从 source 补全
+ * 只补全 target 中不存在的字段，不覆盖已有值
+ */
+function deepMergeDefaults(target, source) {
+    if (!source || typeof source !== 'object')
+        return target;
+    if (!target || typeof target !== 'object')
+        return { ...source };
+    const result = Array.isArray(target) ? [...target] : { ...target };
+    for (const key of Object.keys(source)) {
+        if (!(key in result)) {
+            result[key] = source[key];
+        }
+        else if (typeof source[key] === 'object' && source[key] !== null && !Array.isArray(source[key]) &&
+            typeof result[key] === 'object' && result[key] !== null && !Array.isArray(result[key])) {
+            result[key] = deepMergeDefaults(result[key], source[key]);
+        }
+    }
+    return result;
+}
+/**
+ * 补全场景 settings
+ * 优先从主场景继承 settings，否则使用默认值
+ */
+function ensureSceneSettings(scenes, mainSceneId) {
+    // 找到主场景（settings 最完整的场景）
+    const mainScene = mainSceneId
+        ? scenes.find(s => String(s.id) === mainSceneId)
+        : scenes[0];
+    // 使用主场景的 settings 作为基础，再补上默认值
+    const baseSettings = mainScene?.settings
+        ? deepMergeDefaults(mainScene.settings, DEFAULT_SCENE_SETTINGS)
+        : DEFAULT_SCENE_SETTINGS;
+    let fixedCount = 0;
+    for (const scene of scenes) {
+        const originalKeys = Object.keys(scene.settings?.render || {});
+        // 判断 settings 是否不完整（render 中少于 5 个字段认为不完整）
+        if (!scene.settings || !scene.settings.render || originalKeys.length < 5) {
+            scene.settings = deepMergeDefaults(scene.settings || {}, baseSettings);
+            fixedCount++;
+            const newKeys = Object.keys(scene.settings.render || {});
+            console.log(`[PlayCraftLoader] 补全场景 "${scene.name}" (${scene.id}) 的 settings: ${originalKeys.length} → ${newKeys.length} 个渲染属性`);
+        }
+    }
+    if (fixedCount > 0) {
+        console.log(`[PlayCraftLoader] 共补全了 ${fixedCount} 个场景的 settings`);
+    }
+}
 /**
  * 加载 PlayCraft 源代码项目
  */
@@ -7,21 +180,81 @@ export async function loadPlayCraftProject(projectDir) {
     // 1. 读取 manifest.json
     const manifestContent = await fs.readFile(path.join(projectDir, 'manifest.json'), 'utf-8');
     const manifest = JSON.parse(manifestContent);
+    // 1.1 从 settings/project.json 加载完整项目设置
+    // manifest.settings 可能只包含 importMap 等少量字段，缺少 width/height/fillMode 等关键应用属性
+    // 需要始终尝试加载 settings/project.json 并合并
+    const needsFullSettings = !manifest.settings || !manifest.settings.width || !manifest.settings.fillMode;
+    if (needsFullSettings) {
+        const settingsPaths = [
+            path.join(projectDir, 'settings', 'project.json'),
+            path.join(projectDir, 'project.json'),
+        ];
+        for (const settingsPath of settingsPaths) {
+            try {
+                const settingsContent = await fs.readFile(settingsPath, 'utf-8');
+                const projectData = JSON.parse(settingsContent);
+                if (projectData.settings) {
+                    // 合并：settings/project.json 的完整设置为基础，manifest.settings 中的字段优先
+                    manifest.settings = { ...projectData.settings, ...(manifest.settings || {}) };
+                    console.log(`[PlayCraftLoader] 从 ${path.relative(projectDir, settingsPath)} 加载并合并项目设置`);
+                    break;
+                }
+            }
+            catch {
+                // 继续尝试下一个路径
+            }
+        }
+    }
     // 2. 读取场景文件
     const scenesDir = path.join(projectDir, 'scenes');
     let scenes = [];
+    // 从 manifest 中获取场景元信息（包含 isMain 标记）
+    const manifestScenes = manifest.scenes || [];
+    const mainSceneId = manifestScenes.find((s) => s.isMain)?.id?.toString();
     try {
         const sceneFiles = await fs.readdir(scenesDir);
-        scenes = await Promise.all(sceneFiles
-            .filter(f => f.endsWith('.scene.json'))
-            .map(async (f) => {
+        // 支持 .scene.json 和 .json 两种格式
+        const jsonFiles = sceneFiles.filter(f => f.endsWith('.json'));
+        scenes = await Promise.all(jsonFiles.map(async (f) => {
             const content = await fs.readFile(path.join(scenesDir, f), 'utf-8');
-            return JSON.parse(content);
+            const scene = JSON.parse(content);
+            // 从文件名提取场景 ID（如 20000078.json → 20000078）
+            if (!scene.id) {
+                scene.id = f.replace(/\.scene\.json$/, '').replace(/\.json$/, '');
+            }
+            // 从 manifest 中补充场景元信息（名称、isMain 等）
+            const manifestScene = manifestScenes.find((ms) => String(ms.id) === String(scene.id));
+            if (manifestScene) {
+                if (!scene.name || scene.name === 'Untitled') {
+                    scene.name = manifestScene.name || scene.name;
+                }
+                if (manifestScene.isMain) {
+                    scene.isMain = true;
+                }
+            }
+            return scene;
         }));
+        // 排序：主场景排在第一个（PlayCanvas 引擎加载 config.scenes[0] 作为默认场景）
+        if (mainSceneId) {
+            scenes.sort((a, b) => {
+                const aIsMain = String(a.id) === mainSceneId ? -1 : 0;
+                const bIsMain = String(b.id) === mainSceneId ? -1 : 0;
+                return aIsMain - bIsMain;
+            });
+        }
+        if (scenes.length > 0) {
+            console.log(`[PlayCraftLoader] 加载了 ${scenes.length} 个场景文件${mainSceneId ? `，主场景: ${mainSceneId}` : ''}`);
+        }
+        // 补全不完整的场景 settings
+        // PlayCraft Editor 中，非主场景可能只保存了修改过的设置字段，
+        // 其余字段在运行时由 Editor 补充默认值。打包时需要手动补全。
+        if (scenes.length > 0) {
+            ensureSceneSettings(scenes, mainSceneId);
+        }
     }
     catch (error) {
         // scenes 目录可能不存在
-        console.warn('警告: scenes 目录不存在，跳过场景加载');
+        console.warn('[PlayCraftLoader] 警告: scenes 目录不存在，跳过场景加载');
     }
     // 3. 读取 assets.json（PlayCraft 保留的 PlayCanvas 兼容层）
     let assets = {};
@@ -42,6 +275,8 @@ export async function loadPlayCraftProject(projectDir) {
             }
         }
     }
+    // 4. 修正 PlayCraft 资源 URL（将 API URL 转换为本地路径）
+    await resolvePlayCraftUrls(assets, projectDir);
     return {
         manifest,
         scenes,

package/dist/platforms/adikteev.d.ts

@@ -4,7 +4,7 @@ export declare class AdikteevAdapter extends PlatformAdapter {
     getName(): string;
     getSizeLimit(): number;
     getDefaultFormat(): 'html' | 'zip';
-    modifyHTML(html: string, assets: AssetInfo[]): string;
+    modifyHTML(html: string, assets: AssetInfo[]): Promise<string>;
     getPlatformScript(): string;
     validateOptions(): void;
 }

package/dist/platforms/adikteev.js

@@ -10,46 +10,40 @@ export class AdikteevAdapter extends PlatformAdapter {
     getDefaultFormat() {
         return 'html';
     }
-    modifyHTML(html, assets) {
+    async modifyHTML(html, assets) {
         // Adikteev 需要 MRAID 3.0 支持
-        const adikteevScript = `
-      <script>
-        // MRAID 3.0 API
-        window.mraid = window.mraid || {
-          getVersion: function() { return '3.0'; },
-          isReady: function() { return true; },
-          open: function(url) { 
-            console.log('Adikteev CTA: opening store');
-            window.open(url, '_blank'); 
-          },
-          close: function() { window.close(); },
-          addEventListener: function(event, listener) {
-            if (event === 'ready' || event === 'viewableChange') {
-              setTimeout(() => listener({ viewable: true }), 0);
-            }
-          },
-          removeEventListener: function(event, listener) {},
-          getState: function() { return 'default'; },
-          getPlacementType: function() { return 'interstitial'; },
-          isViewable: function() { return true; },
-          getMaxSize: function() { return { width: window.innerWidth, height: window.innerHeight }; },
-          getCurrentPosition: function() { return { x: 0, y: 0, width: window.innerWidth, height: window.innerHeight }; },
-          getScreenSize: function() { return { width: screen.width, height: screen.height }; }
-        };
-      </script>
-      <!-- 
-        注意：
-        - Adikteev 要求 MRAID 3.0
-        - 使用单文件 HTML 格式
-        - 使用 mraid.open() 跳转应用商店
-        - 需等待 viewableChange 事件后再启动游戏
-        - 不允许自动重定向
-      -->
+        const adikteevScriptCode = `
+      window.mraid = window.mraid || {
+        getVersion: function() { return '3.0'; },
+        isReady: function() { return true; },
+        open: function(url) { 
+          console.log('Adikteev CTA: opening store');
+          if (url) { window.open(url, '_blank'); return; }
+          var ua = navigator.userAgent || '';
+          var isIOS = /iPad|iPhone|iPod/.test(ua) || (navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1);
+          window.open(isIOS ? 'https://apps.apple.com/us/app/8-ball-pool/id543186831' : 'https://play.google.com/store/apps/details?id=com.miniclip.eightballpool', '_blank');
+        },
+        close: function() { window.close(); },
+        addEventListener: function(event, listener) {
+          if (event === 'ready' || event === 'viewableChange') {
+            setTimeout(function() { listener({ viewable: true }); }, 0);
+          }
+        },
+        removeEventListener: function(event, listener) {},
+        getState: function() { return 'default'; },
+        getPlacementType: function() { return 'interstitial'; },
+        isViewable: function() { return true; },
+        getMaxSize: function() { return { width: window.innerWidth, height: window.innerHeight }; },
+        getCurrentPosition: function() { return { x: 0, y: 0, width: window.innerWidth, height: window.innerHeight }; },
+        getScreenSize: function() { return { width: screen.width, height: screen.height }; }
+      };
     `;
+        const adikteevScript = await this.minifyPlatformScript(adikteevScriptCode, 'adikteev-mraid');
+        const comment = `<!-- Adikteev: MRAID 3.0, 等待viewableChange, 使用mraid.open() -->`;
         // 在 </head> 之前插入平台特定的 API
-        html = html.replace('</head>', `${adikteevScript}</head>`);
+        html = html.replace('</head>', `${adikteevScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
-        html = this.injectCTAAdapter(html);
+        html = await this.injectCTAAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/applovin.d.ts

@@ -4,7 +4,7 @@ export declare class AppLovinAdapter extends PlatformAdapter {
     getName(): string;
     getSizeLimit(): number;
     getDefaultFormat(): 'html' | 'zip';
-    modifyHTML(html: string, assets: AssetInfo[]): string;
+    modifyHTML(html: string, assets: AssetInfo[]): Promise<string>;
     getPlatformScript(): string;
     validateOptions(): void;
 }

package/dist/platforms/applovin.js

@@ -10,46 +10,41 @@ export class AppLovinAdapter extends PlatformAdapter {
     getDefaultFormat() {
         return 'html';
     }
-    modifyHTML(html, assets) {
+    async modifyHTML(html, assets) {
         // AppLovin 需要 MRAID v2.0 支持
-        const appLovinScript = `
-      <script>
-        // MRAID 2.0 API
-        window.mraid = window.mraid || {
-          getVersion: function() { return '2.0'; },
-          isReady: function() { return true; },
-          open: function(url) { 
-            console.log('AppLovin CTA: opening store');
-            window.open(url); 
-          },
-          close: function() { 
-            console.warn('AppLovin: close() button is disabled, handled by platform'); 
-          },
-          addEventListener: function(event, listener) {
-            if (event === 'ready') {
-              setTimeout(listener, 0);
-            }
-          },
-          removeEventListener: function(event, listener) {},
-          getState: function() { return 'default'; },
-          getPlacementType: function() { return 'interstitial'; },
-          isViewable: function() { return true; },
-          getMaxSize: function() { return { width: window.innerWidth, height: window.innerHeight }; },
-          getCurrentPosition: function() { return { x: 0, y: 0, width: window.innerWidth, height: window.innerHeight }; },
-          getScreenSize: function() { return { width: screen.width, height: screen.height }; }
-        };
-      </script>
-      <!-- 
-        注意：
-        - AppLovin 要求必须同时支持横屏和竖屏
-        - 禁止添加退出按钮（平台统一处理）
-        - CTA 使用 mraid.open()
-      -->
+        const appLovinScriptCode = `
+      window.mraid = window.mraid || {
+        getVersion: function() { return '2.0'; },
+        isReady: function() { return true; },
+        open: function(url) { 
+          console.log('AppLovin CTA: opening store');
+          if (url) { window.open(url, '_blank'); return; }
+          var ua = navigator.userAgent || '';
+          var isIOS = /iPad|iPhone|iPod/.test(ua) || (navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1);
+          var _s = window.__PLAYCRAFT_STORE_URLS__ || {};
+          window.open(isIOS ? (_s.ios || '') : (_s.android || ''), '_blank');
+        },
+        close: function() { 
+          console.warn('AppLovin: close() disabled'); 
+        },
+        addEventListener: function(event, listener) {
+          if (event === 'ready') setTimeout(listener, 0);
+        },
+        removeEventListener: function(event, listener) {},
+        getState: function() { return 'default'; },
+        getPlacementType: function() { return 'interstitial'; },
+        isViewable: function() { return true; },
+        getMaxSize: function() { return { width: window.innerWidth, height: window.innerHeight }; },
+        getCurrentPosition: function() { return { x: 0, y: 0, width: window.innerWidth, height: window.innerHeight }; },
+        getScreenSize: function() { return { width: screen.width, height: screen.height }; }
+      };
     `;
+        const appLovinScript = await this.minifyPlatformScript(appLovinScriptCode, 'applovin-mraid');
+        const comment = `<!-- AppLovin: 必须支持横竖屏, 禁止退出按钮, CTA 用 mraid.open() -->`;
         // 在 </head> 之前插入平台特定的 API
-        html = html.replace('</head>', `${appLovinScript}</head>`);
+        html = html.replace('</head>', `${appLovinScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
-        html = this.injectCTAAdapter(html);
+        html = await this.injectCTAAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/base.d.ts

@@ -15,11 +15,11 @@ export declare abstract class PlatformAdapter {
      */
     abstract getDefaultFormat(): 'html' | 'zip';
     /**
-     * 应用平台特定的 HTML 修改
+     * 应用平台特定的 HTML 修改（异步版本，带脚本压缩）
      */
-    abstract modifyHTML(html: string, assets: AssetInfo[]): string;
+    abstract modifyHTML(html: string, assets: AssetInfo[]): Promise<string>;
     /**
-     * 获取平台特定的 JavaScript 代码
+     * 获取平台特定的 JavaScript 代码（原始代码，用于压缩）
      */
     abstract getPlatformScript(): string;
     /**
@@ -31,11 +31,33 @@ export declare abstract class PlatformAdapter {
      */
     protected readTemplateFile(filename: string): Promise<string>;
     /**
-     * 获取 CTA 适配器脚本（同步版本，用于模板字符串）
+     * 压缩平台脚本代码
+     * @param scriptCode - 原始 JavaScript 代码
+     * @param cacheKey - 缓存键（通常是平台名称）
+     * @returns 压缩后的 <script> 标签
+     */
+    protected minifyPlatformScript(scriptCode: string, cacheKey?: string): Promise<string>;
+    /**
+     * 获取 CTA 适配器脚本（异步版本，带压缩）
+     */
+    protected getCTAAdapterScriptAsync(): Promise<string>;
+    /**
+     * 生成 Store URLs 注入脚本
+     * 将 storeUrls 以全局变量写入 HTML，供 CTA 适配器读取
+     */
+    protected getStoreUrlsScript(): string;
+    /**
+     * 获取 CTA 适配器脚本（同步版本，使用预压缩代码）
+     * @deprecated 推荐使用 getCTAAdapterScriptAsync
      */
     protected getCTAAdapterScript(): string;
     /**
-     * 在 HTML 中注入 CTA 适配器
+     * 在 HTML 中注入 CTA 适配器（异步版本）
+     */
+    protected injectCTAAdapterAsync(html: string): Promise<string>;
+    /**
+     * 在 HTML 中注入 CTA 适配器（同步版本）
+     * @deprecated 推荐使用 injectCTAAdapterAsync
      */
     protected injectCTAAdapter(html: string): string;
 }