Skip to content

Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时

feat(install): 安装失败原因中文化 + ARM 兼容性诊断

RoutineMikua7c6a2dfdc7b
diff --git a/src/core/adb.js b/src/core/adb.js
index 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.js
index 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) => {