wxa-runner 0.6.0 → 0.8.0

package/bin/wxa-runner.js

@@ -1,6 +1,13 @@
 #!/usr/bin/env node
 
-const { Command } = require('commander');
+// 先于加载依赖检查：npm / npx 对 engines 只警告，低版本照样能启动，到用 fetch 等时才报看不懂的错
+const requiredNode = Number(/\d+/.exec(require('../package.json').engines.node)[0]);
+if (Number(process.versions.node.split('.')[0]) < requiredNode) {
+  console.error(`wxa-runner 需要 Node.js ${requiredNode} 及以上，当前是 ${process.versions.node}。请先切换 Node.js 版本，如 nvm use 22`);
+  process.exit(1);
+}
+
+const { Command, Option } = require('commander');
 const chalk = require('chalk');
 const path = require('path');
 const { spawn } = require('child_process');
@@ -15,32 +22,45 @@ program
 program
   .command('dev <project-path>')
   .description('启动开发服务器')
-  .option('-p, --port <port>', '端口号', '3000')
-  .option('--host <host>', '监听地址', 'localhost')
+  .option('-p, --port <port>', '端口号（默认 3000，被占用时换用后面空闲的端口）')
+  .option('--host [host]', '监听地址，不带值时监听所有地址，局域网也能访问', 'localhost')
   .option('-b, --baselib <version>', '基础库版本（默认使用本机已安装的最新兼容版本）')
   .option('--setup <file>', '小程序启动前执行的 setup 文件（默认使用项目目录下的 wxa.setup.ts / .js / .mjs）')
   .option('--no-setup', '不执行 setup 文件')
   .option('--no-watch', '不监听文件变化')
   .option('-o, --open', '启动后打开浏览器')
-  .option('--real-login', '使用本机微信开发者工具登录态获取真实 code 和手机号')
+  .option('--forward-console', '浏览器里的 console.warn / console.error 也转发到终端（检测到编程助手时默认开启）')
+  .option('--no-forward-console', '浏览器里的报错不转发到终端')
+  .option('--devtools-login', '借本机微信开发者工具的登录态访问微信后台：真实的 code 和手机号、服务市场、插件')
+  // 旧名，开发服务器会提示改用 --devtools-login
+  .addOption(new Option('--real-login').hideHelp())
   .action(async (projectPath, options) => {
     const { DevServer } = require('@open-wxa/wxa-runner-core');
 
     try {
+      const forward = await resolveForwardConsole(options.forwardConsole);
       const server = new DevServer({
         projectPath: path.resolve(process.cwd(), projectPath),
-        port: parseInt(options.port, 10),
-        host: options.host,
+        port: options.port === undefined ? undefined : parseInt(options.port, 10),
+        host: options.host === true ? '0.0.0.0' : options.host,
         baseLibVersion: options.baselib,
         setup: options.setup,
         watch: options.watch,
-        realLogin: options.realLogin
+        devtoolsLogin: options.devtoolsLogin,
+        realLogin: options.realLogin,
+        forwardConsole: forward.mode
       });
       const url = await server.start();
 
       console.log('');
       console.log(chalk.green('  wxa-runner 已启动'));
       console.log(`  地址      ${chalk.cyan(url)}`);
+      const networkUrls = server.networkUrls;
+      if (networkUrls.length === 0) {
+        console.log(`  局域网    ${chalk.gray('加 --host 开放局域网访问')}`);
+      }
+      networkUrls.forEach((networkUrl, i) => console.log(`  ${i === 0 ? '局域网' : '      '}    ${chalk.cyan(networkUrl)}`));
+      console.log(`  控制台    ${describeForwardConsole(forward)}`);
       console.log(`  项目      ${server.project.root}`);
       console.log(`  基础库    ${server.baseLib.version}${server.baseLib.source === 'bundled' ? '（内置）' : ''}`);
       if (server.setupFile) console.log(`  setup     ${server.setupFile}`);
@@ -91,6 +111,24 @@ baselib
     }
   });
 
+/**
+ * 没指定 --forward-console / --no-forward-console 时：编程助手自己启动开发服务器时只看得到终端，
+ * console.warn / console.error 也转发；人在自己的终端里启动时用浏览器的开发者工具看，只转发报错
+ */
+async function resolveForwardConsole(option) {
+  if (option === false) return { mode: false };
+  if (option === true) return { mode: 'all' };
+  const { determineAgent } = require('@vercel/detect-agent');
+  const { isAgent, agent } = await determineAgent();
+  return isAgent ? { mode: 'all', agent: agent.name } : { mode: 'errors' };
+}
+
+function describeForwardConsole({ mode, agent }) {
+  if (!mode) return chalk.gray('不转发浏览器里的报错');
+  if (mode === 'errors') return `转发报错到终端${chalk.gray('，加 --forward-console 再转发 console.warn / console.error')}`;
+  return `转发报错和 console.warn / console.error 到终端${agent ? chalk.gray(`（检测到编程助手 ${agent}）`) : ''}`;
+}
+
 function openBrowser(url) {
   const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
   const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];

package/package.json

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