HBuilderX uni-app 微信小程序打包部署指南

// 自动轮询检查 app.json 是否生成
await waitForBuild(projectPath, 60); // 最多等待 60 秒

const CONFIG = {
  outputDir: "unpackage/dist/build/mp-weixin", // 修改此处
};

/**
 * 微信小程序一键构建+上传脚本
 *
 * 功能：
 *   1. 自动执行 HBuilderX 构建（npm run hbx:build-weixin）
 *   2. 等待构建完成
 *   3. 上传到微信服务器
 *
 * 使用方法:
 *   npm run upload:weixin                              # 默认上传
 *   npm run upload:weixin -- --version=1.0.1           # 指定版本号
 *   npm run upload:weixin -- --desc="修复bug"          # 指定版本描述
 *   npm run upload:weixin -- --robot=2                 # 指定机器人编号（1-30）
 *
 * 版本号策略: 命令行参数 > package.json version > 1.0.0
 * 描述策略:   命令行参数 > Git 最新 commit > 默认时间戳
 */

import { execSync } from "node:child_process";
import fs from "node:fs";
import path from "node:path";
import process from "node:process";
import { fileURLToPath } from "node:url";
import ci from "miniprogram-ci";

// ==================== 配置区域 ====================
const CONFIG = {
  // 微信小程序 AppID
  appid: "wxbf93238977b19c01",
  // 私钥文件名（相对于项目根目录）
  privateKeyFile: "private.wxbf93238977b19c01.key",
  // 构建输出目录（相对于项目根目录）
  outputDir: "unpackage/dist/build/mp-weixin",
  // 默认机器人编号
  defaultRobot: 1,
};
// ==============================================================

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const ROOT_DIR = path.resolve(__dirname, "..");

// 从 package.json 读取版本号
function getPackageVersion() {
  try {
    const pkgPath = path.resolve(ROOT_DIR, "package.json");
    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
    return pkg.version || "1.0.0";
  } catch {
    return "1.0.0";
  }
}

// 获取最新的 Git commit 信息
function getGitCommitMessage() {
  try {
    const message = execSync('git log -1 --pretty="%an: %s"', {
      cwd: ROOT_DIR,
      encoding: "utf-8",
    }).trim();
    return message || null;
  } catch {
    return null;
  }
}

// 生成默认描述
function getDefaultDesc() {
  const gitMessage = getGitCommitMessage();
  if (gitMessage) {
    return gitMessage;
  }
  return `上传于 ${new Date().toLocaleString("zh-CN")}`;
}

// 解析命令行参数
function parseArgs() {
  const args = process.argv.slice(2);
  const params = {
    version: null,
    desc: null,
    robot: CONFIG.defaultRobot,
  };

  args.forEach((arg) => {
    if (arg.startsWith("--version=")) {
      params.version = arg.split("=")[1];
    } else if (arg.startsWith("--desc=")) {
      params.desc = arg.split("=")[1];
    } else if (arg.startsWith("--robot=")) {
      params.robot = Number.parseInt(arg.split("=")[1], 10);
    }
  });

  // 如果命令行没有指定版本号，则从 package.json 读取
  if (!params.version) {
    params.version = getPackageVersion();
  }

  // 如果命令行没有指定描述，则使用默认
  if (!params.desc) {
    params.desc = getDefaultDesc();
  }

  return params;
}

// 执行 HBuilderX 构建
function buildProject() {
  console.log("\n📦 开始构建微信小程序...\n");

  try {
    execSync("npm run hbx:build-weixin", {
      cwd: ROOT_DIR,
      stdio: "inherit",
    });
    console.log("\n✅ HBuilderX 构建命令执行完成\n");
  } catch (error) {
    console.error("\n❌ 构建失败:", error.message);
    throw new Error("HBuilderX 构建失败");
  }
}

