@react-native-harness/platform-android 1.1.0-rc.2 → 1.1.0-rc.4

package/dist/__tests__/environment.test.js

@@ -0,0 +1,117 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { ensureAndroidAdbAvailable, ensureAndroidEmulatorAvailable, getAndroidSdkRoot, getAndroidSystemImagePackage, getDefaultUnixAndroidSdkRoot, getHostAndroidSystemImageArch, getRequiredAndroidSdkPackages, } from '../environment.js';
+import * as tools from '@react-native-harness/tools';
+describe('Android environment', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllEnvs();
+    });
+    it('skips bootstrapping command-line tools when adb is already installed', async () => {
+        const sdkRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'android-sdk-'));
+        const adbPath = path.join(sdkRoot, 'platform-tools', 'adb');
+        fs.mkdirSync(path.dirname(adbPath), { recursive: true });
+        fs.writeFileSync(adbPath, '');
+        const spawnSpy = vi.spyOn(tools, 'spawn');
+        await expect(ensureAndroidAdbAvailable({
+            env: { ANDROID_HOME: sdkRoot },
+        })).resolves.toBe(sdkRoot);
+        expect(spawnSpy).not.toHaveBeenCalled();
+        fs.rmSync(sdkRoot, { force: true, recursive: true });
+    });
+    it('installs only platform-tools when adb is missing', async () => {
+        const sdkRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'android-sdk-'));
+        const sdkManagerDirectory = path.join(sdkRoot, 'cmdline-tools', 'latest', 'bin');
+        fs.mkdirSync(sdkManagerDirectory, { recursive: true });
+        fs.writeFileSync(path.join(sdkManagerDirectory, 'sdkmanager'), '');
+        fs.writeFileSync(path.join(sdkManagerDirectory, 'avdmanager'), '');
+        const spawnSpy = vi.spyOn(tools, 'spawn').mockImplementation((async (command, args) => {
+            if (command === 'bash' && typeof args?.[1] === 'string') {
+                const commandString = args[1];
+                if (commandString.includes('platform-tools')) {
+                    const adbPath = path.join(sdkRoot, 'platform-tools', 'adb');
+                    fs.mkdirSync(path.dirname(adbPath), { recursive: true });
+                    fs.writeFileSync(adbPath, '');
+                }
+            }
+            return {};
+        }));
+        await expect(ensureAndroidAdbAvailable({
+            env: { ANDROID_HOME: sdkRoot },
+        })).resolves.toBe(sdkRoot);
+        expect(spawnSpy).toHaveBeenCalledWith('bash', ['-lc', expect.stringContaining('platform-tools')], expect.any(Object));
+        expect(spawnSpy.mock.calls.some(([command, args]) => command === 'bash' &&
+            typeof args?.[1] === 'string' &&
+            args[1].includes('platform-tools') &&
+            args[1].includes('emulator'))).toBe(false);
+        fs.rmSync(sdkRoot, { force: true, recursive: true });
+    });
+    it('installs emulator only when emulator is missing', async () => {
+        const sdkRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'android-sdk-'));
+        const sdkManagerDirectory = path.join(sdkRoot, 'cmdline-tools', 'latest', 'bin');
+        fs.mkdirSync(sdkManagerDirectory, { recursive: true });
+        fs.writeFileSync(path.join(sdkManagerDirectory, 'sdkmanager'), '');
+        fs.writeFileSync(path.join(sdkManagerDirectory, 'avdmanager'), '');
+        const spawnSpy = vi.spyOn(tools, 'spawn').mockImplementation((async (command, args) => {
+            if (command === 'bash' && typeof args?.[1] === 'string') {
+                const commandString = args[1];
+                if (commandString.includes('emulator')) {
+                    const emulatorPath = path.join(sdkRoot, 'emulator', 'emulator');
+                    fs.mkdirSync(path.dirname(emulatorPath), { recursive: true });
+                    fs.writeFileSync(emulatorPath, '');
+                }
+            }
+            return {};
+        }));
+        await expect(ensureAndroidEmulatorAvailable({
+            env: { ANDROID_HOME: sdkRoot },
+        })).resolves.toBe(sdkRoot);
+        expect(spawnSpy).toHaveBeenCalledWith('bash', ['-lc', expect.stringContaining('emulator')], expect.any(Object));
+        fs.rmSync(sdkRoot, { force: true, recursive: true });
+    });
+    it('uses the default Unix SDK root when env vars are missing', () => {
+        expect(getDefaultUnixAndroidSdkRoot({
+            platform: 'darwin',
+            homeDirectory: '/Users/tester',
+        })).toBe('/Users/tester/Library/Android/sdk');
+        expect(getAndroidSdkRoot({}, {
+            platform: 'linux',
+            homeDirectory: '/home/tester',
+        })).toBe('/home/tester/Android/Sdk');
+    });
+    it('prefers ANDROID_HOME and ANDROID_SDK_ROOT over default paths', () => {
+        expect(getAndroidSdkRoot({
+            ANDROID_HOME: '/env/android-home',
+            ANDROID_SDK_ROOT: '/env/android-sdk-root',
+        }, {
+            platform: 'darwin',
+            homeDirectory: '/Users/tester',
+        })).toBe('/env/android-home');
+        expect(getAndroidSdkRoot({
+            ANDROID_SDK_ROOT: '/env/android-sdk-root',
+        }, {
+            platform: 'linux',
+            homeDirectory: '/home/tester',
+        })).toBe('/env/android-sdk-root');
+    });
+    it('selects Android packages using the host architecture', () => {
+        expect(getHostAndroidSystemImageArch('x64')).toBe('x86_64');
+        expect(getHostAndroidSystemImageArch('arm64')).toBe('arm64-v8a');
+        expect(getAndroidSystemImagePackage(35, 'x86_64')).toBe('system-images;android-35;default;x86_64');
+        expect(getAndroidSystemImagePackage(35, 'arm64-v8a')).toBe('system-images;android-35;default;arm64-v8a');
+    });
+    it('derives emulator package requirements from runner config fields', () => {
+        expect(getRequiredAndroidSdkPackages({
+            apiLevel: 34,
+            includeEmulator: true,
+            architecture: 'x86_64',
+        })).toEqual([
+            'platform-tools',
+            'emulator',
+            'platforms;android-34',
+            'system-images;android-34;default;x86_64',
+        ]);
+    });
+});

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

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

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).not.toHaveBeenCalled();
+        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__/targets.test.d.ts

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

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

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

