Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
feat(install): 安装失败原因中文化 + ARM 兼容性诊断
RoutineMikua7c6a2dfdc7b
diff --git a/src/core/adb.js b/src/core/adb.jsindex 652a233..b88ea10 100644--- a/src/core/adb.js+++ b/src/core/adb.js@@ -16,6 +16,38 @@ const COMMON_ADB_PATHS = ['C:\\Program Files\\BlueStacks_nxt\\HD-Adb.exe',];+/**+ * 把 pm install 的原始失败原因翻译成用户能看懂的中文。+ * 保留原始错误码在末尾,便于搜索排查。+ */+function friendlyInstallError(raw) {+ const code = /INSTALL_[A-Z_]+/.exec(raw);+ const tag = code ? code[0] : '';+ const table = {+ INSTALL_FAILED_NO_MATCHING_ABIS:+ '安装失败:这个应用只提供 ARM 原生库(多数国产应用如此),'+ + '而当前运行时是 x86_64 架构且未启用 ARM 转译,系统拒绝安装。'+ + '可在「运行时」设置里切换到内置 ARM 翻译的 Google Play 兼容镜像后重试。',+ INSTALL_FAILED_OLDER_SDK:+ '安装失败:应用要求的 Android 版本高于当前运行时(需更高系统镜像)。',+ INSTALL_PARSE_FAILED_NO_CERTIFICATES:+ '安装失败:APK 没有有效签名,无法安装。',+ INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES:+ '安装失败:与已安装版本签名不一致,请先卸载旧版再装。',+ INSTALL_FAILED_VERSION_DOWNGRADE:+ '安装失败:设备上已安装更高版本,不能降级覆盖。',+ INSTALL_FAILED_INSUFFICIENT_STORAGE:+ '安装失败:运行时磁盘空间不足,请清理后重试。',+ INSTALL_FAILED_INVALID_APK:+ '安装失败:APK 文件损坏或不完整(可能下载未完成),请重新获取。',+ INSTALL_FAILED_INVALID_URI: '安装失败:APK 路径含特殊字符,请把文件移到纯英文路径后重试。',+ INSTALL_FAILED_ALREADY_EXISTS: '安装失败:已存在同名应用且签名不同,请先卸载。',+ INSTALL_FAILED_UPDATE_INCOMPATIBLE: '安装失败:与已安装版本签名不一致,请先卸载旧版。',+ };+ const msg = table[tag];+ return msg ? `${msg}(${tag})` : `安装失败:${raw}`;+}+class AdbError extends Error {constructor(message, stderr, code) {super(message);@@ -138,7 +170,7 @@ class AdbClient {if (!fs.existsSync(apkPath)) throw new Error(`APK 不存在: ${apkPath}`);const { stdout } = await this.exec(['install', '-r', '-g', '-t', apkPath], { timeout: 180000 });if (/Failure|Error/i.test(stdout) && !/Success/i.test(stdout)) {- throw new Error(stdout.trim());+ throw new Error(friendlyInstallError(stdout.trim()));}return stdout.trim();}@@ -304,4 +336,4 @@ class AdbClient {}}-module.exports = { AdbClient, AdbError, parseStatList };+module.exports = { AdbClient, AdbError, parseStatList, friendlyInstallError };diff --git a/test/engine-test.js b/test/engine-test.jsindex 872a2c3..e189eb7 100644--- a/test/engine-test.js+++ b/test/engine-test.js@@ -229,6 +229,18 @@ function assert(cond, msg) { if (!cond) throw new Error(msg || '断言失败');assert(/^image\.sysdir\.1=system-images\//m.test(cfg), 'image.sysdir.1 缺失');});+ await test('安装失败原因翻译:NO_MATCHING_ABIS 给出中文指引', async () => {+ const { friendlyInstallError } = require('../src/core/adb');+ const out = friendlyInstallError(+ 'Performing Streamed Install\nadb.exe: failed to install x.apk: '+ + 'Failure [INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries, res=-113]',+ );+ assert(out.includes('ARM 原生库'), `应解释 ARM 原生库问题:${out}`);+ assert(out.includes('INSTALL_FAILED_NO_MATCHING_ABIS'), '应保留原始错误码');+ const other = friendlyInstallError('Failure [INSTALL_FAILED_INVALID_APK: x]');+ assert(other.includes('损坏') || other.includes('不完整'), `未知错误也应可读:${other}`);+ });+await test('镜像校验:区分有效 ISO9660 / 损坏 / 未下完', async () => {const p = new Provisioner(TMP);const mk = (file, size, writeMagic) => {