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

package/dist/__tests__/instance.test.d.ts.map

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

package/dist/__tests__/instance.test.js

@@ -0,0 +1,423 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { DEFAULT_METRO_PORT, } from '@react-native-harness/config';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { getAndroidEmulatorPlatformInstance, getAndroidPhysicalDevicePlatformInstance, } from '../instance.js';
+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';
+const harnessConfig = {
+    metroPort: DEFAULT_METRO_PORT,
+};
+const harnessConfigWithoutNativeCrashDetection = {
+    metroPort: DEFAULT_METRO_PORT,
+    detectNativeCrashes: false,
+};
+const init = {
+    signal: new AbortController().signal,
+};
+describe('Android platform instance', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllEnvs();
+    });
+    it('reuses a running emulator and does not shut it down on dispose', async () => {
+        const ensureAndroidEmulatorEnvironment = vi
+            .spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment')
+            .mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
+        vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        vi.spyOn(sharedPrefs, 'clearHarnessDebugHttpHost').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'stopApp').mockResolvedValue(undefined);
+        const stopEmulator = vi.spyOn(adb, 'stopEmulator').mockResolvedValue();
+        const instance = await getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init);
+        await instance.dispose();
+        expect(ensureAndroidEmulatorEnvironment).toHaveBeenCalledWith(35);
+        expect(stopEmulator).not.toHaveBeenCalled();
+    });
+    it('creates and boots an emulator when missing and shuts it down on dispose', async () => {
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue([]);
+        vi.spyOn(adb, 'hasAvd').mockResolvedValue(false);
+        const createAvd = vi.spyOn(adb, 'createAvd').mockResolvedValue(undefined);
+        const startEmulator = vi
+            .spyOn(adb, 'startEmulator')
+            .mockResolvedValue(undefined);
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        vi.spyOn(sharedPrefs, 'clearHarnessDebugHttpHost').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'stopApp').mockResolvedValue(undefined);
+        const stopEmulator = vi.spyOn(adb, 'stopEmulator').mockResolvedValue();
+        const instance = await getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init);
+        expect(createAvd).toHaveBeenCalledWith({
+            name: 'Pixel_8_API_35',
+            apiLevel: 35,
+            profile: 'pixel_8',
+            diskSize: '1G',
+            heapSize: '1G',
+        });
+        expect(startEmulator).toHaveBeenCalledWith('Pixel_8_API_35', undefined);
+        await instance.dispose();
+        expect(stopEmulator).toHaveBeenCalledWith('emulator-5554');
+    });
+    it('verifies SDK assets before booting an existing AVD', async () => {
+        const ensureAndroidEmulatorEnvironment = vi
+            .spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment')
+            .mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue([]);
+        vi.spyOn(adb, 'hasAvd').mockResolvedValue(true);
+        const createAvd = vi.spyOn(adb, 'createAvd').mockResolvedValue(undefined);
+        const startEmulator = vi
+            .spyOn(adb, 'startEmulator')
+            .mockResolvedValue(undefined);
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).resolves.toBeDefined();
+        expect(ensureAndroidEmulatorEnvironment).toHaveBeenCalledWith(35);
+        expect(createAvd).not.toHaveBeenCalled();
+        expect(startEmulator).toHaveBeenCalledWith('Pixel_8_API_35', undefined);
+    });
+    it('reuses a compatible cached AVD snapshot when caching is enabled', async () => {
+        vi.stubEnv('HARNESS_AVD_CACHING', 'true');
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue([]);
+        vi.spyOn(adb, 'hasAvd').mockResolvedValue(true);
+        vi.spyOn(avdConfig, 'readAvdConfig').mockResolvedValue({
+            imageSysdir1: 'system-images/android-35/default/arm64-v8a/',
+            abiType: 'arm64-v8a',
+            hwDeviceName: 'pixel_8',
+            diskDataPartitionSize: '1G',
+            vmHeapSize: '1G',
+        });
+        vi.spyOn(adb, 'startEmulator').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                    snapshot: { enabled: false },
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).resolves.toBeDefined();
+        expect(adb.startEmulator).toHaveBeenCalledTimes(1);
+        expect(adb.startEmulator).toHaveBeenCalledWith('Pixel_8_API_35', 'snapshot-reuse');
+    });
+    it('recreates an incompatible cached AVD before the real boot', async () => {
+        vi.stubEnv('HARNESS_AVD_CACHING', 'true');
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue([]);
+        vi.spyOn(adb, 'hasAvd').mockResolvedValue(true);
+        vi.spyOn(avdConfig, 'readAvdConfig').mockResolvedValue({
+            imageSysdir1: 'system-images/android-34/default/x86_64/',
+            abiType: 'x86_64',
+            hwDeviceName: 'pixel_7',
+            diskDataPartitionSize: '2G',
+            vmHeapSize: '2G',
+        });
+        const deleteAvd = vi.spyOn(adb, 'deleteAvd').mockResolvedValue(undefined);
+        const createAvd = vi.spyOn(adb, 'createAvd').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'startEmulator').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        const stopEmulator = vi.spyOn(adb, 'stopEmulator').mockResolvedValue();
+        const waitForEmulatorDisconnect = vi
+            .spyOn(adb, 'waitForEmulatorDisconnect')
+            .mockResolvedValue(undefined);
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                    snapshot: { enabled: true },
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).resolves.toBeDefined();
+        expect(deleteAvd).toHaveBeenCalledWith('Pixel_8_API_35');
+        expect(createAvd).toHaveBeenCalled();
+        expect(stopEmulator).toHaveBeenCalledWith('emulator-5554');
+        expect(waitForEmulatorDisconnect).toHaveBeenCalledWith('emulator-5554', init.signal);
+        expect(adb.startEmulator).toHaveBeenNthCalledWith(1, 'Pixel_8_API_35', 'clean-snapshot-generation');
+        expect(adb.startEmulator).toHaveBeenNthCalledWith(2, 'Pixel_8_API_35', 'snapshot-reuse');
+    });
+    it('generates a snapshot on first run before the test boot', async () => {
+        vi.stubEnv('HARNESS_AVD_CACHING', 'true');
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue([]);
+        vi.spyOn(adb, 'hasAvd').mockResolvedValue(false);
+        vi.spyOn(adb, 'createAvd').mockResolvedValue(undefined);
+        const startEmulator = vi
+            .spyOn(adb, 'startEmulator')
+            .mockResolvedValue(undefined);
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        const stopEmulator = vi.spyOn(adb, 'stopEmulator').mockResolvedValue();
+        const waitForEmulatorDisconnect = vi
+            .spyOn(adb, 'waitForEmulatorDisconnect')
+            .mockResolvedValue(undefined);
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                    snapshot: { enabled: true },
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).resolves.toBeDefined();
+        expect(startEmulator).toHaveBeenNthCalledWith(1, 'Pixel_8_API_35', 'clean-snapshot-generation');
+        expect(stopEmulator).toHaveBeenCalledWith('emulator-5554');
+        expect(waitForEmulatorDisconnect).toHaveBeenCalledWith('emulator-5554', init.signal);
+        expect(startEmulator).toHaveBeenNthCalledWith(2, 'Pixel_8_API_35', 'snapshot-reuse');
+    });
+    it('installs the app from HARNESS_APP_PATH when missing', async () => {
+        const appPath = path.join(os.tmpdir(), 'HarnessPlayground.apk');
+        fs.writeFileSync(appPath, 'apk');
+        vi.stubEnv('HARNESS_APP_PATH', appPath);
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
+        vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(false);
+        const installApp = vi.spyOn(adb, 'installApp').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).resolves.toBeDefined();
+        expect(installApp).toHaveBeenCalledWith('emulator-5554', appPath);
+        fs.rmSync(appPath, { force: true });
+    });
+    it('throws a HarnessAppPathError when HARNESS_APP_PATH is missing', async () => {
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
+        vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(false);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).rejects.toBeInstanceOf(HarnessAppPathError);
+    });
+    it('throws a HarnessAppPathError when HARNESS_APP_PATH points to a missing app', async () => {
+        vi.stubEnv('HARNESS_APP_PATH', '/tmp/missing.apk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
+        vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(false);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).rejects.toBeInstanceOf(HarnessAppPathError);
+    });
+    it('throws a HarnessEmulatorConfigError when the emulator is missing and avd config is absent', async () => {
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue([]);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).rejects.toBeInstanceOf(HarnessEmulatorConfigError);
+    });
+    it('returns a noop emulator app monitor when native crash detection is disabled', async () => {
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
+        vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        const instance = await getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfigWithoutNativeCrashDetection, init);
+        const listener = vi.fn();
+        const appMonitor = instance.createAppMonitor();
+        await expect(appMonitor.start()).resolves.toBeUndefined();
+        await expect(appMonitor.stop()).resolves.toBeUndefined();
+        await expect(appMonitor.dispose()).resolves.toBeUndefined();
+        expect(appMonitor.addListener(listener)).toBeUndefined();
+        expect(appMonitor.removeListener(listener)).toBeUndefined();
+    });
+    it('returns a noop physical device app monitor when native crash detection is disabled', async () => {
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['012345']);
+        vi.spyOn(adb, 'getDeviceInfo').mockResolvedValue({
+            manufacturer: 'motorola',
+            model: 'moto g72',
+        });
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        await expect(getAndroidPhysicalDevicePlatformInstance({
+            name: 'android-device',
+            device: {
+                type: 'physical',
+                manufacturer: 'motorola',
+                model: 'moto g72',
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfigWithoutNativeCrashDetection)).resolves.toBeDefined();
+        const instance = await getAndroidPhysicalDevicePlatformInstance({
+            name: 'android-device',
+            device: {
+                type: 'physical',
+                manufacturer: 'motorola',
+                model: 'moto g72',
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfigWithoutNativeCrashDetection);
+        const listener = vi.fn();
+        const appMonitor = instance.createAppMonitor();
+        await expect(appMonitor.start()).resolves.toBeUndefined();
+        await expect(appMonitor.stop()).resolves.toBeUndefined();
+        await expect(appMonitor.dispose()).resolves.toBeUndefined();
+        expect(appMonitor.addListener(listener)).toBeUndefined();
+        expect(appMonitor.removeListener(listener)).toBeUndefined();
+    });
+});

package/dist/__tests__/shared-prefs.test.d.ts

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

package/dist/__tests__/shared-prefs.test.d.ts.map

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

package/dist/__tests__/shared-prefs.test.js

@@ -0,0 +1,87 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import * as tools from '@react-native-harness/tools';
+import { applyHarnessDebugHttpHost, clearHarnessDebugHttpHost, } from '../shared-prefs.js';
+const bundleId = 'com.example.app';
+const adbId = 'emulator-5554';
+const getWrittenContent = (calls) => {
+    const writeCall = calls.find(([, , options]) => {
+        if (!options || typeof options !== 'object' || !('stdin' in options)) {
+            return false;
+        }
+        return Boolean(options.stdin);
+    });
+    const options = writeCall?.[2];
+    if (!options || typeof options !== 'object' || !('stdin' in options)) {
+        throw new Error('Expected write call options.');
+    }
+    const content = options.stdin;
+    if (!content ||
+        typeof content !== 'object' ||
+        !('string' in content) ||
+        typeof content.string !== 'string') {
+        throw new Error('Expected write call with string stdin.');
+    }
+    return content.string;
+};
+const getWrittenContents = (calls) => calls
+    .filter(([, , options]) => {
+    if (!options || typeof options !== 'object' || !('stdin' in options)) {
+        return false;
+    }
+    return Boolean(options.stdin);
+})
+    .map((call) => getWrittenContent([call]));
+describe('Android shared preferences Metro host override', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('handles empty self-closing map files', async () => {
+        const spawnSpy = vi
+            .spyOn(tools, 'spawn')
+            .mockResolvedValueOnce({
+            stdout: '<?xml version="1.0" encoding="utf-8"?>\n<map />\n',
+        })
+            .mockResolvedValueOnce({});
+        await applyHarnessDebugHttpHost(adbId, bundleId, 'localhost:9090');
+        expect(getWrittenContent(spawnSpy.mock.calls)).toContain('<map>');
+        expect(getWrittenContent(spawnSpy.mock.calls)).toContain('</map>');
+        expect(getWrittenContent(spawnSpy.mock.calls)).toContain('<string name="debug_http_host">localhost:9090</string>');
+    });
+    it('restores the previous debug host on cleanup', async () => {
+        const spawnSpy = vi
+            .spyOn(tools, 'spawn')
+            .mockResolvedValueOnce({
+            stdout: [
+                '<?xml version="1.0" encoding="utf-8"?>',
+                '<map>',
+                '  <string name="debug_http_host">10.0.2.2:8081</string>',
+                '</map>',
+            ].join('\n'),
+        })
+            .mockResolvedValueOnce({})
+            .mockResolvedValueOnce({
+            stdout: [
+                '<?xml version="1.0" encoding="utf-8"?>',
+                '<map>',
+                '  <string name="debug_http_host">10.0.2.2:8081</string>',
+                '  <!-- react-native-harness:debug_http_host:start -->',
+                '  <string name="debug_http_host">localhost:9090</string>',
+                '  <!-- react-native-harness:debug_http_host:end -->',
+                '</map>',
+            ].join('\n'),
+        })
+            .mockResolvedValueOnce({});
+        await applyHarnessDebugHttpHost(adbId, bundleId, 'localhost:9090');
+        await clearHarnessDebugHttpHost(adbId, bundleId);
+        const writes = getWrittenContents(spawnSpy.mock.calls);
+        const firstWrite = writes[0];
+        const secondWrite = writes[1];
+        expect(firstWrite).toEqual(expect.stringContaining('<string name="harness_debug_http_host_backup">10.0.2.2:8081</string>'));
+        expect(firstWrite).toEqual(expect.stringContaining('<string name="debug_http_host">localhost:9090</string>'));
+        expect(firstWrite).toEqual(expect.not.stringContaining('<string name="debug_http_host">10.0.2.2:8081</string>'));
+        expect(secondWrite).toEqual(expect.stringContaining('<string name="debug_http_host">10.0.2.2:8081</string>'));
+        expect(secondWrite).toEqual(expect.not.stringContaining('<string name="harness_debug_http_host_backup">10.0.2.2:8081</string>'));
+        expect(secondWrite).toEqual(expect.not.stringContaining('<!-- react-native-harness:debug_http_host:start -->'));
+        expect(secondWrite).toEqual(expect.not.stringContaining('<string name="debug_http_host">localhost:9090</string>'));
+    });
+});

