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

package/src/command-executor.mjs

@@ -0,0 +1,107 @@
+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();
+
+    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) {
+          spinner.succeed(`${description} 成功`);
+          Logger.debug(`命令输出: ${result.stdout}`);
+          return result;
+        } else {
+          throw new Error(`命令执行失败，退出码: ${result.code}, 错误: ${result.stderr}`);
+        }
+      } catch (error) {
+        if (attempt === retryCount) {
+          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)); // 递增延迟
+        }
+      }
+    }
+  }
+
+  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,55 @@
+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.EXPO]: {
+        name: 'Expo (https://docs.expo.dev/)',
+        tempPath: 'mini-apps-template',
+        files: {
+          src: 'expo_src',
+          app: 'expo.App.tsx',
+          index: 'expo.index.js',
+          babel: 'expo.babel.config.js',
+          config: 'expo.project.dgz.json'
+        }
+      },
+    };
+  }
+
+  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,55 @@
+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: {
+    EXPO: 'expo',
+    TARO: 'taro',
+    GAME_COCOS: 'game-cocos',
+  }
+};
+
+/**
+ * 操作类型枚举
+ */
+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,111 @@
+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 停止');
+    });
+
+    // 优雅关闭
+    process.on('SIGINT', () => {
+      Logger.info('正在关闭调试服务器...');
+      server.close(() => {
+        Logger.success('调试服务器已关闭');
+        process.exit(0);
+      });
+    });
+
+  } catch (error) {
+    Logger.error(`小程序调试失败: ${error.message}`);
+    process.exit(1);
+  }
+}
+

package/src/file-system.mjs

@@ -0,0 +1,96 @@
+import fs from 'fs';
+import path from 'path';
+import fse from 'fs-extra';
+import { Logger } from './logger.mjs';
+
+/**
+ * 文件系统工具类
+ */
+export class FileSystemUtils {
+  static ensureDirectory(dirPath) {
+    try {
+      fse.ensureDirSync(dirPath);
+      Logger.debug(`目录已确保存在: ${dirPath}`);
+      return true;
+    } catch (error) {
+      Logger.error(`创建目录失败: ${dirPath}`, error.message);
+      return false;
+    }
+  }
+
+  static cleanDirectory(dirPath) {
+    try {
+      if (fs.existsSync(dirPath)) {
+        fse.removeSync(dirPath);
+        Logger.info(`目录已清理: ${dirPath}`);
+      }
+      return true;
+    } catch (error) {
+      Logger.error(`清理目录失败: ${dirPath}`, error.message);
+      return false;
+    }
+  }
+
+  static backupFile(filePath) {
+    try {
+      if (fs.existsSync(filePath)) {
+        const backupPath = `${filePath}.backup.${Date.now()}`;
+        fse.copySync(filePath, backupPath);
+        Logger.info(`文件已备份: ${backupPath}`);
+        return backupPath;
+      }
+      return null;
+    } catch (error) {
+      Logger.error(`备份文件失败: ${filePath}`, error.message);
+      return null;
+    }
+  }
+
+  static getFileSize(filePath) {
+    try {
+      const stats = fs.statSync(filePath);
+      return stats.size;
+    } catch (error) {
+      return 0;
+    }
+  }
+
+  static formatFileSize(bytes) {
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    if (bytes === 0) return '0 Bytes';
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return Math.round(bytes / Math.pow(1024, i) * 100) / 100 + ' ' + sizes[i];
+  }
+
+  static validatePath(path) {
+    // if (/[ -	fa5]/gi.test(path)) {
+    //   return { isValid: false, error: '路径中包含中文字符' };
+    // }
+    return { isValid: true };
+  }
+
+  /**
+   * 计算目录大小
+   * @param {string} dirPath - 目录路径
+   * @returns {number} 目录大小（字节）
+   */
+  static calculateDirectorySize(dirPath) {
+    if (!fs.existsSync(dirPath)) return 0;
+    let size = 0;
+    try {
+      const items = fse.readdirSync(dirPath, { withFileTypes: true });
+      for (const item of items) {
+        const itemPath = path.join(dirPath, item.name);
+        if (item.isDirectory()) {
+          size += this.calculateDirectorySize(itemPath);
+        } else {
+          size += fs.statSync(itemPath).size;
+        }
+      }
+    } catch (error) {
+      Logger.warn(`计算目录大小失败: ${dirPath}`, error.message);
+    }
+    return size;
+  }
+}
+

