@htyf-mp/cli 0.1.3 → 0.2.0-alpha.10

package/src/build.mjs

@@ -0,0 +1,169 @@
+import path from 'path';
+import fse from 'fs-extra';
+import AdmZip from 'adm-zip';
+import { fileURLToPath } from 'node:url';
+import { Logger } from './logger.mjs';
+import { CONSTANTS } from './constants.mjs';
+import { FileSystemUtils } from './file-system.mjs';
+import { CommandExecutor } from './command-executor.mjs';
+import { getMiniAppScriptId } from './utils-functions.mjs';
+import { getProjectRoot, guessGodotProjectDir } from './utils.mjs';
+import { exportGodot, promptGodotOptions } from './export_godot.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PROJECT_ROOT = getProjectRoot();
+
+/**
+ * 压缩文件夹为zip文件
+ * @param {string} inputPath - 输入路径
+ * @param {string} outputPath - 输出路径
+ * @returns {Promise<string>} 压缩包路径
+ */
+export async function handleZip(inputPath, outputPath) {
+  Logger.info(`开始压缩文件夹: ${inputPath}`);
+  Logger.info(`输出文件: ${outputPath}`);
+
+  if (!(await fse.pathExists(inputPath))) {
+    throw new Error(`输入路径不存在: ${inputPath}`);
+  }
+
+  const stats = await fse.stat(inputPath);
+  if (!stats.isDirectory()) {
+    throw new Error(`输入路径不是目录: ${inputPath}`);
+  }
+
+  const files = await fse.readdir(inputPath);
+  Logger.debug(`目录内容: ${files.length} 个文件/文件夹`);
+
+  if (files.length === 0) {
+    Logger.warn(`警告: 目录为空，将创建空的zip文件`);
+  }
+
+  const zipPath = outputPath;
+  const admzip = new AdmZip();
+
+  try {
+    await admzip.addLocalFolderPromise(inputPath, {
+      filter: (filename) => {
+        if (filename.endsWith('.map')) {
+          Logger.debug(`过滤文件: ${filename}`);
+          return false;
+        }
+        Logger.debug(`添加文件: ${filename}`);
+        return true;
+      }
+    });
+
+    await admzip.writeZipPromise(zipPath);
+    Logger.success(`压缩完成: ${zipPath}`);
+
+    const zipStats = await fse.stat(zipPath);
+    Logger.info(`ZIP文件大小: ${FileSystemUtils.formatFileSize(zipStats.size)}`);
+
+    return zipPath;
+  } catch (error) {
+    Logger.error(`压缩失败: ${error.message}`);
+    throw error;
+  }
+}
+
+/**
+ * 构建小程序包
+ * @param {object} newAppInfo - 应用信息
+ * @returns {Promise<string>} 压缩包路径
+ */
+export async function mpBuildShell(newAppInfo, isGodot) {
+  Logger.info(`开始构建小程序包...`);
+  Logger.info(`应用: ${newAppInfo.name}`);
+  Logger.info(`应用ID: ${newAppInfo.appid}`);
+  Logger.info(`版本: ${newAppInfo.version}`);
+  Logger.info(`平台: ${CONSTANTS.BUNDLE_PLATFORM}`);
+  
+  // 验证必需字段
+  if (!newAppInfo.name || !newAppInfo.appid || !newAppInfo.version) {
+    throw new Error('缺少必需的应用信息: name, appid, version');
+  }
+  
+  // 创建临时目录
+  const tempPath = CONSTANTS.TEMP_DIR;
+  if (!FileSystemUtils.ensureDirectory(tempPath)) {
+    throw new Error('无法创建临时目录');
+  }
+
+  const mpOutputPath = CONSTANTS.MP_OUTPUT_DIR;
+  if (!FileSystemUtils.ensureDirectory(mpOutputPath)) {
+    throw new Error('无法创建输出目录');
+  }
+
+  const { version, appid } = newAppInfo;
+  const scriptName = getMiniAppScriptId(appid, version);
+
+  const appJson = {
+    type: 'app',
+    engines: '2.0.0',
+    name: newAppInfo.name,
+    appid,
+    version,
+    appUrlConfig: newAppInfo.appUrlConfig || `${newAppInfo.host}/app.json`,
+    zipUrl: newAppInfo.zipUrl || `${newAppInfo.host}/dist.dgz`
+  };
+  
+  let outputPath = path.join(mpOutputPath, 'dist');
+  const distPackagePath = path.join(mpOutputPath, 'dist.dgz');
+  const rootIndexPath = path.join(tempPath, '..', 'index.js');
+
+  const mpOptions = {
+    name: scriptName,
+    filename: `${scriptName}.bundle`,
+    exposes: {
+      'App': newAppInfo.entry,
+    },
+    outputPath: path.join(mpOutputPath, 'build'),
+    extraChunksPath: outputPath,
+    manifest: path.join(mpOutputPath, 'build'),
+  };
+
+  const appJsonPath = path.join(mpOutputPath, 'app.json');
+  await fse.writeJson(appJsonPath, appJson, { spaces: 2 });
+  const webpackConfigPath = path.join(__dirname, 'webpack.config.mjs');
+
+
+  try {
+    if (!isGodot) {
+      const command = `npx cross-env APP_ROOT_INDEX_PATH=${rootIndexPath} APP_EXPOSES_OPTIONS=${encodeURI(JSON.stringify(mpOptions))} webpack --config ${webpackConfigPath}`;
+      await CommandExecutor.execute(command, {
+        description: '构建小程序包',
+        timeout: 120000,
+        showCommand: false
+      });
+    } else {
+      Logger.info('检测到 Godot 项目，开始执行 Godot 导出流程...');
+      const defaultPlatform = ['android', 'ios'].includes(CONSTANTS.BUNDLE_PLATFORM) 
+        ? CONSTANTS.BUNDLE_PLATFORM 
+        : 'ios';
+      const godotDefaults = {
+        targetBaseDir: outputPath,
+        projectDir: guessGodotProjectDir(PROJECT_ROOT),
+        name: newAppInfo.appid || 'GodotApp',
+        preset: defaultPlatform === 'android' ? 'Android' : 'iOS',
+        platform: defaultPlatform
+      };
+      const godotOptions = await promptGodotOptions(godotDefaults);
+      outputPath = path.resolve(godotOptions.targetBaseDir);
+      await fse.ensureDir(outputPath);
+      await fse.emptyDir(outputPath);
+      await exportGodot(godotOptions);
+    }
+
+    await fse.ensureDir(outputPath);
+    await fse.copy(appJsonPath, path.join(outputPath, 'app.json'));
+    const zipPath = await handleZip(outputPath, distPackagePath);
+    Logger.success(`压缩包已创建: ${zipPath}`);
+    return zipPath;
+  } catch (error) {
+    Logger.error(`小程序构建失败: ${error.message}`);
+    throw error;
+  }
+}
+