// 等待构建完成（检查 app.json 是否存在）
async function waitForBuild(projectPath, maxWaitSeconds = 60) {
  const appJsonPath = path.resolve(projectPath, "app.json");
  const startTime = Date.now();
  const checkInterval = 1000; // 每秒检查一次

  console.log("\n⏳ 等待 HBuilderX 构建完成...\n");

  while (true) {
    if (fs.existsSync(appJsonPath)) {
      console.log("✅ 构建产物已就绪\n");
      return true;
    }

    const elapsedSeconds = Math.floor((Date.now() - startTime) / 1000);
    if (elapsedSeconds >= maxWaitSeconds) {
      console.log(`❌ 等待超时（${maxWaitSeconds}秒），构建可能失败\n`);
      return false;
    }

    process.stdout.write(`\r  等待中... ${elapsedSeconds}/${maxWaitSeconds}s`);
    await new Promise((resolve) => setTimeout(resolve, checkInterval));
  }
}

// 主函数
async function main() {
  console.log("\n🚀 开始微信小程序上传流程...\n");

  const params = parseArgs();
  const privateKeyPath = path.resolve(ROOT_DIR, CONFIG.privateKeyFile);
  const projectPath = path.resolve(ROOT_DIR, CONFIG.outputDir);

  // 检查私钥文件
  if (!fs.existsSync(privateKeyPath)) {
    throw new Error(`私钥文件不存在: ${privateKeyPath}`);
  }

  // 执行 HBuilderX 构建
  buildProject();

  // 等待构建完成（app.json 生成）
  const buildReady = await waitForBuild(projectPath);
  if (!buildReady) {
    throw new Error("构建未完成，无法上传");
  }

  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
  console.log(`  📱 AppID: ${CONFIG.appid}`);
  console.log(`  📌 版本号: ${params.version}`);
  console.log(`  📝 描述: ${params.desc}`);
  console.log(`  🤖 机器人: ${params.robot}`);
  console.log(`  🔑 私钥: ${CONFIG.privateKeyFile}`);
  console.log(`  📂 项目: ${CONFIG.outputDir}`);
  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");

  console.log("\n⬆️ 正在上传到微信服务器...\n");

  const project = new ci.Project({
    appid: CONFIG.appid,
    type: "miniProgram",
    projectPath,
    privateKeyPath,
    ignores: ["node_modules/**/*"],
  });

  try {
    const uploadResult = await ci.upload({
      project,
      version: params.version,
      desc: params.desc,
      robot: params.robot,
      setting: {
        es6: true,
        es7: true,
        minify: true,
        autoPrefixWXSS: true,
        minifyWXML: true,
        minifyWXSS: true,
        minifyJS: true,
      },
      onProgressUpdate: (task) => {
        if (task._status === "done") {
          console.log(`  ✅ ${task._msg}`);
        }
      },
    });

    console.log("\n✅ 上传成功!");
    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
    console.log(`  📌 版本号: ${params.version}`);
    console.log(`  📝 描述: ${params.desc}`);
    console.log(`  🤖 机器人: ${params.robot}`);
    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
    console.log("\n📋 下一步操作:");
    console.log("  1. 登录微信公众平台: https://mp.weixin.qq.com");
    console.log('  2. 进入 "管理 -> 版本管理"');
    console.log('  3. 在 "开发版本" 中找到刚上传的版本');
    console.log('  4. 点击 "选为体验版" 按钮\n');

    return uploadResult;
  } catch (error) {
    console.error("\n❌ 上传失败:", error.message);
    if (
      error.message.includes("privateKeyPath") ||
      error.message.includes("access_token")
    ) {
      console.log("\n💡 提示: 请确保已在微信公众平台配置代码上传密钥");
      console.log("   1. 登录微信公众平台");
      console.log('   2. 进入 "开发 -> 开发设置"');
      console.log('   3. 在 "小程序代码上传" 区域生成并下载密钥');
      console.log('   4. 在 "小程序代码上传" 区域配置上传IP白名单');
    }
    process.exit(1);
  }
}

main().catch((error) => {
  console.error("❌ 执行出错:", error);
  process.exit(1);
});