package/src/index.mjs

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+
+/**
+ * React Native 应用 CLI 工具
+ * 用于管理多应用项目的开发、构建和部署
+ *
+ * @author CLI Team
+ * @version 2.2.0
+ */
+
+import inquirer from 'inquirer';
+import path from 'path';
+import lodash from 'lodash';
+import fse from 'fs-extra';
+import chalk from 'chalk';
+import boxen from 'boxen';
+import gradient from 'gradient-string';
+import { confirm } from '@inquirer/prompts';
+import { getProjectRoot } from './utils.mjs';
+import { Logger, setLogLevel } from './logger.mjs';
+import { CONSTANTS, ACTION_TYPES, LOG_LEVELS } from './constants.mjs';
+import { ProjectInitializer } from './project-initializer.mjs';
+import { mpBuildShell } from './build.mjs';
+import { mpDebugShell } from './debug.mjs';
+import { cleanShell } from './clean.mjs';
+import { incrementVersion, updateAppConfig } from './utils-functions.mjs';
+
+const projectPath = getProjectRoot();
+
+/**
+ * 主启动函数
+ * @param {string} action - 操作类型
+ */
+async function Start(action) {
+  const actionNames = {
+    [ACTION_TYPES.MP_BUILD]: '小程序构建',
+    [ACTION_TYPES.MP_DEBUG]: '小程序调试',
+    [ACTION_TYPES.CLEAN]: '清理模式',
+    [ACTION_TYPES.QUIT]: '退出'
+  };
+
+  Logger.info(`当前操作: ${actionNames[action] || '未知操作'}`);
+
+  if (action === ACTION_TYPES.QUIT) {
+    Logger.info('再见!');
+    return;
+  }
+
+  if (action === ACTION_TYPES.CLEAN) {
+    const { cleanType } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'cleanType',
+        message: '请选择清理类型：',
+        choices: [
+          { name: '🧹 清理所有临时文件', value: 'all' },
+          { name: '📁 清理构建输出', value: 'build' },
+          { name: '🗂️  清理临时目录', value: 'temp' },
+          { name: '📝 清理日志文件', value: 'logs' },
+          { name: '💾 清理缓存文件', value: 'cache' },
+          { name: '❌ 取消', value: 'cancel' }
+        ]
+      }
+    ]);
+
+    if (cleanType === 'cancel') {
+      Logger.info('已取消清理操作');
+      return;
+    }
+
+    const getCleanTypeName = (type) => {
+      switch (type) {
+        case 'all': return '所有';
+        case 'build': return '构建输出';
+        case 'temp': return '临时';
+        case 'logs': return '日志';
+        case 'cache': return '缓存';
+        default: return type;
+      }
+    };
+
+    const confirmClean = await confirm({
+      message: `确定要清理${getCleanTypeName(cleanType)}文件吗？`,
+      default: false
+    });
+
+    if (confirmClean) {
+      await cleanShell(cleanType);
+    } else {
+      Logger.info('已取消清理操作');
+    }
+    return;
+  }
+
+  // 显示应用选择界面
+  try {
+    const appInfo = fse.readJsonSync(path.join(projectPath, 'app.json')).htyf;
+    if (!appInfo) {
+      Logger.error('应用配置不存在，请先在app.json中配置htyf');
+      return;
+    }
+    
+    const version = appInfo?.version;
+    const incrementedVersion = version ? incrementVersion(version) : '1.0.0';
+    const { versionName } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'versionName',
+        message: '请输入应用版本名称 (格式: x.y.z):',
+        default: incrementedVersion,
+        validate: (input) => {
+          const _ipt = input || incrementedVersion;
+          return (!!_ipt && /^\d+(\.\d+){2}$/g.test(_ipt)) || '请输入正确的版本名称格式 (x.y.z)';
+        }
+      },
+    ]);
+
+    Logger.info(`用户选择:`);
+    Logger.info(`版本名称: ${versionName}`);
+
+    const newAppInfo = lodash.merge({}, appInfo, {
+      version: versionName,
+    });
+
+    if (!updateAppConfig(newAppInfo)) {
+      return;
+    }
+
+    // 显示操作信息
+    console.log('\n' + boxen(
+      chalk.cyan('应用信息') + '\n\n' +
+      chalk.white('名称: ') + chalk.yellow(`${newAppInfo.name}`) + '\n' +
+      chalk.white('版本: ') + chalk.yellow(`${newAppInfo.version}`),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'yellow'
+      }
+    ));
+
+    Logger.info('执行初始化...');
+
+    switch (action) {
+      case ACTION_TYPES.MP_BUILD:
+        await mpBuildShell(newAppInfo);
+        break;
+      case ACTION_TYPES.MP_DEBUG:
+        await mpDebugShell(newAppInfo);
+        break;
+      default:
+        Logger.error(`未知的操作类型: ${action}`);
+    }
+
+  } catch (error) {
+    Logger.error(`操作失败: ${error.message}`);
+    Logger.error(`错误详情: ${error.stack}`);
+  }
+}
+
+// 主程序入口
+console.log('\n' + boxen(
+  gradient.rainbow('🎯 红糖云服 应用 CLI 工具 v2.2.0') + '\n' +
+  chalk.gray('用于管理多应用项目的开发、构建和部署') + '\n' +
+  chalk.gray(`项目目录:`) + '\n\n' +
+  chalk.gray(`${projectPath}`) + '\n',
+  {
+    padding: 1,
+    margin: 1,
+    borderStyle: 'round',
+    borderColor: 'cyan'
+  }
+));
+
+// 设置日志级别
+if (process.argv.includes('--debug')) {
+  setLogLevel(LOG_LEVELS.DEBUG);
+  Logger.debug('调试模式已启用');
+}
+
+// 记录启动日志
+Logger.writeToFile('CLI 工具启动', 'INFO');
+
+// 处理命令行清理参数
+if (process.argv.includes('--clean')) {
+  const cleanIndex = process.argv.indexOf('--clean');
+  const cleanType = process.argv[cleanIndex + 1] || 'all';
+  
+  if (['all', 'build', 'temp', 'logs', 'cache'].includes(cleanType)) {
+    Logger.info(`执行命令行清理: ${cleanType}`);
+    await cleanShell(cleanType);
+    process.exit(0);
+  } else {
+    Logger.error(`无效的清理类型: ${cleanType}`);
+    Logger.error('支持的清理类型: all, build, temp, logs, cache');
+    process.exit(1);
+  }
+}
+
+// 显示帮助信息
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log('\n' + boxen(
+    chalk.cyan('CLI 工具使用说明') + '\n\n' +
+    chalk.white('基本用法:') + '\n' +
+    chalk.gray('  node index.mjs                    # 启动交互式界面') + '\n' +
+    chalk.gray('  node index.mjs --debug           # 启用调试模式') + '\n' +
+    chalk.gray('  node index.mjs --help            # 显示帮助信息') + '\n\n' +
+    chalk.white('清理命令:') + '\n' +
+    chalk.gray('  node index.mjs --clean all       # 清理所有临时文件') + '\n' +
+    chalk.gray('  node index.mjs --clean build     # 清理构建输出') + '\n' +
+    chalk.gray('  node index.mjs --clean temp      # 清理临时目录') + '\n' +
+    chalk.gray('  node index.mjs --clean logs      # 清理日志文件') + '\n' +
+    chalk.gray('  node index.mjs --clean cache     # 清理缓存文件') + '\n\n' +
+    chalk.white('功能说明:') + '\n' +
+    chalk.gray('  🆕 初始化新小程序项目 - 创建新的小程序项目') + '\n' +
+    chalk.gray('  🔍 小程序打包 - 构建小程序包') + '\n' +
+    chalk.gray('  📦 小程序调试 - 启动真机调试服务') + '\n' +
+    chalk.gray('  🧹 清理模式 - 清理临时文件') + '\n',
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'round',
+      borderColor: 'blue'
+    }
+  ));
+  process.exit(0);
+}
+
+inquirer
+  .prompt([
+    {
+      type: 'rawlist',
+      name: 'index',
+      message: '请选择你想要执行的操作：',
+      choices: [
+        { name: '🆕 初始化新小程序项目', value: ACTION_TYPES.INIT },
+        { name: '🔍 小程序 - 打包小程序', value: ACTION_TYPES.MP_BUILD },
+        { name: '📦 小程序 - 真机调试', value: ACTION_TYPES.MP_DEBUG },
+        { name: '🧹 清理模式 - 清理临时文件', value: ACTION_TYPES.CLEAN },
+        { name: '👋 退出', value: ACTION_TYPES.QUIT },
+      ],
+    },
+  ])
+  .then(async ({ index }) => {
+    if (index === ACTION_TYPES.INIT) {
+      const initializer = new ProjectInitializer();
+      await initializer.initialize();
+    } else {
+      await Start(index);
+    }
+  })
+  .catch((error) => {
+    Logger.error(`程序启动失败: ${error.message}`);
+    process.exit(1);
+  });