package/src/clean.mjs

@@ -0,0 +1,83 @@
+import path from 'path';
+import { Logger } from './logger.mjs';
+import { CONSTANTS } from './constants.mjs';
+import { FileSystemUtils } from './file-system.mjs';
+import { getProjectRoot } from './utils.mjs';
+
+const projectPath = getProjectRoot();
+
+/**
+ * 清理临时文件
+ * @param {string} cleanType - 清理类型 ('all', 'build', 'temp', 'logs', 'cache', 或应用名称)
+ */
+export async function cleanShell(cleanType = 'all') {
+  Logger.info('开始清理文件...');
+
+  const pathsToClean = [];
+  let totalSizeBefore = 0;
+
+  if (cleanType === 'build') {
+    // 只清理构建输出
+    const buildPath = CONSTANTS.MP_OUTPUT_DIR;
+    pathsToClean.push(buildPath);
+    totalSizeBefore += FileSystemUtils.calculateDirectorySize(buildPath);
+    Logger.info('清理构建输出文件...');
+  } else if (cleanType === 'temp') {
+    // 只清理临时文件
+    const tempPath = CONSTANTS.TEMP_DIR;
+    pathsToClean.push(tempPath);
+    totalSizeBefore += FileSystemUtils.calculateDirectorySize(tempPath);
+    Logger.info('清理临时文件...');
+  } else if (cleanType === 'logs') {
+    // 清理日志文件
+    const logsPath = CONSTANTS.LOGS_DIR;
+    pathsToClean.push(logsPath);
+    totalSizeBefore += FileSystemUtils.calculateDirectorySize(logsPath);
+    Logger.info('清理日志文件...');
+  } else if (cleanType === 'cache') {
+    // 清理缓存文件
+    const cachePaths = [
+      path.join(projectPath, 'node_modules/.cache'),
+      path.join(projectPath, '.cache'),
+      path.join(projectPath, 'dist/.cache')
+    ];
+    pathsToClean.push(...cachePaths);
+    cachePaths.forEach(cachePath => {
+      totalSizeBefore += FileSystemUtils.calculateDirectorySize(cachePath);
+    });
+    Logger.info('清理缓存文件...');
+  } else if (cleanType && cleanType !== 'all') {
+    // 清理指定应用的文件
+    const appTempPath = path.join(CONSTANTS.TEMP_DIR, cleanType);
+    const appBuildPath = path.join(CONSTANTS.MP_OUTPUT_DIR, cleanType);
+    pathsToClean.push(appTempPath, appBuildPath);
+    totalSizeBefore += FileSystemUtils.calculateDirectorySize(appTempPath) + FileSystemUtils.calculateDirectorySize(appBuildPath);
+    Logger.info(`清理应用 ${cleanType} 的文件...`);
+  } else {
+    // 清理所有文件
+    const allPaths = [
+      path.join(CONSTANTS.TEMP_DIR),
+      path.join(CONSTANTS.MP_OUTPUT_DIR),
+      path.join(CONSTANTS.LOGS_DIR),
+      path.join(projectPath, 'node_modules/.cache'),
+      path.join(projectPath, '.cache'),
+      path.join(projectPath, 'dist/.cache')
+    ];
+    pathsToClean.push(...allPaths);
+    allPaths.forEach(cleanPath => {
+      totalSizeBefore += FileSystemUtils.calculateDirectorySize(cleanPath);
+    });
+    Logger.info('清理所有临时文件...');
+  }
+
+  let cleanedCount = 0;
+  for (const cleanPath of pathsToClean) {
+    if (FileSystemUtils.cleanDirectory(cleanPath)) {
+      cleanedCount++;
+    }
+  }
+
+  const freedSpace = FileSystemUtils.formatFileSize(totalSizeBefore);
+  Logger.success(`清理完成，已清理 ${cleanedCount} 个目录，释放空间: ${freedSpace}`);
+}
+

