@react-native-harness/platform-android 1.4.0-rc.1 → 1.4.0

package/dist/__tests__/adb-wait.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adb-wait.test.d.ts.map

package/dist/__tests__/adb-wait.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb-wait.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/adb-wait.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/adb-wait.test.js

@@ -0,0 +1,69 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+const mocks = vi.hoisted(() => ({
+    spawn: vi.fn(),
+}));
+// The global test/setup.ts mocks '../adb.js' wholesale (including
+// waitForEmulator itself), which is right for consumers of this module but
+// defeats the purpose here: this suite exercises the *real* polling loop
+// (and its private waitWithSignal helper) to catch timer/listener leaks.
+// Re-declaring the mock for this file restores the actual implementation,
+// while `spawn` and `getAdbBinaryPath` (genuine cross-module imports) are
+// swapped out to keep `getDeviceIds()` from touching a real adb binary.
+vi.mock('../adb.js', async () => {
+    const actual = await vi.importActual('../adb.js');
+    return actual;
+});
+vi.mock('../environment.js', async () => {
+    const actual = await vi.importActual('../environment.js');
+    return { ...actual, getAdbBinaryPath: () => '/fake/sdk/platform-tools/adb' };
+});
+vi.mock('@react-native-harness/tools', async () => {
+    const actual = await vi.importActual('@react-native-harness/tools');
+    return { ...actual, spawn: mocks.spawn };
+});
+const { waitForEmulator } = await import('../adb.js');
+afterEach(() => {
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+});
+describe('waitForEmulator polling', () => {
+    it('does not leak an abort listener per poll iteration when the delay wins', async () => {
+        vi.useFakeTimers();
+        // No matching device on any poll: `adb devices` reports an empty list.
+        mocks.spawn.mockResolvedValue({ stdout: 'List of devices attached\n' });
+        const controller = new AbortController();
+        const addSpy = vi.spyOn(controller.signal, 'addEventListener');
+        const removeSpy = vi.spyOn(controller.signal, 'removeEventListener');
+        const resultPromise = waitForEmulator('Test_AVD', controller.signal);
+        resultPromise.catch(() => undefined);
+        for (let i = 0; i < 3; i += 1) {
+            await vi.advanceTimersByTimeAsync(1_000);
+        }
+        // Regression: each 1s poll iteration used to add an 'abort' listener
+        // to the local waitForAbort helper that was never removed when the
+        // delay (not the abort) won the race, leaking one listener per second
+        // of polling against this session-lifetime signal.
+        expect(addSpy.mock.calls.length).toBeGreaterThanOrEqual(3);
+        const addCallsBeforeAbort = addSpy.mock.calls.length;
+        controller.abort(new Error('teardown'));
+        await expect(resultPromise).rejects.toThrow('teardown');
+        // Every listener added while losing the race — including the one still
+        // pending when the abort itself won — must be removed again.
+        expect(removeSpy).toHaveBeenCalledTimes(addCallsBeforeAbort);
+    });
+    it('clears the pending 1s poll timer when the signal aborts mid-wait', async () => {
+        vi.useFakeTimers();
+        mocks.spawn.mockResolvedValue({ stdout: 'List of devices attached\n' });
+        const controller = new AbortController();
+        const resultPromise = waitForEmulator('Test_AVD', controller.signal);
+        resultPromise.catch(() => undefined);
+        // Let the loop enter its 1s wait, then abort before the timer fires.
+        await vi.advanceTimersByTimeAsync(0);
+        controller.abort(new Error('teardown'));
+        await expect(resultPromise).rejects.toThrow('teardown');
+        // Regression: the bare setTimeout-backed `wait()` used to have no
+        // handle to clear, so it stayed alive in the event loop for the rest
+        // of the 1s interval even after the abort branch won.
+        expect(vi.getTimerCount()).toBe(0);
+    });
+});

package/dist/__tests__/app-session.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-session.test.d.ts.map

