wxa-runner 0.10.0 → 0.11.0

package/README.md

@@ -1,6 +1,6 @@
 # wxa-runner
 
-在普通浏览器里，用**微信官方基础库**运行小程序。为本地调试和 E2E 自动化测试而生。
+在普通浏览器里，用**微信官方基础库**运行小程序。用于本地调试和 E2E 自动化测试。
 
 ```bash
 npx wxa-runner dev ./dist/dev/mp-weixin   # 原生小程序目录，或 uni-app / Taro 编译产物

package/bin/wxa-runner.js

@@ -84,6 +84,120 @@ program
     }
   });
 
+// 查看器：把小程序打成 .wxapack，不带源码在浏览器里运行。实现在 @open-wxa/wxa-viewer 里，执行时才加载：
+// wxa-runner 不依赖它，只用 dev 的人不会因此多装 esbuild-wasm 等依赖
+const viewer = program
+  .command('viewer')
+  .description('查看器：把小程序打成 .wxapack，不带源码在浏览器里运行（需要 @open-wxa/wxa-viewer）');
+
+viewer
+  .command('pack <project-path>')
+  .description('把小程序编译成 .wxapack 包')
+  .option('-o, --out <file>', '输出文件（默认在当前目录按 appid 或项目目录名命名）')
+  .option('-b, --baselib <version>', '基础库版本（默认使用本机已安装的最新兼容版本）')
+  .option('--setup <file>', '打进包里的 setup 文件（默认使用项目目录下的 wxa.setup.ts / .js / .mjs）')
+  .option('--no-setup', '不打包 setup 文件')
+  .action(async (projectPath, options) => {
+    try {
+      const fs = require('fs');
+      const { createPack } = loadViewer();
+      const resolvedProjectPath = path.resolve(projectPath);
+      const { bytes, manifest, warnings } = await createPack({
+        projectPath: resolvedProjectPath,
+        baseLibVersion: options.baselib,
+        setup: options.setup,
+        logger: { warn() {} }
+      });
+      const configFile = path.join(resolvedProjectPath, 'project.config.json');
+      const config = fs.existsSync(configFile) ? JSON.parse(fs.readFileSync(configFile, 'utf8')) : {};
+      const output = path.resolve(options.out || `${config.appid || path.basename(resolvedProjectPath)}.wxapack`);
+      fs.writeFileSync(output, bytes);
+
+      console.log('');
+      console.log(chalk.green('  wxapack 已生成'));
+      console.log(`  包路径    ${chalk.cyan(output)}`);
+      console.log(`  大小      ${(bytes.byteLength / 1024).toFixed(1)} KB（${bytes.byteLength} 字节）`);
+      console.log(`  页面      ${manifest.build.pages.length}`);
+      console.log(`  基础库    ${manifest.baseLib.version}`);
+      warnings.forEach(warning => console.warn(chalk.yellow(`  警告      ${warning}`)));
+      console.log('');
+    } catch (error) {
+      console.error(chalk.red('\n打包失败：'), error.message);
+      process.exit(1);
+    }
+  });
+
+viewer
+  .command('preview [packs...]')
+  .description('在本机打开查看器，打开时自动导入传入的包')
+  .option('-p, --port <port>', '端口号（默认 3000，被占用时换用后面空闲的端口）')
+  .option('--host [host]', '监听地址，不带值时监听所有地址，局域网也能访问', 'localhost')
+  .option('-b, --baselib <version>', '基础库版本（默认使用本机已安装的最新兼容版本）')
+  .option('-o, --open', '启动后打开浏览器')
+  .action(async (packs, options) => {
+    try {
+      const { ViewerServer } = loadViewer();
+      const server = new ViewerServer({
+        packs: packs.map(file => path.resolve(file)),
+        port: options.port === undefined ? undefined : parseInt(options.port, 10),
+        host: options.host === true ? '0.0.0.0' : options.host,
+        baseLibVersion: options.baselib
+      });
+      const url = await server.start();
+      console.log('');
+      console.log(chalk.green('  查看器已启动'));
+      console.log(`  地址      ${chalk.cyan(url)}`);
+      const networkUrls = server.networkUrls;
+      if (!networkUrls.length) console.log(`  局域网    ${chalk.gray('加 --host 开放局域网访问')}`);
+      networkUrls.forEach((networkUrl, i) => console.log(`  ${i === 0 ? '局域网' : '      '}    ${chalk.cyan(networkUrl)}`));
+      console.log(`  基础库    ${server.baseLib.version}${server.baseLib.source === 'bundled' ? '（内置）' : ''}`);
+      console.log('');
+      if (options.open) openBrowser(url);
+      const shutdown = () => server.close().then(() => process.exit(0));
+      process.on('SIGINT', shutdown);
+      process.on('SIGTERM', shutdown);
+    } catch (error) {
+      console.error(chalk.red('\n启动失败：'), error.message);
+      process.exit(1);
+    }
+  });
+
+viewer
+  .command('export <out-dir>')
+  .description('导出查看器：纯静态站点 site/，和转发 wx.request 的处理函数 proxy.mjs')
+  .option('-b, --baselib <version>', '基础库版本（默认使用本机已安装的最新兼容版本）')
+  .option('--force', '输出目录不为空时也写入，覆盖之前导出的文件')
+  .option('--pack <file>', '默认包，可以写多次：浏览器里还没有项目时自动导入', (file, packs) => packs.concat(file), [])
+  .action(async (outDir, options) => {
+    try {
+      const { exportViewer } = loadViewer();
+      const output = exportViewer(outDir, { baseLibVersion: options.baselib, force: options.force, packs: options.pack });
+      console.log('');
+      console.log(chalk.green('  查看器已导出'));
+      console.log(`  静态站点  ${chalk.cyan(path.join(output, 'site'))}`);
+      options.pack.forEach((file, i) => console.log(`  ${i === 0 ? '默认包' : '      '}    ${path.basename(file)}`));
+      console.log(`  请求转发  ${chalk.cyan(path.join(output, 'proxy.mjs'))}`);
+      console.log('  下一步    把 site/ 交给任意静态托管；要转发 wx.request 时，把 /__wxa__/proxy/ 开头的请求交给 proxy.mjs');
+      console.log('');
+    } catch (error) {
+      console.error(chalk.red('\n导出失败：'), error.message);
+      process.exit(1);
+    }
+  });
+
+/** @throws 没装 @open-wxa/wxa-viewer 时，消息里说明怎么装 */
+function loadViewer() {
+  try {
+    return require('@open-wxa/wxa-viewer');
+  } catch (error) {
+    // 只处理查看器本身找不到；它内部依赖缺失等别的错误照常抛出
+    if (error.code === 'MODULE_NOT_FOUND' && error.message.includes("'@open-wxa/wxa-viewer'")) {
+      throw new Error('查看器命令需要 @open-wxa/wxa-viewer，请先安装：npm i -D @open-wxa/wxa-viewer');
+    }
+    throw error;
+  }
+}
+
 const baselib = program.command('baselib').description('管理官方基础库');
 
 baselib

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wxa-runner",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Run WeChat Mini Programs in the browser on the official base library, for debugging and E2E testing",
   "keywords": [
     "wechat",
@@ -36,8 +36,11 @@
     "@vercel/detect-agent": "^1.2.7",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
-    "@open-wxa/wxa-runner-extractor": "0.10.0",
-    "@open-wxa/wxa-runner-core": "0.10.0"
+    "@open-wxa/wxa-runner-core": "0.11.0",
+    "@open-wxa/wxa-runner-extractor": "0.11.0"
+  },
+  "devDependencies": {
+    "@open-wxa/wxa-viewer": "0.10.0"
   },
   "engines": {
     "node": ">=18"