package/src/command-executor.mjs

@@ -0,0 +1,133 @@
+import shell from 'shelljs';
+import ora from 'ora';
+import { Logger } from './logger.mjs';
+import { CONSTANTS } from './constants.mjs';
+
+/**
+ * 命令执行工具类
+ */
+export class CommandExecutor {
+  static async execute(command, options = {}) {
+    const {
+      silent = false,
+      fatal = true,
+      timeout = CONSTANTS.DEFAULT_TIMEOUT,
+      retryCount = CONSTANTS.MAX_RETRY_COUNT,
+      description = '执行命令',
+      showCommand = false
+    } = options;
+
+    const displayCommand = showCommand ? command : description;
+    const spinner = ora(displayCommand).start();
+
+    // 信号处理：当收到退出信号时，停止 spinner
+    const cleanup = () => {
+      spinner.stop();
+    };
+    process.once('SIGINT', cleanup);
+    process.once('SIGTERM', cleanup);
+
+    try {
+      for (let attempt = 1; attempt <= retryCount; attempt++) {
+        try {
+          Logger.debug(`执行命令 (尝试 ${attempt}/${retryCount}): ${command}`);
+
+          const result = await new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+              reject(new Error(`命令执行超时 (${timeout}ms)`));
+            }, timeout);
+
+            shell.exec(command, {
+              silent: silent,
+              fatal: false,
+              async: false
+            }, (code, stdout, stderr) => {
+              clearTimeout(timeoutId);
+              resolve({ code, stdout, stderr });
+            });
+          });
+
+          if (result.code === 0) {
+            process.removeListener('SIGINT', cleanup);
+            process.removeListener('SIGTERM', cleanup);
+            spinner.succeed(`${description} 成功`);
+            Logger.debug(`命令输出: ${result.stdout}`);
+            return result;
+          } else {
+            throw new Error(`命令执行失败，退出码: ${result.code}, 错误: ${result.stderr}`);
+          }
+        } catch (error) {
+          // 如果是用户中断，直接退出
+          if (error.message && (error.message.includes('SIGINT') || error.message.includes('SIGTERM'))) {
+            process.removeListener('SIGINT', cleanup);
+            process.removeListener('SIGTERM', cleanup);
+            spinner.stop();
+            throw error;
+          }
+
+          if (attempt === retryCount) {
+            process.removeListener('SIGINT', cleanup);
+            process.removeListener('SIGTERM', cleanup);
+            spinner.fail(`${description} 失败 (${retryCount} 次尝试后)`);
+            Logger.error(`命令执行失败: ${error.message}`);
+
+            if (fatal) {
+              process.exit(1);
+            }
+            throw error;
+          } else {
+            Logger.warn(`命令执行失败，准备重试 (${attempt}/${retryCount}): ${error.message}`);
+            await new Promise(resolve => setTimeout(resolve, 1000 * attempt)); // 递增延迟
+          }
+        }
+      }
+    } catch (error) {
+      process.removeListener('SIGINT', cleanup);
+      process.removeListener('SIGTERM', cleanup);
+      spinner.stop();
+      throw error;
+    }
+  }
+
+  static async executeWithProgress(command, options = {}) {
+    const { description = '执行命令', progressCallback } = options;
+
+    return new Promise((resolve, reject) => {
+      const child = shell.exec(command, {
+        silent: false,
+        fatal: false,
+        async: true
+      });
+
+      let output = '';
+
+      child.stdout?.on('data', (data) => {
+        output += data;
+        if (progressCallback) {
+          progressCallback(data.toString());
+        }
+      });
+
+      child.stderr?.on('data', (data) => {
+        output += data;
+        Logger.warn(`命令输出: ${data}`);
+      });
+
+      child.on('close', (code) => {
+        if (code === 0) {
+          Logger.success(`${description} 完成`);
+          resolve({ code, output });
+        } else {
+          Logger.error(`${description} 失败，退出码: ${code}`);
+          reject(new Error(`命令执行失败，退出码: ${code}`));
+        }
+      });
+
+      child.on('error', (error) => {
+        Logger.error(`${description} 出错: ${error.message}`);
+        reject(error);
+      });
+    });
+  }
+}
+