package/dist/__tests__/app-session.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-session.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/app-session.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/app-session.test.js

@@ -0,0 +1,57 @@
+import { describe, expect, it } from 'vitest';
+import { createAndroidAppSession } from '../app-session.js';
+// Mimics nano-spawn: the async iterator only ends once its abort signal
+// fires, matching how startLogcat's real subprocess reacts to abort.
+const createAbortableLogcatProcess = (signal) => ({
+    [Symbol.asyncIterator]: () => ({
+        next: () => new Promise((resolve) => {
+            if (signal.aborted) {
+                resolve({ done: true, value: undefined });
+                return;
+            }
+            signal.addEventListener('abort', () => resolve({ done: true, value: undefined }), { once: true });
+        }),
+    }),
+    catch: () => undefined,
+});
+describe('createAndroidAppSession', () => {
+    it('combines the session-lifetime signal with its own logcat abort controller', async () => {
+        let capturedSignal;
+        const controller = new AbortController();
+        const session = await createAndroidAppSession({
+            appUid: 1,
+            bundleId: 'com.example',
+            startApp: async () => undefined,
+            stopApp: async () => undefined,
+            getAppPid: async () => null,
+            getLogcatTimestamp: async () => '00:00:00.000',
+            startLogcat: (_args, options) => {
+                capturedSignal = options.signal;
+                return createAbortableLogcatProcess(options.signal);
+            },
+            signal: controller.signal,
+        });
+        expect(capturedSignal?.aborted).toBe(false);
+        controller.abort();
+        expect(capturedSignal?.aborted).toBe(true);
+        await session.dispose();
+    });
+    it('still aborts the logcat signal via dispose() with no external signal provided', async () => {
+        let capturedSignal;
+        const session = await createAndroidAppSession({
+            appUid: 1,
+            bundleId: 'com.example',
+            startApp: async () => undefined,
+            stopApp: async () => undefined,
+            getAppPid: async () => null,
+            getLogcatTimestamp: async () => '00:00:00.000',
+            startLogcat: (_args, options) => {
+                capturedSignal = options.signal;
+                return createAbortableLogcatProcess(options.signal);
+            },
+        });
+        expect(capturedSignal?.aborted).toBe(false);
+        await session.dispose();
+        expect(capturedSignal?.aborted).toBe(true);
+    });
+});

package/dist/__tests__/avd-config.test.js

@@ -1,6 +1,8 @@
 import { describe, expect, it } from 'vitest';
 import { getNormalizedAvdCacheConfig, isAvdCompatible, parseAvdConfig, resolveAvdCachingEnabled, } from '../avd-config.js';
 import { AndroidPlatformConfigSchema } from '../config.js';