package/dist/__tests__/targets.test.js

@@ -0,0 +1,49 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { getRunTargets } from '../targets.js';
+import * as adb from '../adb.js';
+import * as environment from '../environment.js';
+describe('Android target discovery', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllEnvs();
+    });
+    it('installs adb and emulator only for discovery', async () => {
+        const ensureAndroidAdbAvailable = vi
+            .spyOn(environment, 'ensureAndroidAdbAvailable')
+            .mockResolvedValue('/tmp/android-sdk');
+        const ensureAndroidEmulatorAvailable = vi
+            .spyOn(environment, 'ensureAndroidEmulatorAvailable')
+            .mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getAvds').mockResolvedValue(['Pixel_8_API_35']);
+        vi.spyOn(adb, 'getConnectedDevices').mockResolvedValue([
+            {
+                id: 'device-1',
+                manufacturer: 'Google',
+                model: 'Pixel 8',
+            },
+        ]);
+        await expect(getRunTargets()).resolves.toEqual([
+            {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                platform: 'android',
+                description: 'Android emulator',
+                device: {
+                    name: 'Pixel_8_API_35',
+                },
+            },
+            {
+                type: 'physical',
+                name: 'Google Pixel 8',
+                platform: 'android',
+                description: 'Physical device (device-1)',
+                device: {
+                    manufacturer: 'Google',
+                    model: 'Pixel 8',
+                },
+            },
+        ]);
+        expect(ensureAndroidAdbAvailable).toHaveBeenCalledTimes(1);
+        expect(ensureAndroidEmulatorAvailable).toHaveBeenCalledTimes(1);
+    });
+});

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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"}