package/src/config.mjs

@@ -0,0 +1,52 @@
+import md5 from 'md5';
+import { v4 as uuidv4 } from 'uuid';
+import { CONSTANTS } from './constants.mjs';
+
+/**
+ * 项目初始化配置类
+ */
+export class ProjectConfig {
+  constructor() {
+    this.validators = {
+      appName: /^([a-z]+)(-[a-z0-9]+)*$/,
+      displayName: /^[\u4e00-\u9fa5a-zA-Z0-9]{2,4}$/
+    };
+
+    this.templates = {
+      [CONSTANTS.TEMPLATE_TYPES.APP_TEMPLATE]: {
+        name: 'app-template',
+        tempPath: '_apps_temp_'
+      },
+      [CONSTANTS.TEMPLATE_TYPES.GAME_TEMPLATE]: {
+        name: 'game-template',
+        tempPath: '_games_temp_'
+      }
+    };
+  }
+
+  validateAppName(name) {
+    return this.validators.appName.test(name);
+  }
+
+  validateDisplayName(name) {
+    return this.validators.displayName.test(name);
+  }
+
+  generateAppId() {
+    return md5(uuidv4({
+      random: [0x10, 0x91, 0x56, 0xbe, 0xc4, 0xfb, 0xc1, 0xea, 0x71, 0xb4, 0xef, 0xe1, 0x67, 0x1c, 0x58, 0x36]
+    }));
+  }
+
+  createProjectConfig(appName, displayName, appid) {
+    return {
+      type: 'app',
+      name: appName,
+      projectname: displayName,
+      appid: appid,
+      appUrlConfig: 'https://xxx.cos.ap-chengdu.myqcloud.com/assets/testMiniApps/htyanimation/app.json',
+      zipUrl: 'https://xxxxx.myqcloud.com/assets/testMiniApps/xxxxx/outputs/dist.dgz'
+    };
+  }
+}
+

