@playcraft/cli 0.0.52 → 0.0.55

package/project-templates/playable-template-three/scripts/theme-builds.js

@@ -0,0 +1,514 @@
+#!/usr/bin/env node
+
+/**
+ * 批量构建脚本 - Three.js Template
+ * 
+ * 功能：
+ * - 支持多主题自动切换构建（可选）
+ * - 支持多渠道批量构建
+ * - 自动生成规范文件名
+ * - 灵活的配置系统
+ * 
+ * 使用方法：
+ * npm run build:all                           # 构建所有（使用默认配置）
+ * npm run builds                              # 同上（别名）
+ * npm run builds -- -t "theme1,theme2"       # 构建指定主题
+ * npm run builds -- -c "google,facebook"     # 构建指定渠道
+ * npm run builds -- -t "theme1" -c "google"  # 构建指定主题和渠道
+ * 
+ * 配置文件（可选）：
+ * 在项目根目录创建 builds.config.js 来自定义配置
+ * 如果不存在配置文件，将使用默认配置（无主题切换，多渠道构建）
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// ==================== 默认配置 ====================
+
+const DEFAULT_CONFIG = {
+  // 项目基本信息
+  projectName: 'Three Game',
+  projectCode: '0001',
+  
+  // 渠道列表
+  channels: [
+    'google',
+    'facebook',
+    'tiktok',
+    'applovin',
+    'ironSource',
+    'unity',
+    'moloco',
+    'liftoff',
+    'bigoads'
+  ],
+  
+  // 主题配置
+  themes: {
+    enabled: false,           // 是否启用主题切换
+    sourceDir: 'src/theme',   // 主题目录
+    entryFile: 'src/index.ts', // 入口文件
+    whitelist: null,          // 主题白名单函数（返回允许的主题列表）
+  },
+  
+  // 文件命名配置
+  naming: {
+    language: 'EN',
+    format: '无',
+    supplier: 'AIX',
+    follower: 'ZQL',
+    // 自定义文件名生成函数
+    // generator: (themeName, channel, date, month) => { ... }
+  },
+  
+  // 构建配置
+  build: {
+    outputDir: 'dist-all',    // 批量构建输出目录
+    tempDir: 'dist',          // 单次构建临时目录
+    continueOnError: true,    // 单个渠道失败后是否继续
+    cleanTemp: true,          // 构建后是否清理临时目录
+  }
+};
+
+// ==================== 工具函数 ====================
+
+let isExiting = false;
+let backupContent = null;
+let backupPath = null;
+
+function log(message, level = 'info') {
+  const timestamp = new Date().toLocaleTimeString();
+  const colors = {
+    info: '\x1b[36m',    // cyan
+    success: '\x1b[32m', // green
+    error: '\x1b[31m',   // red
+    warn: '\x1b[33m',    // yellow
+    debug: '\x1b[90m'    // gray
+  };
+  const reset = '\x1b[0m';
+  const prefix = {
+    info: '📦',
+    success: '✅',
+    error: '❌',
+    warn: '⚠️',
+    debug: '🔍'
+  }[level] || 'ℹ️';
+  
+  console.log(`${colors[level]}[${timestamp}] ${prefix} ${message}${reset}`);
+}
+
+function getCurrentMonth() {
+  const month = new Date().getMonth() + 1;
+  return `${month}月`;
+}
+
+function getCurrentDate() {
+  const date = new Date();
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  return `${year}${month}${day}`;
+}
+
+/**
+ * 默认文件名生成器
+ */
+function defaultFileNameGenerator(config, themeName, channel) {
+  const parts = [
+    themeName,
+    config.naming.language,
+    config.naming.format,
+    getCurrentMonth(),
+    getCurrentDate(),
+    config.naming.supplier,
+    config.naming.follower,
+    channel.toLowerCase()
+  ];
+  
+  return parts.join('-');
+}
+
+/**
+ * 获取所有主题
+ */
+function getAllThemes(config) {
+  const themesDir = path.join(PROJECT_ROOT, config.themes.sourceDir);
+  
+  if (!fs.existsSync(themesDir)) {
+    log(`主题目录不存在: ${themesDir}`, 'warn');
+    return [];
+  }
+  
+  const entries = fs.readdirSync(themesDir, { withFileTypes: true });
+  let themes = entries
+    .filter(entry => entry.isDirectory())
+    .map(entry => entry.name)
+    .sort();
+  
+  // 应用白名单过滤
+  if (config.themes.whitelist && typeof config.themes.whitelist === 'function') {
+    themes = themes.filter(config.themes.whitelist);
+    log(`应用主题白名单过滤: ${themes.length} 个主题`, 'debug');
+  }
+  
+  return themes;
+}
+
+/**
+ * 备份入口文件
+ */
+function backupEntryFile(config) {
+  const entryPath = path.join(PROJECT_ROOT, config.themes.entryFile);
+  
+  if (!fs.existsSync(entryPath)) {
+    throw new Error(`入口文件不存在: ${entryPath}`);
+  }
+  
+  backupPath = entryPath;
+  backupContent = fs.readFileSync(entryPath, 'utf8');
+  log(`已备份入口文件: ${config.themes.entryFile}`, 'debug');
+}
+
+/**
+ * 恢复入口文件
+ */
+function restoreEntryFile() {
+  if (backupPath && backupContent) {
+    fs.writeFileSync(backupPath, backupContent, 'utf8');
+    log(`已恢复入口文件`, 'debug');
+    backupPath = null;
+    backupContent = null;
+  }
+}
+
+/**
+ * 切换主题
+ */
+function switchTheme(config, themeName) {
+  const entryPath = path.join(PROJECT_ROOT, config.themes.entryFile);
+  const themePath = `./${config.themes.sourceDir}/${themeName}`;
+  
+  const content = `export { default } from '${themePath}';\n`;
+  fs.writeFileSync(entryPath, content, 'utf8');
+  
+  log(`已切换主题: ${themeName}`, 'debug');
+}
+
+/**
+ * 构建单个渠道
+ */
+function buildChannel(config, themeName, channel, outputDir) {
+  log(`开始构建: 主题=${themeName}, 渠道=${channel}`);
+  
+  try {
+    // 生成文件名
+    const fileName = config.naming.generator
+      ? config.naming.generator(themeName, channel, getCurrentDate(), getCurrentMonth())
+      : defaultFileNameGenerator(config, themeName, channel);
+    
+    log(`文件名: ${fileName}`, 'debug');
+    
+    // 更新 build.json
+    const buildJsonPath = path.join(PROJECT_ROOT, 'build.json');
+    const buildConfig = JSON.parse(fs.readFileSync(buildJsonPath, 'utf8'));
+    const originalFileName = buildConfig.filename;
+    buildConfig.filename = fileName;
+    fs.writeFileSync(buildJsonPath, JSON.stringify(buildConfig, null, 2));
+    
+    // 执行构建
+    execSync(`npm run build -- ${channel}`, {
+      cwd: PROJECT_ROOT,
+      stdio: 'inherit'
+    });
+    
+    // 恢复 build.json
+    buildConfig.filename = originalFileName;
+    fs.writeFileSync(buildJsonPath, JSON.stringify(buildConfig, null, 2));
+    
+    // 移动构建产物
+    const tempDistDir = path.join(PROJECT_ROOT, config.build.tempDir);
+    const targetDir = path.join(outputDir, themeName, channel);
+    
+    if (fs.existsSync(tempDistDir)) {
+      if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+      }
+      
+      const files = fs.readdirSync(tempDistDir);
+      files.forEach(file => {
+        const srcPath = path.join(tempDistDir, file);
+        const destPath = path.join(targetDir, file);
+        
+        if (fs.statSync(srcPath).isDirectory()) {
+          copyDirRecursive(srcPath, destPath);
+        } else {
+          fs.copyFileSync(srcPath, destPath);
+        }
+      });
+      
+      log(`✓ 构建成功: ${themeName}/${channel}`, 'success');
+    }
+  } catch (error) {
+    log(`构建失败: ${themeName}/${channel} - ${error.message}`, 'error');
+    
+    if (!config.build.continueOnError) {
+      throw error;
+    }
+  }
+}
+
+/**
+ * 递归复制目录
+ */
+function copyDirRecursive(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+  
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * 清理临时目录
+ */
+function cleanTempDir(config) {
+  const tempDir = path.join(PROJECT_ROOT, config.build.tempDir);
+  if (fs.existsSync(tempDir)) {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+
+/**
+ * 解析命令行参数
+ */
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const result = {
+    themes: null,
+    channels: null
+  };
+  
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '-t' || args[i] === '--themes') {
+      result.themes = args[i + 1]?.split(',').map(t => t.trim()).filter(Boolean);
+      i++;
+    } else if (args[i] === '-c' || args[i] === '--channels') {
+      result.channels = args[i + 1]?.split(',').map(c => c.trim()).filter(Boolean);
+      i++;
+    }
+  }
+  
+  return result;
+}
+
+/**
+ * 加载配置文件
+ */
+function loadConfig() {
+  const configPath = path.join(PROJECT_ROOT, 'builds.config.js');
+  
+  if (fs.existsSync(configPath)) {
+    log('加载配置文件: builds.config.js', 'debug');
+    const userConfig = require(configPath);
+    return mergeConfig(DEFAULT_CONFIG, userConfig);
+  }
+  
+  log('使用默认配置', 'debug');
+  return { ...DEFAULT_CONFIG };
+}
+
+/**
+ * 深度合并配置
+ */
+function mergeConfig(defaultConfig, userConfig) {
+  const result = { ...defaultConfig };
+  
+  for (const key in userConfig) {
+    if (typeof userConfig[key] === 'object' && !Array.isArray(userConfig[key])) {
+      result[key] = { ...defaultConfig[key], ...userConfig[key] };
+    } else {
+      result[key] = userConfig[key];
+    }
+  }
+  
+  return result;
+}
+
+/**
+ * 打印配置摘要
+ */
+function printSummary(config, themes, channels) {
+  const totalBuilds = themes.length * channels.length;
+  
+  log('========================================');
+  log('开始批量构建任务');
+  log(`项目: ${config.projectName}`);
+  log(`主题数: ${themes.length}`);
+  log(`渠道数: ${channels.length}`);
+  log(`总构建数: ${totalBuilds}`);
+  log('========================================\n');
+  
+  if (themes.length <= 10) {
+    log(`主题列表: ${themes.join(', ')}`, 'debug');
+  }
+  log(`渠道列表: ${channels.join(', ')}`, 'debug');
+  log('');
+}
+
+// ==================== 主函数 ====================
+
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+
+async function main() {
+  const startTime = Date.now();
+  
+  try {
+    // 加载配置
+    const config = loadConfig();
+    
+    // 解析命令行参数
+    const args = parseArgs();
+    
+    // 确定主题列表
+    let themes;
+    if (!config.themes.enabled) {
+      // 不启用主题切换，使用项目名称作为单一"主题"
+      themes = [config.projectName.replace(/\s+/g, '-')];
+    } else if (args.themes) {
+      themes = args.themes;
+      log(`使用命令行指定的主题: ${themes.join(', ')}`, 'info');
+    } else {
+      themes = getAllThemes(config);
+      if (themes.length === 0) {
+        throw new Error('未找到任何主题');
+      }
+    }
+    
+    // 确定渠道列表
+    const channels = args.channels || config.channels;
+    
+    // 打印摘要
+    printSummary(config, themes, channels);
+    
+    // 备份入口文件（如果启用主题切换）
+    if (config.themes.enabled) {
+      backupEntryFile(config);
+    }
+    
+    // 批量构建
+    const outputDir = path.join(PROJECT_ROOT, config.build.outputDir);
+    let completedBuilds = 0;
+    const totalBuilds = themes.length * channels.length;
+    const failedBuilds = [];
+    
+    for (const theme of themes) {
+      // 切换主题
+      if (config.themes.enabled) {
+        switchTheme(config, theme);
+      }
+      
+      for (const channel of channels) {
+        try {
+          // 清理临时目录
+          if (config.build.cleanTemp) {
+            cleanTempDir(config);
+          }
+          
+          // 构建
+          buildChannel(config, theme, channel, outputDir);
+          
+          completedBuilds++;
+          const progress = Math.round(completedBuilds / totalBuilds * 100);
+          log(`进度: ${completedBuilds}/${totalBuilds} (${progress}%)`, 'success');
+        } catch (error) {
+          failedBuilds.push({ theme, channel, error: error.message });
+          
+          if (!config.build.continueOnError) {
+            throw error;
+          }
+          
+          log(`跳过失败的构建: ${theme}/${channel}`, 'warn');
+        }
+      }
+    }
+    
+    // 恢复入口文件
+    if (config.themes.enabled) {
+      restoreEntryFile();
+    }
+    
+    // 清理临时目录
+    if (config.build.cleanTemp) {
+      cleanTempDir(config);
+    }
+    
+    // 打印结果
+    const duration = ((Date.now() - startTime) / 1000 / 60).toFixed(2);
+    log('\n========================================');
+    log('🎉 所有构建任务完成！', 'success');
+    log(`✓ 成功构建: ${completedBuilds}/${totalBuilds}`);
+    
+    if (failedBuilds.length > 0) {
+      log(`✗ 失败构建: ${failedBuilds.length}`, 'warn');
+      failedBuilds.forEach(({ theme, channel, error }) => {
+        log(`  - ${theme}/${channel}: ${error}`, 'error');
+      });
+    }
+    
+    log(`⏱️  耗时: ${duration} 分钟`);
+    log(`📁 输出目录: ${outputDir}`);
+    log('========================================');
+    
+  } catch (error) {
+    log(`严重错误: ${error.message}`, 'error');
+    console.error(error);
+    
+    // 确保恢复入口文件
+    restoreEntryFile();
+    
+    process.exit(1);
+  }
+}
+
+// ==================== 信号处理 ====================
+
+function cleanup() {
+  if (isExiting) return;
+  isExiting = true;
+  
+  log('\n收到中断信号，正在清理...', 'warn');
+  
+  restoreEntryFile();
+  
+  const config = loadConfig();
+  if (config.build.cleanTemp) {
+    cleanTempDir(config);
+  }
+  
+  process.exit(1);
+}
+
+process.on('SIGINT', cleanup);
+process.on('SIGTERM', cleanup);
+
+// ==================== 执行 ====================
+
+main().catch(error => {
+  log(`未捕获的错误: ${error.message}`, 'error');
+  console.error(error);
+  restoreEntryFile();
+  process.exit(1);
+});