+import { getEmulatorCpuCores } from '../emulator-startup.js';
+const emulatorCpuCores = getEmulatorCpuCores();
 describe('AVD config helpers', () => {
     it('parses snapshot config from Android schema', () => {
         const config = AndroidPlatformConfigSchema.parse({
@@ -59,7 +61,9 @@ abi.type=x86_64
 hw.device.name=pixel_8
 disk.dataPartition.size=1G
 vm.heapSize=512M
+hw.cpu.ncore=${emulatorCpuCores}
 `);
+        expect(avdConfig.hwCpuNcore).toBe(String(emulatorCpuCores));
         expect(isAvdCompatible({
             emulator: {
                 type: 'emulator',
@@ -75,6 +79,59 @@ vm.heapSize=512M
             hostArch: 'x86_64',
         })).toEqual({ compatible: true });
     });
+    it('rejects AVDs missing hw.cpu.ncore', () => {
+        const avdConfig = parseAvdConfig(`
+image.sysdir.1=system-images/android-35/default/x86_64/
+abi.type=x86_64
+hw.device.name=pixel_8
+disk.dataPartition.size=1G
+vm.heapSize=512M
+`);
+        expect(isAvdCompatible({
+            emulator: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '512M',
+                },
+            },
+            avdConfig,
+            hostArch: 'x86_64',
+        })).toMatchObject({
+            compatible: false,
+            reason: `CPU core count mismatch: expected ${emulatorCpuCores}, got missing.`,
+        });
+    });
+    it('rejects AVDs with a different hw.cpu.ncore', () => {
+        const avdConfig = parseAvdConfig(`
+image.sysdir.1=system-images/android-35/default/x86_64/
+abi.type=x86_64
+hw.device.name=pixel_8
+disk.dataPartition.size=1G
+vm.heapSize=512M
+hw.cpu.ncore=${emulatorCpuCores === 4 ? 3 : 4}
+`);
+        expect(isAvdCompatible({
+            emulator: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '512M',
+                },
+            },
+            avdConfig,
+            hostArch: 'x86_64',
+        })).toMatchObject({
+            compatible: false,
+            reason: `CPU core count mismatch: expected ${emulatorCpuCores}, got ${emulatorCpuCores === 4 ? 3 : 4}.`,
+        });
+    });
     it('accepts disk partition sizes rewritten to bytes', () => {
         const avdConfig = parseAvdConfig(`
 image.sysdir.1=system-images/android-35/default/x86_64/
@@ -82,6 +139,7 @@ abi.type=x86_64
 hw.device.name=pixel_8
 disk.dataPartition.size=6442450944
 vm.heapSize=512M
+hw.cpu.ncore=${emulatorCpuCores}
 `);
         expect(isAvdCompatible({
             emulator: {

package/dist/__tests__/emulator-startup.test.js

@@ -1,20 +1,47 @@
 import { describe, expect, it } from 'vitest';
-import { getEmulatorStartupArgs } from '../emulator-startup.js';
+import { getEmulatorCpuCores, getEmulatorStartupArgs, isAccelerationUsable, } from '../emulator-startup.js';
+import { getDeviceCoreBudget } from '@react-native-harness/tools';
+import os from 'node:os';
+describe('getEmulatorCpuCores', () => {
+    it('uses the shared device-core budget for the current host', () => {
+        expect(getEmulatorCpuCores()).toBe(getDeviceCoreBudget(os.availableParallelism()));
+    });
+});
 describe('emulator startup modes', () => {
     it('builds default boot args', () => {
         expect(getEmulatorStartupArgs('Pixel_8_API_35', 'default-boot')).toEqual(expect.arrayContaining([
             '@Pixel_8_API_35',
             '-no-snapshot-load',
             '-no-snapshot-save',
+            '-no-metrics',
         ]));
         expect(getEmulatorStartupArgs('Pixel_8_API_35', 'default-boot')).not.toEqual(expect.arrayContaining(['-camera-back', 'none']));
     });
     it('builds clean snapshot generation args', () => {
-        expect(getEmulatorStartupArgs('Pixel_8_API_35', 'clean-snapshot-generation')).toEqual(expect.arrayContaining(['@Pixel_8_API_35', '-no-snapshot-load']));
+        expect(getEmulatorStartupArgs('Pixel_8_API_35', 'clean-snapshot-generation')).toEqual(expect.arrayContaining([
+            '@Pixel_8_API_35',
+            '-no-snapshot-load',
+            '-no-metrics',
+        ]));
         expect(getEmulatorStartupArgs('Pixel_8_API_35', 'clean-snapshot-generation')).not.toContain('-no-snapshot-save');
     });
     it('builds snapshot reuse args', () => {
-        expect(getEmulatorStartupArgs('Pixel_8_API_35', 'snapshot-reuse')).toEqual(expect.arrayContaining(['@Pixel_8_API_35', '-no-snapshot-save']));
+        expect(getEmulatorStartupArgs('Pixel_8_API_35', 'snapshot-reuse')).toEqual(expect.arrayContaining([
+            '@Pixel_8_API_35',
+            '-no-snapshot-save',
+            '-no-metrics',
+        ]));
         expect(getEmulatorStartupArgs('Pixel_8_API_35', 'snapshot-reuse')).not.toContain('-no-snapshot-load');
     });
 });
+describe('isAccelerationUsable', () => {
+    it('returns true when the emulator reports acceleration is usable', () => {
+        expect(isAccelerationUsable('accel:\n0\nKVM (version 12) is installed and usable.\naccel\n')).toBe(true);
+    });
+    it('returns false when acceleration is disabled', () => {
+        expect(isAccelerationUsable('accel:\n0\nKVM is not installed on this machine.\naccel\n')).toBe(false);
+    });
+    it('returns false for empty output', () => {
+        expect(isAccelerationUsable('')).toBe(false);
+    });
+});

package/dist/__tests__/instance.test.js

@@ -5,8 +5,12 @@ import * as adb from '../adb.js';
 import * as avdConfig from '../avd-config.js';
 import * as sharedPrefs from '../shared-prefs.js';
 import { HarnessAppPathError, HarnessEmulatorConfigError } from '../errors.js';
+import * as emulatorStartup from '../emulator-startup.js';
+const { getEmulatorCpuCores } = emulatorStartup;
 const createLogcatProcess = (lines = []) => {
-    const process = {
+    // Mirrors nano-spawn's real Subprocess, which is both a Promise and an
+    // async iterable, since app-session.ts relies on it being thenable.
+    const process = Object.assign(Promise.resolve(undefined), {
         nodeChildProcess: Promise.resolve({
             kill: vi.fn(),
         }),
@@ -15,7 +19,7 @@ const createLogcatProcess = (lines = []) => {
                 yield line;
             }
         },
-    };
+    });
     return process;
 };
 const harnessConfig = {
@@ -34,6 +38,7 @@ describe('Android platform instance', () => {
         vi.unstubAllEnvs();
         vi.useRealTimers();
         vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorAvailable').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(emulatorStartup, 'warnIfEmulatorAccelerationUnavailable').mockResolvedValue(undefined);
     });
     it('reuses a running emulator and does not shut it down on dispose', async () => {
         const ensureAndroidEmulatorEnvironment = vi
@@ -162,6 +167,7 @@ describe('Android platform instance', () => {
             hwDeviceName: 'pixel_8',
             diskDataPartitionSize: '1G',
             vmHeapSize: '1G',
+            hwCpuNcore: String(getEmulatorCpuCores()),
         });
         vi.spyOn(adb, 'startEmulator').mockResolvedValue(undefined);
         vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
@@ -381,7 +387,7 @@ describe('Android platform instance', () => {
             '--uid=10234',
             '-T',
             '01-01 00:00:00.000',
-        ]);
+        ], { signal: expect.any(AbortSignal) });
         expect(startLogcat.mock.invocationCallOrder[0]).toBeLessThan(startApp.mock.invocationCallOrder[0]);
         await expect(appSession.getState()).resolves.toEqual({
             status: 'running',
@@ -487,7 +493,7 @@ describe('Android platform instance', () => {
             '--uid=10234',
             '-T',
             '01-01 00:00:00.000',
-        ]);
+        ], { signal: expect.any(AbortSignal) });
         await expect(appSession.getState()).resolves.toEqual({
             status: 'running',
             pid: 8765,

package/dist/adb.d.ts

@@ -44,7 +44,9 @@ export declare const getAppPid: (adbId: string, bundleId: string) => Promise<num
 export declare const getAppUid: (adbId: string, bundleId: string) => Promise<number>;
 export declare const setHideErrorDialogs: (adbId: string, hide: boolean) => Promise<void>;
 export declare const getLogcatTimestamp: (adbId: string) => Promise<string>;
-export declare const startLogcat: (adbId: string, args: readonly string[]) => Subprocess;
+export declare const startLogcat: (adbId: string, args: readonly string[], options?: {
+    signal?: AbortSignal;
+}) => Subprocess;
 export declare const DROPBOX_CRASH_TAGS: readonly ["data_app_crash", "data_app_native_crash"];
 export declare const getDropboxPrint: (adbId: string, tags?: readonly string[]) => Promise<string>;
 export declare const getActivityExitInfo: (adbId: string, bundleId: string) => Promise<string>;

package/dist/adb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"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"}

package/dist/adb.js

@@ -1,30 +1,27 @@
-import { logger, spawn, SubprocessError, } from '@react-native-harness/tools';
+import { delay, logger, spawn, SubprocessError, waitForAbort, } from '@react-native-harness/tools';
 import { spawn as nodeSpawn } from 'node:child_process';
 import { access, rm } from 'node:fs/promises';
 import { getAvdConfigPath, getAvdDirectory, readAvdConfig, } from './avd-config.js';
 import { ensureAndroidEmulatorAvailable, ensureAndroidSdkPackages, getAdbBinaryPath, getAndroidSystemImagePackage, getAvdManagerBinaryPath, getEmulatorBinaryPath, getHostAndroidSystemImageArch, getRequiredAndroidSdkPackages, } from './environment.js';
-import { getEmulatorStartupArgs, } from './emulator-startup.js';
+import { getEmulatorCpuCores, getEmulatorStartupArgs, } from './emulator-startup.js';
 import { AdbAppNotInstalledError, AdbPermissionGrantError, } from './adb-errors.js';
-const wait = async (ms) => {
-    await new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-};
-const waitForAbort = (signal) => {
-    if (signal.aborted) {
-        return Promise.reject(signal.reason);
-    }
-    return new Promise((_, reject) => {
-        signal.addEventListener('abort', () => {
-            reject(signal.reason);
-        }, { once: true });
-    });
-};
 const waitWithSignal = async (ms, signal) => {
     if (signal.aborted) {
         throw signal.reason;
     }
-    await Promise.race([wait(ms), waitForAbort(signal)]);
+    // Both sides of this race must be torn down explicitly when they lose:
+    // an uncancelled timer keeps a ref'd Timeout alive, and an uncancelled
+    // abort wait leaks a listener on `signal`, which is a session-lifetime
+    // signal here and gets polled against once per second.
+    const timer = delay(ms);
+    const abort = waitForAbort(signal);
+    try {
+        await Promise.race([timer.promise, abort.promise]);
+    }
+    finally {
+        timer.cancel();
+        abort.cancel();
+    }
 };
 const EMULATOR_STARTUP_OBSERVATION_TIMEOUT_MS = 5000;
 const EMULATOR_OUTPUT_BUFFER_LIMIT = 16 * 1024;
@@ -311,9 +308,14 @@ export const createAvd = async ({ name, apiLevel, profile, diskSize, heapSize, }
     ]);
     await ensureAvdIniExists({ name, apiLevel });
     const configPath = await ensureAvdConfigExists(name);
+    // hw.cpu.ncore is baked into config.ini (rather than passed as a `-cores`
+    // boot flag) so it's part of the AVD's persisted hardware profile: boot
+    // snapshots require an identical hardware config to load, so the vCPU
+    // count must be fixed at AVD-creation time and stay consistent across
+    // boots.
     await spawn('bash', [
         '-lc',
-        `printf '%s\n%s\n' 'disk.dataPartition.size=${diskSize}' 'vm.heapSize=${heapSize}' >> "${configPath}"`,
+        `printf '%s\n%s\n%s\n' 'disk.dataPartition.size=${diskSize}' 'vm.heapSize=${heapSize}' 'hw.cpu.ncore=${getEmulatorCpuCores()}' >> "${configPath}"`,
     ]);
 };
 export const deleteAvd = async (name) => {
@@ -375,11 +377,17 @@ export const startEmulator = async (name, mode = 'default-boot') => {
         }
         throw error;
     });
-    const observationTimeout = wait(EMULATOR_STARTUP_OBSERVATION_TIMEOUT_MS).then(() => 'timeout');
+    const observationTimer = delay(EMULATOR_STARTUP_OBSERVATION_TIMEOUT_MS);
+    const observationTimeout = observationTimer.promise.then(() => 'timeout');
     try {
         await Promise.race([earlyExit, observedBoot, observationTimeout]);
     }
     finally {
+        // If `earlyExit` or `observedBoot` won the race, this timer would
+        // otherwise sit ref'd in the event loop for the rest of its 5s;
+        // cancelling here is a no-op on the happy "proceed detached" path
+        // where the timer itself won.
+        observationTimer.cancel();
         cleanup();
     }
     childProcess.stdout?.destroy();
@@ -497,9 +505,10 @@ export const getLogcatTimestamp = async (adbId) => {
     ]);
     return stdout.trim().replace(/^'+|'+$/g, '');
 };
-export const startLogcat = (adbId, args) => spawn(getAdbBinaryPath(), ['-s', adbId, ...args], {
+export const startLogcat = (adbId, args, options) => spawn(getAdbBinaryPath(), ['-s', adbId, ...args], {
     stdout: 'pipe',
     stderr: 'pipe',
+    signal: options?.signal,
 });
 export const DROPBOX_CRASH_TAGS = [
     'data_app_crash',

package/dist/app-session.d.ts

@@ -7,11 +7,20 @@ type CreateAndroidAppSessionOptions = {
     stopApp: () => Promise<void>;
     getAppPid: () => Promise<number | null>;
     getLogcatTimestamp: () => Promise<string>;
-    startLogcat: (args: readonly string[]) => Subprocess;
+    startLogcat: (args: readonly string[], options: {
+        signal: AbortSignal;
+    }) => Subprocess;
     getDropboxOutput?: () => Promise<string>;
     getExitInfo?: () => Promise<string>;
     crashArtifactWriter?: CrashArtifactWriter;
+    /**
+     * Session-lifetime abort signal (see HarnessPlatformInitOptions.signal).
+     * Combined with the app session's own logcatAbortController so that
+     * aborting the session stops the logcat stream even if dispose() hasn't
+     * been called yet (e.g. SIGTERM during teardown of other resources).
+     */
+    signal?: AbortSignal;
 };
-export declare const createAndroidAppSession: ({ appUid, bundleId, startApp, stopApp, getAppPid, getLogcatTimestamp, startLogcat, getDropboxOutput, getExitInfo, crashArtifactWriter, }: CreateAndroidAppSessionOptions) => Promise<AppSession>;
+export declare const createAndroidAppSession: ({ appUid, bundleId, startApp, stopApp, getAppPid, getLogcatTimestamp, startLogcat, getDropboxOutput, getExitInfo, crashArtifactWriter, signal, }: CreateAndroidAppSessionOptions) => Promise<AppSession>;
 export {};
 //# sourceMappingURL=app-session.d.ts.map

package/dist/app-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-session.d.ts","sourceRoot":"","sources":["../src/app-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAEf,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,6BAA6B,CAAC;AAkErC,KAAK,8BAA8B,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,WAAW,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,UAAU,CAAC;IACrD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,0IAW3C,8BAA8B,KAAG,OAAO,CAAC,UAAU,CAsMrD,CAAC"}
+{"version":3,"file":"app-session.d.ts","sourceRoot":"","sources":["../src/app-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAEf,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,6BAA6B,CAAC;AA0DrC,KAAK,8BAA8B,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,WAAW,EAAE,CACX,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,KAC7B,UAAU,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,kJAY3C,8BAA8B,KAAG,OAAO,CAAC,UAAU,CAmNrD,CAAC"}

package/dist/app-session.js

@@ -30,16 +30,8 @@ const isCrashSignal = (line, bundleId) => {
         (line.includes(bundleId) &&
             /fatal|crash|signal 11|signal 6|backtrace/i.test(line)));
 };
-const stopSubprocess = async (child) => {
-    try {
-        (await child.nodeChildProcess).kill();
-    }
-    catch {
-        // Ignore termination failures for already-ended background processes.
-    }
-};
 const isExitedState = (state) => state.status === 'exited';
-export const createAndroidAppSession = async ({ appUid, bundleId, startApp, stopApp, getAppPid, getLogcatTimestamp, startLogcat, getDropboxOutput, getExitInfo, crashArtifactWriter, }) => {
+export const createAndroidAppSession = async ({ appUid, bundleId, startApp, stopApp, getAppPid, getLogcatTimestamp, startLogcat, getDropboxOutput, getExitInfo, crashArtifactWriter, signal, }) => {
     const emitter = createAppSessionEmitter();
     const logBuffer = createBoundedLogBuffer();
     let state = { status: 'running' };
@@ -113,7 +105,20 @@ export const createAndroidAppSession = async ({ appUid, bundleId, startApp, stop
     };
     const logcatTimestamp = await getLogcatTimestamp();
     const sessionStartedAt = Date.now();
-    const logcatProcess = startLogcat(getLogcatArgs(appUid, logcatTimestamp));
+    const logcatAbortController = new AbortController();
+    const logcatSignal = signal
+        ? AbortSignal.any([signal, logcatAbortController.signal])
+        : logcatAbortController.signal;
+    const logcatProcess = startLogcat(getLogcatArgs(appUid, logcatTimestamp), {
+        signal: logcatSignal,
+    });
+    // Aborting is nano-spawn's own cancellation path, so the resulting
+    // SubprocessError is settled the same way regardless of which of the
+    // merged stdout/stderr iterators observes it first. Without this, killing
+    // the underlying process directly can make both iterators reject at once,
+    // and nano-spawn's internal `Promise.race` only reports one of them,
+    // leaving the other an unhandled rejection.
+    logcatProcess.catch(() => undefined);
     const crashReporter = createAndroidCrashReporter({
         bundleId,
         crashArtifactWriter,
@@ -156,7 +161,7 @@ export const createAndroidAppSession = async ({ appUid, bundleId, startApp, stop
         disposed = true;
         stopPolling = true;
         emitter.clear();
-        await stopSubprocess(logcatProcess);
+        logcatAbortController.abort();
         await Promise.allSettled([logTask]);
         throw error;
     }
@@ -196,7 +201,7 @@ export const createAndroidAppSession = async ({ appUid, bundleId, startApp, stop
             }
             cancelPendingPollDelay();
             emitter.clear();
-            await stopSubprocess(logcatProcess);
+            logcatAbortController.abort();
             await stopApp();
             await Promise.allSettled([logTask, pollTask]);
         },

package/dist/avd-config.d.ts

@@ -6,6 +6,7 @@ export type AvdConfig = {
     hwDeviceName?: string;
     diskDataPartitionSize?: string;
     vmHeapSize?: string;
+    hwCpuNcore?: string;
 };
 export type AvdCompatibilityResult = {
     compatible: true;

package/dist/avd-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avd-config.d.ts","sourceRoot":"","sources":["../src/avd-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,GACpB;IAAE,UAAU,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAI9C,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAE/C,CAAC;AAkEF,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,SAyCjD,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,KACX,OAAO,CAAC,SAAS,GAAG,IAAI,CAU1B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,oCAI7B;IACD,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,sBAAsB,CAAC;CAClC,KAAG,sBAmFH,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,yBAGzC;IACD,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,sBAAsB,CAAC;CAClC,KAAG;IACF,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAeH,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,8BAItC;IACD,GAAG,CAAC,EAAE,wBAAwB,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,KAAG,OAWH,CAAC"}
+{"version":3,"file":"avd-config.d.ts","sourceRoot":"","sources":["../src/avd-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAG7E,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,GACpB;IAAE,UAAU,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAI9C,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAE/C,CAAC;AAkEF,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,SA4CjD,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,KACX,OAAO,CAAC,SAAS,GAAG,IAAI,CAU1B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,oCAI7B;IACD,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,sBAAsB,CAAC;CAClC,KAAG,sBA+FH,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,yBAGzC;IACD,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,sBAAsB,CAAC;CAClC,KAAG;IACF,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAeH,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,8BAItC;IACD,GAAG,CAAC,EAAE,wBAAwB,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,KAAG,OAWH,CAAC"}

package/dist/avd-config.js

@@ -1,4 +1,5 @@
 import { access, readFile } from 'node:fs/promises';
+import { getEmulatorCpuCores } from './emulator-startup.js';
 export const getAvdDirectory = (name) => {
     return `${process.env.ANDROID_AVD_HOME ?? `${process.env.HOME}/.android/avd`}/${name}.avd`;
 };
@@ -81,6 +82,9 @@ export const parseAvdConfig = (contents) => {
             case 'vm.heapSize':
                 config.vmHeapSize = value;
                 break;
+            case 'hw.cpu.ncore':
+                config.hwCpuNcore = value;
+                break;
             default:
                 break;
         }
@@ -146,6 +150,13 @@ export const isAvdCompatible = ({ emulator, avdConfig, hostArch, }) => {
             reason: `Heap size mismatch: expected ${requestedAvdConfig.heapSize}, got ${avdConfig.vmHeapSize ?? 'missing'}.`,
         };
     }
+    if (normalizeConfigValue(avdConfig.hwCpuNcore ?? '') !==
+        normalizeConfigValue(String(getEmulatorCpuCores()))) {
+        return {
+            compatible: false,
+            reason: `CPU core count mismatch: expected ${getEmulatorCpuCores()}, got ${avdConfig.hwCpuNcore ?? 'missing'}.`,
+        };
+    }
     return { compatible: true };
 };
 export const getNormalizedAvdCacheConfig = ({ emulator, hostArch, }) => {

package/dist/emulator-startup.d.ts

@@ -1,3 +1,26 @@
 export type EmulatorBootMode = 'default-boot' | 'clean-snapshot-generation' | 'snapshot-reuse';
+/**
+ * Returns the vCPU count baked into an AVD for this runner.
+ *
+ * AVD snapshots require an identical hardware configuration to load, so all
+ * AVD creation, compatibility, and cache-key callers must use this value on
+ * the same host.
+ */
+export declare const getEmulatorCpuCores: () => number;
 export declare const getEmulatorStartupArgs: (name: string, mode: EmulatorBootMode) => string[];
+/**
+ * Parses the output of `emulator -accel-check` to determine whether
+ * hardware acceleration (KVM on Linux, HVF on macOS) is usable. The
+ * emulator prints a message containing "is installed and usable" when
+ * acceleration is available.
+ */
+export declare const isAccelerationUsable: (accelCheckOutput: string) => boolean;
+/**
+ * Runs `emulator -accel-check` and logs a non-fatal warning when hardware
+ * acceleration (KVM/HVF) appears unavailable, in which case the emulator
+ * falls back to very slow software emulation. This check must never fail or
+ * block emulator startup - any error running it is swallowed and only
+ * debug-logged.
+ */
+export declare const warnIfEmulatorAccelerationUnavailable: () => Promise<void>;
 //# sourceMappingURL=emulator-startup.d.ts.map

package/dist/emulator-startup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emulator-startup.d.ts","sourceRoot":"","sources":["../src/emulator-startup.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,2BAA2B,GAC3B,gBAAgB,CAAC;AAUrB,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,MAAM,gBAAgB,KACrB,MAAM,EASR,CAAC"}
+{"version":3,"file":"emulator-startup.d.ts","sourceRoot":"","sources":["../src/emulator-startup.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,2BAA2B,GAC3B,gBAAgB,CAAC;AAErB;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,QAAO,MAEtC,CAAC;AAWF,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,MAAM,gBAAgB,KACrB,MAAM,EASR,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,kBAAkB,MAAM,KAAG,OAE/D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC,QACtC,OAAO,CAAC,IAAI,CA+BrB,CAAC"}