package/src/constants.mjs

@@ -0,0 +1,54 @@
+import path from 'path';
+import { getProjectRoot } from './utils.mjs';
+
+const projectPath = getProjectRoot();
+
+/**
+ * CLI 工具常量定义
+ */
+export const CONSTANTS = {
+  SRC_DIR: path.join(projectPath, './src'),
+  TEMP_DIR: path.join(projectPath, './.htyf'),
+  MP_OUTPUT_DIR: path.join(projectPath, './dist'),
+  LOGS_DIR: path.join(projectPath, './.htyf/.logs'),
+  DEFAULT_VERSION_NAME: '1.0.0',
+  DEFAULT_VERSION_CODE: '1',
+  VERSION_NAME_REGEX: /^\d+(\.\d+){2}$/g,
+  VERSION_CODE_REGEX: /^\d+$/g,
+  WEBPACK_PORT: 8081,
+  BUNDLE_ENTRY_FILE: 'index.js',
+  BUNDLE_PLATFORM: 'ios',
+  MAX_RETRY_COUNT: 3,
+  DEFAULT_TIMEOUT: 30000,
+  TEMPLATE_REPOS: {
+    GITHUB: 'https://github.com/htyf-mp-community/htyf-mp.git',
+    CODING: 'https://e.coding.net/dagouzhi/hongtangyun_mobile/htyf-mp.git'
+  },
+  TEMPLATE_TYPES: {
+    APP_TEMPLATE: 'app-template',
+    GAME_TEMPLATE: 'game-template',
+  }
+};
+
+/**
+ * 操作类型枚举
+ */
+export const ACTION_TYPES = {
+  START: 'start',
+  INIT: 'init',
+  MP_BUILD: 'mp-build',
+  MP_DEBUG: 'mp-debug',
+  CLEAN: 'clean',
+  QUIT: 'quit'
+};
+
+/**
+ * 日志级别枚举
+ */
+export const LOG_LEVELS = {
+  DEBUG: 0,
+  INFO: 1,
+  WARN: 2,
+  ERROR: 3
+};
+

package/src/debug.mjs