package/dist/adb.d.ts

@@ -1,4 +1,19 @@
 import { type AndroidAppLaunchOptions } from '@react-native-harness/platforms';
+import type { ChildProcessByStdio } from 'node:child_process';
+import type { Readable } from 'node:stream';
+import { type EmulatorBootMode } from './emulator-startup.js';
+export declare const emulatorProcess: {
+    startDetachedProcess: (file: string, args: readonly string[]) => ChildProcessByStdio<null, Readable, Readable>;
+};
+export type CreateAvdOptions = {
+    name: string;
+    apiLevel: number;
+    profile: string;
+    diskSize: string;
+    heapSize: string;
+};
+export declare const getRequiredEmulatorPackages: (apiLevel: number) => string[];
+export declare const verifyAndroidEmulatorSdk: (apiLevel: number) => Promise<void>;
 export declare const getStartAppArgs: (bundleId: string, activityName: string, options?: AndroidAppLaunchOptions) => string[];
 export declare const isAppInstalled: (adbId: string, bundleId: string) => Promise<boolean>;
 export declare const reversePort: (adbId: string, port: number, hostPort?: number) => Promise<void>;
@@ -14,6 +29,14 @@ export type DeviceInfo = {
 export declare const getDeviceInfo: (adbId: string) => Promise<DeviceInfo | null>;
 export declare const isBootCompleted: (adbId: string) => Promise<boolean>;
 export declare const stopEmulator: (adbId: string) => Promise<void>;
+export declare const installApp: (adbId: string, appPath: string) => Promise<void>;
+export declare const hasAvd: (name: string) => Promise<boolean>;
+export declare const createAvd: ({ name, apiLevel, profile, diskSize, heapSize, }: CreateAvdOptions) => Promise<void>;
+export declare const deleteAvd: (name: string) => Promise<void>;
+export declare const startEmulator: (name: string, mode?: EmulatorBootMode) => Promise<void>;
+export declare const waitForEmulator: (name: string, signal: AbortSignal) => Promise<string>;
+export declare const waitForEmulatorDisconnect: (adbId: string, signal: AbortSignal) => Promise<void>;
+export declare const waitForBoot: (name: string, signal: AbortSignal) => Promise<string>;
 export declare const isAppRunning: (adbId: string, bundleId: string) => Promise<boolean>;
 export declare const getAppUid: (adbId: string, bundleId: string) => Promise<number>;
 export declare const setHideErrorDialogs: (adbId: string, hide: boolean) => Promise<void>;

package/dist/adb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,cAAc,MAAM,EACpB,UAAU,uBAAuB,KAChC,MAAM,EAoCR,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,OAAO,CAWjB,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,WAAU,MAAa,KACtB,OAAO,CAAC,IAAI,CAQd,CAAC;AAEF,eAAO,MAAM,OAAO,GAClB,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,OAAO,MAAM,EACb,UAAU,MAAM,EAChB,cAAc,MAAM,EACpB,UAAU,uBAAuB,KAChC,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,eAAO,MAAM,YAAY,QAAa,OAAO,CAAC,MAAM,EAAE,CAOrD,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,KACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAGvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CASvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,OAAO,MAAM,KACZ,OAAO,CAAC,UAAU,GAAG,IAAI,CAI3B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAGpE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAE9D,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,OAAO,CAiBjB,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,CAoBhB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,EACb,MAAM,OAAO,KACZ,OAAO,CAAC,IAAI,CAWd,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,CAUtE,CAAC;AAEF,eAAO,MAAM,OAAO,QAAa,OAAO,CAAC,MAAM,EAAE,CAUhD,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAa,OAAO,CAAC,SAAS,EAAE,CA8B/D,CAAC"}
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"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"}