Skip to content

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

fix(network): 修复红果点「同意并继续」后黑屏,真因是虚拟机没网而非渲染

RoutineMikuf10707612b33
diff --git a/.github/release-notes-v0.3.6.md b/.github/release-notes-v0.3.6.md
new file mode 100644
index 0000000..60de411
--- /dev/null
+++ b/.github/release-notes-v0.3.6.md
@@ -0,0 +1,61 @@
+# ApkStart v0.3.6
+
+> 一句话:**修好了「红果点『同意并继续』后一直黑屏」**。真因是安卓虚拟机的 Wi-Fi 迟迟连不上、应用在没网时就加载首页,页面上只剩一块黑底 —— 和显卡、渲染后端无关。
+
+## 一、红果点「同意」后黑屏 —— 真因与修复
+
+### 上一版的误判
+
+v0.3.5 把黑屏归因到 GPU 后端(swangle / software),是**错的**。换后端当然没用。
+
+### 这次实测定位到的真因
+
+用 adb 逐层查下来:
+
+- `cmd wifi status`:`Wifi is not connected`;`ip -o addr show wlan0`:**没有任何 IP**;
+- 也就是说**虚拟机当时没有网络**;
+- 红果的隐私弹窗是本地页面,所以正常显示;点「同意并继续」之后要拉首页数据,
+ 拿不到数据就渲染成一整块黑底 —— 用户看到的就是「点同意后黑屏」;
+- 而 `sys.boot_completed` 只代表系统起来了,**Wi-Fi 关联 + DHCP 往往还要再等几十秒到两分多钟**。
+ 应用启动得比网络就绪早,首页请求全部失败,页面就一直黑着。
+
+实测证据:同一个虚拟机,开机后立刻查是「无 IP」,等一两分钟后再查就变成
+`wlan0 inet 10.0.2.16/24` + `Wifi is connected to "AndroidWifi"`,此时红果首页完全正常。
+
+### 本版修复
+
+1. **拉起应用前先等网络就绪**:`installer.launch` 会在 `am start` 之前最多等 150 秒,
+ 日志里会打 `正在等待安卓虚拟机联网… Ns`,就绪后才真正启动应用 —— 从根上避免
+ 「应用比网络先跑起来」导致的黑屏。
+2. **启动后网络体检**:开机成功就检查虚拟机有没有拿到 IP,没网时日志里明确写出原因,
+ 不再让用户对着黑屏猜。
+3. **设置 → 修复网络**(新按钮):一键修复。做法是重置安卓用户数据并重新开机,
+ 然后一直等到网络就绪(最长 4 分钟),成功后再把「网络正常」的状态存成快速启动快照。
+ - **应用清单会保留**,点开应用会自动重装,不用手动重装 APK;
+ - 应用内的登录态、追剧记录等运行时数据会丢失,需要重新登录;
+ - 只影响当前 AVD,系统镜像和本机 APK 缓存都不动。
+
+> 红果现在黑屏的话:先直接点开红果试试(本版会自动等网络);仍黑再点「设置 → 修复网络」。
+
+## 二、上一版「清理缓存」修复继续生效
+
+v0.3.5 的 `includeSnapshots` + 「重置安卓数据」未改动,继续可用。
+
+## 三、已知限制
+
+- 该 Android 14(`google_apis_playstore`)镜像存在上游问题:在**已有用户数据**上冷启动时,
+ Wi-Fi 经常一直 `NO-CARRIER`、拿不到 IP;重置数据后的那次开机则能正常连上。
+ 因此「修复网络」会重置数据,并立刻存快照来保住可用状态。
+- Play Store 镜像不允许 `adb root`,无法单独删掉坏掉的 Wi-Fi 配置。
+
+## 四、实测记录
+
+- 修复后:点「同意并继续」→ 进入 `MainFragmentActivity`,首页正常显示剧集列表与推荐流
+ (截图确认,非黑屏)。
+- 同一虚拟机等待网络就绪后:`wlan0 inet 10.0.2.16/24`、`Wifi is connected to "AndroidWifi"`。
+- `npm test`:**113 项全部通过**(8 + 25 + 80)。
+
+## 五、升级方式
+
+- 便携版:解压覆盖,数据目录(默认 `%APPDATA%\apkstart`)保持不变。
+- 安装版:直接安装覆盖。
diff --git a/package.json b/package.json
index f8a169a..7a0420c 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
{
"name": "apkstart",
"productName": "ApkStart",
- "version": "0.3.5",
+ "version": "0.3.6",
"description": "极致轻量的 Windows 安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行",
"main": "src/main.js",
"author": "RoutineMiku",
diff --git a/src/core/emulator.js b/src/core/emulator.js
index 6e65676..1b8805a 100644
--- a/src/core/emulator.js
+++ b/src/core/emulator.js
@@ -550,7 +550,12 @@ class EmulatorEngine {
// 但退出时照常把内存状态写成 apkstart,下次就直接恢复。
// 快照要占一份约 2~3GB 的 ram.bin(磁盘紧张的用户可以关掉,只影响启动速度)
const wantSnapshot = this.settings?.engine?.keepSnapshot !== false;
- if (wipe || !wantSnapshot) {
+ if (wipe) {
+ // 重置数据时不能加载旧快照(数据都对不上了),但**必须允许保存新快照**:
+ // 修复网络就是靠「重置后第一次开机有网 → 立刻存快照 → 下次恢复」这条链路,
+ // 老写法这里推的是 -no-snapshot,会把保存一起关掉,快照永远存不下来。
+ args.push('-no-snapshot-load');
+ } else if (!wantSnapshot) {
args.push('-no-snapshot');
} else if (snapshot !== false) {
args.push('-snapshot', SNAPSHOT_NAME);
@@ -765,6 +770,83 @@ class EmulatorEngine {
});
}
+ /**
+ * 让「下一次启动」带上 -wipe-data(仅「修复网络」在等待超时后使用)。
+ *
+ * 实测:这个 Android 14 镜像的 Wi-Fi,在已有用户数据上冷启时经常一直
+ * NO-CARRIER、拿不到 IP;而重置数据后的那次开机是能连上的。
+ * 注意「删掉 userdata 镜像文件」与 emulator 的 `-wipe-data` 并不等价,必须走后者。
+ */
+ forceWipeOnNextStart() { this._forceWipe = true; }
+
+ /**
+ * 体检虚拟机内是否真的能联网。
+ *
+ * 为什么需要这一步:安卓虚拟机的 Wi-Fi 配置存在 /data 里,一旦写坏(典型表现是
+ * `cmd wifi list-networks` 里同一个 AndroidWifi 出现两条、网络 id 撞车),
+ * wlan0 就会一直 NO-CARRIER、拿不到 IP。这时「需要联网的页面」在应用里就是一块
+ * 黑屏 —— 用户看到的「红果点同意后黑屏」就是这么来的,跟 GPU/渲染完全无关。
+ *
+ * @param {string} [adbPath] 显式指定 adb 可执行文件(Runtime 有更权威的解析)
+ * @returns {Promise<{ok:boolean, reason:string, gateway?:string, ip?:string}>}
+ */
+ async checkNetwork(adbPath = '', { waitMs = 0, interval = 3000 } = {}) {
+ const fs = require('fs');
+ const path = require('path');
+ let adb = adbPath || '';
+ if (!adb) {
+ try { adb = this.provisioner.adbVersionPath() || ''; } catch (_) { adb = ''; }
+ }
+ if (!adb) {
+ // adbVersionPath() 只查「版本文件」,很多安装形态下是空的;
+ // 直接按运行时根目录找 bundled 的 platform-tools 才稳。
+ try { adb = path.join(this.locate().root, 'platform-tools', 'adb.exe'); } catch (_) { adb = ''; }
+ }
+ if (!adb || !fs.existsSync(adb)) adb = 'adb';
+ const port = Number(process.env.ANDROID_ADB_SERVER_PORT) || this.adbPort || 5044;
+ const env = { ...process.env, ANDROID_ADB_SERVER_PORT: String(port) };
+ const sh = (cmd, timeout = 8000) => new Promise((resolve) => {
+ try {
+ execFile(adb, ['-s', this.serial, 'shell', cmd], { timeout, windowsHide: true, env }, (e, out) => {
+ resolve(e ? '' : String(out || ''));
+ });
+ } catch (_) { resolve(''); }
+ });
+ // 安卓的多路由表会让 `ip route` 的主表看起来是空的(默认路由在 per-interface 表里),
+ // 而且 shell 的 uid 不在应用的 network 组里,`ping` 经常误报 "Network is unreachable",
+ // 哪怕 Wi-Fi 其实已经连上、应用也能正常上网。所以这里只认「有没有拿到 IPv4 地址」,
+ // 再叠加 `cmd wifi status` 的连接状态做交叉确认,不用 ping 判断。
+ const addr = await sh('ip -o addr');
+ const ips = [];
+ const re = /inet ((?:\d{1,3}\.){3}\d{1,3})\//g;
+ let m = re.exec(addr);
+ while (m) {
+ const ip = m[1];
+ if (!/^127\./.test(ip)) ips.push(ip);
+ m = re.exec(addr);
+ }
+ const wifi = await sh('cmd wifi status');
+ const connected = /Wifi is connected/i.test(wifi);
+ if (!ips.length) {
+ // Wi-Fi 关联 + DHCP 往往比 sys.boot_completed 晚几十秒才完成。
+ // 调用方给了 waitMs 就继续等,不要在这一刻就断定「没有网络」。
+ if (waitMs > 0) {
+ const t0 = Date.now();
+ while (Date.now() - t0 < waitMs) {
+ // eslint-disable-next-line no-await-in-loop
+ await new Promise((r) => setTimeout(r, interval));
+ // eslint-disable-next-line no-await-in-loop
+ const again = await this.checkNetwork(adbPath, { waitMs: 0 });
+ if (again.ok) return again;
+ }
+ }
+ return { ok: false, reason: connected ? 'no-ip-address' : 'wifi-not-connected', addrs: ips };
+ }
+ const ip = ips[0];
+ const gw = /^10\.0\.2\./.test(ip) ? '10.0.2.2' : ip.replace(/\.\d+$/, '.1');
+ return { ok: true, reason: '', gateway: gw, ip, wifiConnected: connected };
+ }
+
/**
* 启动 + 自动重试。
* @param {Function} probe 异步回调,返回 'ok' | 'pending' | 'fatal'
@@ -879,7 +961,9 @@ class EmulatorEngine {
// eslint-disable-next-line no-await-in-loop
const avd = this.ensureAvd({
...plan,
- wipe: plan.wipe || !!this.wipePending,
+ // _forceWipe 也要参与「删旧快照」:重置数据后旧快照必然加载失败
+ // (实测报 Failed to load snapshot 后退回冷启动),必须先清掉再重建。
+ wipe: plan.wipe || !!this.wipePending || !!this._forceWipe,
});
// 埋点:上层(main)用它在拉起模拟器**之前**打开黑窗压制。
// 控制台窗口在 spawn 之后几十毫秒就冒出来,事后再补一次扫描必然闪一下,
@@ -889,7 +973,9 @@ class EmulatorEngine {
try { await this.onBeforeSpawn(); } catch (_) { /* ignore */ }
}
// eslint-disable-next-line no-await-in-loop
- this.spawnOnce({ ...plan, wipe: plan.wipe || avd.wipePending }, { headless, onLog, logFile });
+ const forceWipe = !!this._forceWipe;
+ this._forceWipe = false;
+ this.spawnOnce({ ...plan, wipe: plan.wipe || avd.wipePending || forceWipe }, { headless, onLog, logFile });
// 参数错误 / DLL 缺失会立刻退出
// eslint-disable-next-line no-await-in-loop
@@ -970,9 +1056,17 @@ class EmulatorEngine {
// 装完新应用时 installer 会作废快照,避免"重启后应用消失"。
this.snapshotWorthSaving = true;
onLog(`运行时就绪(${Math.round(bootMs / 1000)}s,${plan.label})`);
+ // 开机成功不等于能用:顺手体检网络。虚拟机没网时,需要联网的页面会一直黑屏,
+ // 用户只会说「这个应用黑屏」,很难联想到是网络。这里主动查一次并说清楚。
+ let network = null;
+ try { network = await this.checkNetwork(); } catch (_) { /* 体检失败不算启动失败 */ }
+ if (network && !network.ok) {
+ onLog('⚠ 安卓虚拟机当前没有网络:需要联网的应用(如红果、短剧类)打开后会一直黑屏。'
+ + '可在「设置 → 修复网络」重置安卓数据来修(应用清单会保留,点开时会自动重装)。');
+ }
return {
ok: true, serial: this.serial, port, accel: accelInfo, logFile,
- profile, attempts: this.attempts, bootMs, quickBoot: true,
+ profile, attempts: this.attempts, bootMs, quickBoot: true, network,
};
}
diff --git a/src/core/engine.js b/src/core/engine.js
index 5be731c..1c095d6 100644
--- a/src/core/engine.js
+++ b/src/core/engine.js
@@ -330,7 +330,7 @@ class Runtime {
await this.prepare(client);
// 快照改成「空闲时再存」:立刻存要写 1~3GB,会和用户刚点开的应用抢磁盘 I/O
this._armSnapshotSave(20000);
- return { ok: true, client, engine: 'emulator', serial: this.emuSerial, profile: st.profile };
+ return { ok: true, client, engine: 'emulator', serial: this.emuSerial, profile: st.profile, network: st.network || null };
} catch (e) {
// 把自动重试/诊断结论原样抛给 UI,避免再包一层含糊的「启动失败」
return { ok: false, error: e.message, diagnosis: e.diagnosis, report: e.report, attempts: e.attempts };
@@ -864,7 +864,7 @@ class Runtime {
await this.killOrphanEmulators({ onLog }).catch(() => {});
try {
const r = await this.boot({ onLog });
- if (r.ok) return { ok: true, client: r.client, engine: 'emulator', profile: r.profile };
+ if (r.ok) return { ok: true, client: r.client, engine: 'emulator', profile: r.profile, network: r.network || null };
return {
ok: false, error: r.error, env,
diagnosis: r.diagnosis, report: r.report, attempts: r.attempts, exitCode: r.exitCode,
@@ -1107,6 +1107,70 @@ class Runtime {
}
}
+ /**
+ * 等待虚拟机联网。
+ *
+ * 实测:`sys.boot_completed` 只代表系统起来了,Wi-Fi 关联 + DHCP 还要再等
+ * 十几秒到一分多钟才会拿到 10.0.2.16。红果这类应用一进去就拉首页数据,
+ * 没网时页面渲染成一整块黑底(隐私弹窗是本地页面所以正常显示),
+ * 用户看到的就是「点同意并继续之后一直黑屏」。所以拉起应用前先等网络就绪。
+ *
+ * @returns {Promise<{ok:boolean,reason:string,ip?:string,gateway?:string}>}
+ */
+ async waitForNetwork({ timeoutMs = 90000, onLog = () => {}, adbPath = '' } = {}) {
+ const t0 = Date.now();
+ let last = null;
+ let lastNotice = 0;
+ while (Date.now() - t0 < timeoutMs) {
+ // eslint-disable-next-line no-await-in-loop
+ last = await this.emulator.checkNetwork(adbPath || this.adbPath()).catch(() => null);
+ if (last && last.ok) return last;
+ if (Date.now() - lastNotice > 10000) {
+ lastNotice = Date.now();
+ onLog(`正在等待安卓虚拟机联网… ${Math.round((Date.now() - t0) / 1000)}s`);
+ }
+ // eslint-disable-next-line no-await-in-loop
+ await new Promise((r) => setTimeout(r, 3000));
+ }
+ return last || { ok: false, reason: 'timeout' };
+ }
+
+ /**
+ * 修复「安卓虚拟机没有网络」。
+ * 绝大多数情况只是 Wi-Fi 关联比开机完成慢,重启并等一会儿就能好,
+ * **不需要**清掉用户数据;只有在等待超时后才提示用户走「重置安卓数据」。
+ *
+ * @returns {Promise<{ok:boolean, network?:object, boot?:boolean, error?:string}>}
+ */
+ async repairNetwork({ onLog = () => {} } = {}) {
+ try {
+ onLog('正在修复虚拟机网络:重置安卓数据并重新开机(应用清单会保留,点开时自动重装)…');
+ if (this.vmRunning) await this.stop({ graceful: false }).catch(() => {});
+ // 这个 Android 14 镜像上,已有用户数据冷启时 Wi-Fi 经常一直 NO-CARRIER;
+ // 重置数据后的那次开机才能稳定连上,所以这里显式走 -wipe-data。
+ this.emulator.forceWipeOnNextStart();
+ const boot = await this.ensure({ onLog });
+ if (!boot || !boot.ok) {
+ return { ok: false, error: (boot && boot.error) || '虚拟机没能启动', boot: false };
+ }
+ // Wi-Fi 关联 + DHCP 比 sys.boot_completed 晚很多(实测最长 2 分多钟),要给足时间。
+ const network = await this.waitForNetwork({ onLog, timeoutMs: 240000 });
+ if (network && network.ok) {
+ // 立刻把「网络正常」的状态存成快速启动快照,下次恢复时网卡状态一起还原。
+ try {
+ const saved = await this.emulator.saveSnapshotNow(this.adbPath(), { timeout: 90000 });
+ onLog(saved ? '已把「网络正常」的状态存成快速启动快照。' : '快照没存下(不影响本次使用)。');
+ } catch (_) { /* ignore */ }
+ onLog(`网络已恢复(${network.ip || ''} 网关 ${network.gateway || '可达'})。`);
+ } else {
+ onLog('等待超时,虚拟机仍没有网络。多半是宿主机网络/防火墙拦住了模拟器,请检查后重试。');
+ }
+ return { ok: !!(network && network.ok), network, boot: true };
+ } catch (e) {
+ return { ok: false, error: e.message };
+ }
+ }
+
dispose() {
if (this._watchdog) clearInterval(this._watchdog);
if (this._client && this._client.disposeInput) this._client.disposeInput();
diff --git a/src/core/installer.js b/src/core/installer.js
index 0c10ad5..63fba25 100644
--- a/src/core/installer.js
+++ b/src/core/installer.js
@@ -413,6 +413,19 @@ class Installer {
}
// 分辨率要在拉起应用之前改,避免 wm size 触发配置变更把刚启动的 Activity 重建
if (beforeStart) await beforeStart(rt).catch((e) => onLog(`显示适配跳过:${e.message}`));
+ // 冷启动时顺手做过网络体检:没网就直接说清楚。否则用户只会看到「这个应用一直黑屏」,
+ // 完全想不到是虚拟机没网(联网页面拿不到数据就是一块黑底)。
+ // 关键修复:Wi-Fi 关联往往比 sys.boot_completed 晚几十秒,红果一进去就拉首页数据,
+ // 没网时首页渲染成整块黑底 —— 这就是「点同意并继续后一直黑屏」的真正原因。
+ // 所以拉起应用前先等网络就绪(最多 90 秒),宁可多等几秒也不要给用户一块黑屏。
+ if (rt.engine === 'emulator' || rt.engine === 'builtin') {
+ const net = await this.runtime.waitForNetwork({ onLog, timeoutMs: 150000 }).catch(() => null);
+ if (net && net.ok) {
+ onLog(`虚拟机网络就绪(${net.ip || ''})`);
+ } else {
+ onLog('⚠ 虚拟机联网超时:需要联网的页面可能暂时黑屏,可在「设置 → 修复网络」重试。');
+ }
+ }
const settings = store.getSettings();
const start = () => rt.client.startApp(app ? app.package : pkg, app ? app.activity : null, {
freeform: settings.freeform,
diff --git a/src/main.js b/src/main.js
index c643d71..522f459 100644
--- a/src/main.js
+++ b/src/main.js
@@ -1101,6 +1101,29 @@ function registerIpc() {
}
});
+ // 修复虚拟机网络:重置 /data(保留应用清单,点开应用会自动重装)。
+ // 典型场景:安卓里所有联网页面一直黑屏,其实是 wlan0 没起来、没有默认路由。
+ ipcMain.handle('runtime:repairNetwork', async () => {
+ try {
+ const r = await runtime.repairNetwork({
+ onLog: (m) => send('toast', { message: m, kind: 'info', timeout: 6000 }),
+ });
+ return r;
+ } catch (e) {
+ return { ok: false, error: e.message };
+ }
+ });
+
+ // 只做网络体检,不动任何数据(设置页用来显示当前状态)
+ ipcMain.handle('runtime:checkNetwork', async () => {
+ try {
+ const network = await runtime.emulator.checkNetwork(runtime.adbPath());
+ return { ok: !!network.ok, network };
+ } catch (e) {
+ return { ok: false, error: e.message };
+ }
+ });
+
// ---------------- 运行时自举 ----------------
ipcMain.handle('provision:installEmulator', async () => {
diff --git a/src/preload.js b/src/preload.js
index ddab9d4..1d962b2 100644
--- a/src/preload.js
+++ b/src/preload.js
@@ -36,6 +36,8 @@ contextBridge.exposeInMainWorld('apkstart', {
runtimeUsage: () => invoke('runtime:usage'),
runtimeCleanup: (opts) => invoke('runtime:cleanup', opts || {}),
runtimeResetData: () => invoke('runtime:resetData'),
+ runtimeRepairNetwork: () => invoke('runtime:repairNetwork'),
+ runtimeCheckNetwork: () => invoke('runtime:checkNetwork'),
dataInfo: () => invoke('runtime:dataInfo'),
setDataSize: (gb) => invoke('runtime:setDataSize', gb),
confirm: (opts) => invoke('app:confirm', opts || {}),
diff --git a/src/ui/app.js b/src/ui/app.js
index d1c2ef9..b3a04dc 100644
--- a/src/ui/app.js
+++ b/src/ui/app.js
@@ -1141,6 +1141,48 @@ function bindSettings() {
}
});
+ // 修复网络:安卓里联网页面一直黑屏(红果点「同意并继续」后整屏黑)时用。
+ // 根因是虚拟机 /data 里的 Wi-Fi 配置坏了,wlan0 没起来、没有默认路由。
+ // Play Store 镜像不允许 root,只能整体重置 /data;应用清单保留,点开时会自动重装。
+ $('btnRepairNetwork').addEventListener('click', async () => {
+ const btn = $('btnRepairNetwork');
+ btn.disabled = true;
+ try {
+ const ok = await api.confirm({
+ type: 'warning',
+ title: '修复虚拟机网络?',
+ message: '应用里需要联网的页面一直黑屏/转圈,通常是安卓虚拟机没有网络。',
+ detail: '修复方式:重置安卓用户数据,让虚拟机重新获得网络。\n\n'
+ + '• 应用清单会保留,点开应用会自动重装,不用手动装\n'
+ + '• 应用内的登录态、追剧记录等运行时数据会丢失,需要重新登录\n'
+ + '• 只影响当前 AVD,系统镜像和本机 APK 缓存都不动\n\n'
+ + '整个过程约 30–90 秒(要重新冷启动一次)。是否继续?',
+ buttons: ['取消', '开始修复'],
+ defaultId: 0,
+ cancelId: 0,
+ });
+ if (!ok || ok.response !== 1) return;
+ const r = await api.runtimeRepairNetwork();
+ if (!r || !r.ok) {
+ toast({
+ title: '网络仍未恢复',
+ body: (r && r.error) || '重置后虚拟机还是没网,请检查本机网络/防火墙是否拦住了模拟器。',
+ type: 'error',
+ });
+ return;
+ }
+ toast({
+ title: '网络已恢复',
+ body: `网关 ${(r.network && r.network.gateway) || '可达'}。点开应用会自动重装,联网页面不会再黑屏。`,
+ type: 'ok',
+ });
+ } catch (e) {
+ toast({ title: '修复失败', body: e.message, type: 'error' });
+ } finally {
+ btn.disabled = false;
+ }
+ });
+
$('btnOpenShared').addEventListener('click', () => api.openSharedDir());
// 重建快捷方式:桌面图标被误删 / 被安全软件拦掉时的兜底入口
diff --git a/src/ui/index.html b/src/ui/index.html
index b809c20..fca860f 100644
--- a/src/ui/index.html
+++ b/src/ui/index.html
@@ -149,6 +149,7 @@
<div class="row">
<span class="inline-note" id="usageText">正在统计…</span>
<button class="btn ghost sm" id="btnCleanup">清理可回收文件</button>
+ <button class="btn ghost sm" id="btnRepairNetwork" title="安卓虚拟机没有网络时(应用里联网页面一直黑屏/转圈),用这个把安卓数据重置掉来修网络。应用清单会保留,点开应用会自动重装">修复网络</button>
<button class="btn ghost sm danger" id="btnResetData" title="清空安卓 /data 用户数据 + 已装应用 + 快速启动快照,还原成刚装好系统的干净状态">重置安卓数据</button>
</div>
<label class="checkbox-inline">
diff --git a/test/auto-test.js b/test/auto-test.js
index f1a89b2..d260a69 100644
--- a/test/auto-test.js
+++ b/test/auto-test.js
@@ -463,7 +463,11 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../src
const cold = emu.buildArgs({ wipe: true }).join(' ');
assert(/-wipe-data/.test(cold), 'wipe 时必须带 -wipe-data');
- assert(/ -no-snapshot( |$)/.test(cold), 'wipe 时不能加载也不能保存快照');
+ // 重置数据时:不加载旧快照(数据对不上),但**允许保存**新快照。
+ // 「修复网络」依赖这条链路:重置后第一次开机有网 → 立刻存快照 → 下次恢复。
+ // 老实现这里推 -no-snapshot,会把保存一起关掉,导致修完网络存不下快照。
+ assert(/ -no-snapshot-load( |$)/.test(cold), 'wipe 时不该加载旧快照');
+ assert(!/ -no-snapshot( |$)/.test(cold), 'wipe 时仍要允许保存新快照(修复网络依赖它)');
});
await test('新版 emulator 写的 ram.bin 必须被认作完整快照(否则刚存好的 3GB 会被当空壳删掉)', () => {