@@ -0,0 +1,132 @@
+import path from 'path';
+import fse from 'fs-extra';
+import superstatic from 'superstatic';
+import portfinder from 'portfinder';
+import chalk from 'chalk';
+import boxen from 'boxen';
+import gradient from 'gradient-string';
+import { Logger } from './logger.mjs';
+import { ConfigValidator } from './validators.mjs';
+import { mpBuildShell } from './build.mjs';
+import { printQrcode } from './utils-functions.mjs';
+
+/**
+ * 小程序真机调试
+ * @param {object} newAppInfo - 应用信息
+ */
+export async function mpDebugShell(newAppInfo) {
+  try {
+    // 验证必需字段
+    if (!newAppInfo.entry) {
+      throw new Error('缺少必需的应用信息: entry');
+    }
+    
+    const zipPath = await mpBuildShell(newAppInfo);
+    const assetsPath = path.dirname(zipPath);
+    const appJsonPath = path.join(assetsPath, 'app.json');
+
+    Logger.info(`资源路径: ${assetsPath}`);
+    const applocaljson = fse.readJsonSync(appJsonPath);
+
+    // 验证网络配置
+    const networkValidation = await ConfigValidator.validateNetworkConfig();
+    if (!networkValidation.isValid) {
+      throw new Error(`网络配置验证失败: ${networkValidation.error}`);
+    }
+
+    const host = networkValidation.host;
+    const port = await portfinder.getPortPromise();
+
+    const app = superstatic.server({
+      port: port,
+      address: host,
+      cwd: assetsPath
+    });
+
+    const server = app.listen(function () {
+      const address = server.address();
+
+      const debugerAppUrlConfig = `http://${host}:${address.port}/app.json`;
+      const debugerZip = `http://${host}:${address.port}/dist.dgz`;
+      const args = {
+        ...applocaljson,
+        development: true,
+        "name": applocaljson.name,
+        "appid": applocaljson.appid,
+        "version": applocaljson.version,
+        appUrlConfig: debugerAppUrlConfig,
+        zipUrl: debugerZip,
+      };
+
+      fse.writeJSONSync(appJsonPath, {
+        ...fse.readJSONSync(appJsonPath),
+        appUrlConfig: debugerAppUrlConfig,
+        zipUrl: debugerZip,
+      });
+
+      const qrcodeUrl = `https://share.dagouzhi.com/#/pages/index/index?data=${encodeURIComponent(JSON.stringify(args))}`;
+
+      // 显示调试信息
+      console.log('\n');
+      console.log(boxen(
+        gradient.rainbow('小程序真机调试') + '\n\n' +
+        chalk.cyan('服务器地址: ') + chalk.white(`${host}:${address.port}`) + '\n' +
+        chalk.cyan('应用名称: ') + chalk.white(applocaljson.name) + '\n' +
+        chalk.cyan('应用ID: ') + chalk.white(applocaljson.appid) + '\n' +
+        chalk.cyan('版本: ') + chalk.white(applocaljson.version),
+        {
+          padding: 1,
+          margin: 1,
+          borderStyle: 'round',
+          borderColor: 'cyan'
+        }
+      ));
+
+      console.log('\n' + chalk.yellow('调试配置:'));
+      console.log(JSON.stringify(args, undefined, 2));
+
+      console.log('\n' + chalk.green('调试链接:'));
+      console.log(qrcodeUrl);
+
+      console.log('\n' + chalk.blue('二维码:'));
+      printQrcode(qrcodeUrl);
+
+      Logger.info('调试服务器已启动，按 Ctrl+C 停止');
+    });
+
+    // 优雅关闭 - 移除全局处理，添加专用的服务器关闭处理
+    const handleShutdown = () => {
+      Logger.info('\n正在关闭调试服务器...');
+      let isClosed = false;
+      
+      server.close(() => {
+        if (!isClosed) {
+          isClosed = true;
+          Logger.success('调试服务器已关闭');
+          process.exit(0);
+        }
+      });
+      
+      // 如果服务器在 3 秒内没有关闭，强制退出
+      setTimeout(() => {
+        if (!isClosed) {
+          isClosed = true;
+          Logger.warn('强制退出...');
+          process.exit(0);
+        }
+      }, 3000);
+    };
+
+    // 移除全局的信号处理，添加专用的服务器关闭处理
+    // 这样可以确保服务器能够正确关闭
+    process.removeAllListeners('SIGINT');
+    process.removeAllListeners('SIGTERM');
+    process.once('SIGINT', handleShutdown);
+    process.once('SIGTERM', handleShutdown);
+
+  } catch (error) {
+    Logger.error(`小程序调试失败: ${error.message}`);
+    process.exit(1);
+  }
+}
+