@react-native-harness/platform-android 1.4.0 → 1.4.1

package/dist/__tests__/adb.test.js

@@ -1,552 +0,0 @@
-import { EventEmitter } from 'node:events';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { PassThrough } from 'node:stream';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { SubprocessError } from '@react-native-harness/tools';
-vi.unmock('../adb.js');
-import { createAvd, deleteAvd, emulatorProcess, getAppUid, getLogcatTimestamp, getStartAppArgs, hasAvd, installApp, startLogcat, startEmulator, uninstallApp, waitForBoot, waitForEmulatorDisconnect, } from '../adb.js';
-import * as tools from '@react-native-harness/tools';
-import * as environment from '../environment.js';
-import * as avdConfig from '../avd-config.js';
-const createAbortError = () => new DOMException('The operation was aborted', 'AbortError');
-let sdkRoot;
-const createMockChildProcess = () => {
-    const process = new EventEmitter();
-    process.stdout = new PassThrough();
-    process.stderr = new PassThrough();
-    process.unref = vi.fn();
-    return process;
-};
-beforeEach(() => {
-    vi.restoreAllMocks();
-    vi.unstubAllEnvs();
-    sdkRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'android-sdk-'));
-    fs.mkdirSync(path.join(sdkRoot, 'emulator'), { recursive: true });
-    fs.writeFileSync(path.join(sdkRoot, 'emulator', 'emulator'), '');
-    fs.mkdirSync(path.join(sdkRoot, 'platform-tools'), { recursive: true });
-    fs.writeFileSync(path.join(sdkRoot, 'platform-tools', 'adb'), '');
-    vi.stubEnv('ANDROID_HOME', sdkRoot);
-    vi.spyOn(environment, 'ensureAndroidEmulatorAvailable').mockResolvedValue(sdkRoot);
-});
-describe('getStartAppArgs', () => {
-    it('maps supported extras to adb am start flags', () => {
-        expect(getStartAppArgs('com.example.app', '.MainActivity', {
-            extras: {
-                feature_flag: true,
-                user_id: 42,
-                mode: 'debug',
-            },
-        })).toEqual([
-            'shell',
-            'am',
-            'start',
-            '-a',
-            'android.intent.action.MAIN',
-            '-c',
-            'android.intent.category.LAUNCHER',
-            '-n',
-            'com.example.app/.MainActivity',
-            '--ez',
-            'feature_flag',
-            'true',
-            '--ei',
-            'user_id',
-            '42',
-            '--es',
-            'mode',
-            'debug',
-        ]);
-    });
-    it('rejects unsafe integer extras', () => {
-        expect(() => getStartAppArgs('com.example.app', '.MainActivity', {
-            extras: {
-                count: Number.MAX_SAFE_INTEGER + 1,
-            },
-        })).toThrow('must be a safe integer');
-    });
-    it('extracts app uid from pm list packages output', async () => {
-        const spawnSpy = vi.spyOn(tools, 'spawn').mockResolvedValueOnce({
-            stdout: 'package:com.other.app uid:10123\npackage:com.example.app uid:10234\n',
-        });
-        await expect(getAppUid('emulator-5554', 'com.example.app')).resolves.toBe(10234);
-        expect(spawnSpy).toHaveBeenCalledWith(expect.stringMatching(/adb$/), [
-            '-s',
-            'emulator-5554',
-            'shell',
-            'pm',
-            'list',
-            'packages',
-            '-U',
-        ]);
-    });
-    it('reads the device timestamp in logcat format', async () => {
-        const spawnSpy = vi.spyOn(tools, 'spawn').mockResolvedValueOnce({
-            stdout: "'03-12 11:35:08.000'\n",
-        });
-        await expect(getLogcatTimestamp('emulator-5554')).resolves.toBe('03-12 11:35:08.000');
-        expect(spawnSpy).toHaveBeenCalledWith(expect.stringMatching(/adb$/), [
-            '-s',
-            'emulator-5554',
-            'shell',
-            'date',
-            "+'%m-%d %H:%M:%S.000'",
-        ]);
-    });
-    it('starts logcat using the resolved adb binary path', async () => {
-        const subprocess = {};
-        const spawnSpy = vi.spyOn(tools, 'spawn').mockReturnValue(subprocess);
-        expect(startLogcat('emulator-5554', [
-            'logcat',
-            '-v',
-            'threadtime',
-            '-b',
-            'crash',
-        ])).toBe(subprocess);
-        expect(spawnSpy).toHaveBeenCalledWith(expect.stringMatching(/adb$/), [
-            '-s',
-            'emulator-5554',
-            'logcat',
-            '-v',
-            'threadtime',
-            '-b',
-            'crash',
-        ], {
-            stdout: 'pipe',
-            stderr: 'pipe',
-        });
-    });
-    it('checks whether an AVD exists', async () => {
-        vi.spyOn(tools, 'spawn').mockResolvedValue({
-            stdout: 'Pixel_6_API_33\nPixel_8_API_35\n',
-        });
-        await expect(hasAvd('Pixel_8_API_35')).resolves.toBe(true);
-        await expect(hasAvd('Missing_AVD')).resolves.toBe(false);
-    });
-    it('installs the app via adb', async () => {
-        const spawnSpy = vi
-            .spyOn(tools, 'spawn')
-            .mockResolvedValueOnce({});
-        await installApp('emulator-5554', '/tmp/app.apk');
-        expect(spawnSpy).toHaveBeenCalledWith(expect.stringMatching(/adb$/), [
-            '-s',
-            'emulator-5554',
-            'install',
-            '-r',
-            '/tmp/app.apk',
-        ]);
-    });
-    it('uninstalls the app via adb', async () => {
-        const spawnSpy = vi
-            .spyOn(tools, 'spawn')
-            .mockResolvedValueOnce({});
-        await uninstallApp('emulator-5554', 'com.example.app');
-        expect(spawnSpy).toHaveBeenCalledWith(expect.stringMatching(/adb$/), [
-            '-s',
-            'emulator-5554',
-            'uninstall',
-            'com.example.app',
-        ]);
-    });
-    it('creates an AVD and appends config overrides', async () => {
-        vi.spyOn(avdConfig, 'readAvdConfig').mockResolvedValue({});
-        const spawnSpy = vi
-            .spyOn(tools, 'spawn')
-            .mockResolvedValue({})
-            .mockResolvedValueOnce({
-            stdout: 'id: 0 or "pixel_8"\n    Name: Pixel 8\nid: 1 or "pixel_6"\n    Name: Pixel 6\n',
-        });
-        const verifyAndroidEmulatorSdk = vi
-            .spyOn(environment, 'ensureAndroidSdkPackages')
-            .mockResolvedValue('/tmp/android-sdk');
-        vi.spyOn(environment, 'getHostAndroidSystemImageArch').mockReturnValue('x86_64');
-        await createAvd({
-            name: 'Pixel_8_API_35',
-            apiLevel: 35,
-            profile: 'pixel_8',
-            diskSize: '1G',
-            heapSize: '1G',
-        });
-        expect(verifyAndroidEmulatorSdk).toHaveBeenCalledWith([
-            'platform-tools',
-            'emulator',
-            'platforms;android-35',
-            'system-images;android-35;default;x86_64',
-        ]);
-        expect(spawnSpy).toHaveBeenNthCalledWith(1, expect.stringMatching(/avdmanager$/), ['list', 'device']);
-        expect(spawnSpy).toHaveBeenNthCalledWith(2, 'bash', [
-            '-lc',
-            expect.stringContaining('create avd --force --name "Pixel_8_API_35" --package "system-images;android-35;default;x86_64" --device "pixel_8" -p '),
-        ]);
-        expect(spawnSpy).toHaveBeenNthCalledWith(3, 'bash', [
-            '-lc',
-            expect.stringContaining(`'avd.ini.encoding=UTF-8' 'path=`),
-        ]);
-        expect(spawnSpy).toHaveBeenNthCalledWith(4, 'bash', [
-            '-lc',
-            expect.stringContaining(`'disk.dataPartition.size=1G' 'vm.heapSize=1G' >> `),
-        ]);
-    });
-    it('recreates the companion ini file when avdmanager leaves it missing', async () => {
-        vi.spyOn(avdConfig, 'readAvdConfig').mockResolvedValue({});
-        const spawnSpy = vi
-            .spyOn(tools, 'spawn')
-            .mockResolvedValue({})
-            .mockResolvedValueOnce({
-            stdout: 'id: 0 or "pixel_6"\n    Name: Pixel 6\n',
-        });
-        vi.spyOn(environment, 'ensureAndroidSdkPackages').mockResolvedValue('/tmp/android-sdk');
-        vi.spyOn(environment, 'getHostAndroidSystemImageArch').mockReturnValue('x86_64');
-        await createAvd({
-            name: 'Pixel_6_API_35',
-            apiLevel: 35,
-            profile: 'pixel_6',
-            diskSize: '1G',
-            heapSize: '1G',
-        });
-        expect(spawnSpy).toHaveBeenNthCalledWith(3, 'bash', [
-            '-lc',
-            expect.stringContaining(`'avd.ini.encoding=UTF-8' 'path=`),
-        ]);
-        expect(spawnSpy).toHaveBeenNthCalledWith(4, 'bash', [
-            '-lc',
-            expect.stringContaining(`'disk.dataPartition.size=1G' 'vm.heapSize=1G' >> `),
-        ]);
-    });
-    it('throws an actionable error when the requested AVD profile is unavailable', async () => {
-        vi.spyOn(tools, 'spawn').mockResolvedValueOnce({
-            stdout: 'id: 0 or "pixel_8"\n    Name: Pixel 8\nid: 1 or "pixel_6"\n    Name: Pixel 6\n',
-        });
-        vi.spyOn(environment, 'ensureAndroidSdkPackages').mockResolvedValue('/tmp/android-sdk');
-        vi.spyOn(environment, 'getHostAndroidSystemImageArch').mockReturnValue('x86_64');
-        await expect(createAvd({
-            name: 'Pixel_8_Pro_API_35',
-            apiLevel: 35,
-            profile: 'pixel_8_pro',
-            diskSize: '1G',
-            heapSize: '1G',
-        })).rejects.toThrow('Android AVD profile "pixel_8_pro" is not available on this machine. Available profiles: pixel_8, pixel_6');
-    });
-    it('throws a clear error when avdmanager does not create config.ini', async () => {
-        vi.spyOn(avdConfig, 'readAvdConfig').mockResolvedValue(null);
-        vi.spyOn(tools, 'spawn')
-            .mockResolvedValue({})
-            .mockResolvedValueOnce({
-            stdout: 'id: 0 or "pixel_6"\n    Name: Pixel 6\n',
-        });
-        vi.spyOn(environment, 'ensureAndroidSdkPackages').mockResolvedValue('/tmp/android-sdk');
-        vi.spyOn(environment, 'getHostAndroidSystemImageArch').mockReturnValue('x86_64');
-        await expect(createAvd({
-            name: 'Pixel_6_API_35',
-            apiLevel: 35,
-            profile: 'pixel_6',
-            diskSize: '1G',
-            heapSize: '1G',
-        })).rejects.toThrow('Android AVD "Pixel_6_API_35" was created, but config.ini was not found at ');
-    });
-    it('creates an AVD with arm64 system image packages on arm64 hosts', async () => {
-        vi.spyOn(avdConfig, 'readAvdConfig').mockResolvedValue({});
-        vi.spyOn(tools, 'spawn')
-            .mockResolvedValue({})
-            .mockResolvedValueOnce({
-            stdout: 'id: 0 or "pixel_8"\n    Name: Pixel 8\n',
-        });
-        const ensureAndroidSdkPackages = vi
-            .spyOn(environment, 'ensureAndroidSdkPackages')
-            .mockResolvedValue('/tmp/android-sdk');
-        vi.spyOn(environment, 'getHostAndroidSystemImageArch').mockReturnValue('arm64-v8a');
-        await createAvd({
-            name: 'Pixel_8_API_35',
-            apiLevel: 35,
-            profile: 'pixel_8',
-            diskSize: '1G',
-            heapSize: '1G',
-        });
-        expect(ensureAndroidSdkPackages).toHaveBeenCalledWith([
-            'platform-tools',
-            'emulator',
-            'platforms;android-35',
-            'system-images;android-35;default;arm64-v8a',
-        ]);
-    });
-    it.skip('deletes both AVD directory and ini file', async () => {
-        await deleteAvd('Pixel_8_API_35');
-    });
-    it('surfaces emulator stdout when startup fails immediately', async () => {
-        const child = createMockChildProcess();
-        let launcherReadyResolve;
-        const launcherReady = new Promise((resolve) => {
-            launcherReadyResolve = resolve;
-        });
-        vi.spyOn(tools, 'spawn').mockResolvedValue({
-            stdout: 'List of devices attached\n\n',
-        });
-        vi.spyOn(emulatorProcess, 'startDetachedProcess').mockImplementation(() => {
-            launcherReadyResolve?.();
-            return child;
-        });
-        const startPromise = startEmulator('Pixel_8_API_35');
-        await launcherReady;
-        child.stdout.write('Unknown AVD name [Pixel_8_API_35]\n');
-        child.stdout.end();
-        child.stderr.end();
-        child.emit('close', 1, null);
-        await expect(startPromise).rejects.toThrow('Unknown AVD name [Pixel_8_API_35]');
-    });
-    it('surfaces emulator stderr when startup fails immediately', async () => {
-        const child = createMockChildProcess();
-        let launcherReadyResolve;
-        const launcherReady = new Promise((resolve) => {
-            launcherReadyResolve = resolve;
-        });
-        vi.spyOn(tools, 'spawn').mockResolvedValue({
-            stdout: 'List of devices attached\n\n',
-        });
-        vi.spyOn(emulatorProcess, 'startDetachedProcess').mockImplementation(() => {
-            launcherReadyResolve?.();
-            return child;
-        });
-        const startPromise = startEmulator('Pixel_8_API_35');
-        await launcherReady;
-        child.stderr.write('emulator: panic: broken config\n');
-        child.stdout.end();
-        child.stderr.end();
-        child.emit('close', 1, null);
-        await expect(startPromise).rejects.toThrow('emulator: panic: broken config');
-    });
-    it('returns after the emulator appears without waiting for process exit', async () => {
-        vi.useFakeTimers();
-        const child = createMockChildProcess();
-        const spawnSpy = vi.spyOn(tools, 'spawn');
-        spawnSpy
-            .mockResolvedValueOnce({
-            stdout: 'List of devices attached\nemulator-5554\tdevice\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: 'Pixel_8_API_35\n',
-        });
-        vi.spyOn(emulatorProcess, 'startDetachedProcess').mockReturnValue(child);
-        const startPromise = startEmulator('Pixel_8_API_35');
-        await vi.runAllTimersAsync();
-        await expect(startPromise).resolves.toBeUndefined();
-        expect(child.unref).toHaveBeenCalled();
-    });
-    it('passes default boot args to the emulator process', async () => {
-        vi.useFakeTimers();
-        const child = createMockChildProcess();
-        vi.spyOn(tools, 'spawn')
-            .mockResolvedValueOnce({
-            stdout: 'List of devices attached\nemulator-5554\tdevice\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: 'Pixel_8_API_35\n',
-        });
-        const startDetachedProcess = vi
-            .spyOn(emulatorProcess, 'startDetachedProcess')
-            .mockReturnValue(child);
-        const startPromise = startEmulator('Pixel_8_API_35');
-        await vi.runAllTimersAsync();
-        await startPromise;
-        expect(startDetachedProcess).toHaveBeenCalledWith(expect.stringMatching(/emulator$/), expect.arrayContaining(['-no-snapshot-load', '-no-snapshot-save']));
-    });
-    it('passes clean snapshot generation args to the emulator process', async () => {
-        vi.useFakeTimers();
-        const child = createMockChildProcess();
-        vi.spyOn(tools, 'spawn')
-            .mockResolvedValueOnce({
-            stdout: 'List of devices attached\nemulator-5554\tdevice\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: 'Pixel_8_API_35\n',
-        });
-        const startDetachedProcess = vi
-            .spyOn(emulatorProcess, 'startDetachedProcess')
-            .mockReturnValue(child);
-        const startPromise = startEmulator('Pixel_8_API_35', 'clean-snapshot-generation');
-        await vi.runAllTimersAsync();
-        await startPromise;
-        expect(startDetachedProcess).toHaveBeenCalledWith(expect.stringMatching(/emulator$/), expect.arrayContaining(['-no-snapshot-load']));
-        expect(startDetachedProcess.mock.calls[0]?.[1]).not.toContain('-no-snapshot-save');
-    });
-    it('passes snapshot reuse args to the emulator process', async () => {
-        vi.useFakeTimers();
-        const child = createMockChildProcess();
-        vi.spyOn(tools, 'spawn')
-            .mockResolvedValueOnce({
-            stdout: 'List of devices attached\nemulator-5554\tdevice\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: 'Pixel_8_API_35\n',
-        });
-        const startDetachedProcess = vi
-            .spyOn(emulatorProcess, 'startDetachedProcess')
-            .mockReturnValue(child);
-        const startPromise = startEmulator('Pixel_8_API_35', 'snapshot-reuse');
-        await vi.runAllTimersAsync();
-        await startPromise;
-        expect(startDetachedProcess).toHaveBeenCalledWith(expect.stringMatching(/emulator$/), expect.arrayContaining(['-no-snapshot-save']));
-        expect(startDetachedProcess.mock.calls[0]?.[1]).not.toContain('-no-snapshot-load');
-    });
-    it('aborts while waiting for an emulator to boot', async () => {
-        vi.useFakeTimers();
-        vi.spyOn(tools, 'spawn').mockResolvedValue({
-            stdout: 'List of devices attached\n\n',
-        });
-        const controller = new AbortController();
-        const waitPromise = waitForBoot('Pixel_8_API_35', controller.signal);
-        await vi.advanceTimersByTimeAsync(1000);
-        controller.abort(createAbortError());
-        await expect(waitPromise).rejects.toBeInstanceOf(DOMException);
-    });
-    it('aborts while waiting for boot completion', async () => {
-        vi.useFakeTimers();
-        vi.spyOn(tools, 'spawn').mockImplementation((async (_file, args) => {
-            if (args?.[0] === 'devices') {
-                return {
-                    stdout: 'List of devices attached\nemulator-5554\tdevice\n',
-                };
-            }
-            if (args?.includes('emu') && args?.includes('avd') && args?.includes('name')) {
-                return {
-                    stdout: 'Pixel_8_API_35\n',
-                };
-            }
-            if (args?.includes('getprop')) {
-                return {
-                    stdout: '0\n',
-                };
-            }
-            throw new Error(`Unexpected adb call: ${args?.join(' ')}`);
-        }));
-        const controller = new AbortController();
-        const waitPromise = waitForBoot('Pixel_8_API_35', controller.signal);
-        await vi.advanceTimersByTimeAsync(1000);
-        controller.abort(createAbortError());
-        await expect(waitPromise).rejects.toBeInstanceOf(DOMException);
-    });
-    it('treats transient adb shell failures as not-yet-booted', async () => {
-        vi.useFakeTimers();
-        const spawnSpy = vi.spyOn(tools, 'spawn');
-        const transientShellError = Object.assign(new Error('adb shell failed'), {
-            exitCode: 1,
-        });
-        Object.setPrototypeOf(transientShellError, SubprocessError.prototype);
-        spawnSpy
-            .mockResolvedValueOnce({
-            stdout: 'List of devices attached\nemulator-5554\tdevice\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: 'Pixel_8_API_35\n',
-        })
-            .mockRejectedValueOnce(transientShellError)
-            .mockResolvedValueOnce({
-            stdout: 'List of devices attached\nemulator-5554\tdevice\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: 'Pixel_8_API_35\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: '1\n',
-        });
-        const waitPromise = waitForBoot('Pixel_8_API_35', new AbortController().signal);
-        await vi.advanceTimersByTimeAsync(1000);
-        await expect(waitPromise).resolves.toBe('emulator-5554');
-        expect(spawnSpy).toHaveBeenCalledTimes(6);
-    });
-    it('waits for an emulator to disconnect from adb', async () => {
-        vi.useFakeTimers();
-        const spawnSpy = vi.spyOn(tools, 'spawn');
-        spawnSpy
-            .mockResolvedValueOnce({
-            stdout: 'List of devices attached\nemulator-5554\tdevice\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: 'List of devices attached\n\n',
-        });
-        const waitPromise = waitForEmulatorDisconnect('emulator-5554', new AbortController().signal);
-        await vi.advanceTimersByTimeAsync(1000);
-        await expect(waitPromise).resolves.toBeUndefined();
-        expect(spawnSpy).toHaveBeenCalledTimes(2);
-    });
-    it('grants requested dangerous permissions to an app', async () => {
-        const { grantPermissions } = await import('../adb.js');
-        const spawnSpy = vi
-            .spyOn(tools, 'spawn')
-            .mockResolvedValueOnce({
-            stdout: 'package:com.example.app\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: `requested permissions:\n  android.permission.CAMERA\n  android.permission.INTERNET\n  android.permission.ACCESS_FINE_LOCATION\ninstall permissions:\n`,
-        })
-            .mockResolvedValueOnce({
-            stdout: `Dangerous Permissions:\n  permission:android.permission.CAMERA\n  permission:android.permission.ACCESS_FINE_LOCATION\n`,
-        })
-            .mockResolvedValue({
-            stdout: '',
-        });
-        await grantPermissions('emulator-5554', 'com.example.app');
-        expect(spawnSpy).toHaveBeenCalledTimes(5);
-        expect(spawnSpy).toHaveBeenNthCalledWith(1, expect.any(String), [
-            '-s',
-            'emulator-5554',
-            'shell',
-            'pm',
-            'list',
-            'packages',
-            'com.example.app',
-        ]);
-        expect(spawnSpy).toHaveBeenNthCalledWith(2, expect.any(String), [
-            '-s',
-            'emulator-5554',
-            'shell',
-            'dumpsys',
-            'package',
-            'com.example.app',
-        ]);
-        expect(spawnSpy).toHaveBeenNthCalledWith(3, expect.any(String), [
-            '-s',
-            'emulator-5554',
-            'shell',
-            'pm',
-            'list',
-            'permissions',
-            '-g',
-            '-d',
-        ]);
-        expect(spawnSpy).toHaveBeenNthCalledWith(4, expect.any(String), [
-            '-s',
-            'emulator-5554',
-            'shell',
-            'pm',
-            'grant',
-            'com.example.app',
-            'android.permission.CAMERA',
-        ]);
-        expect(spawnSpy).toHaveBeenNthCalledWith(5, expect.any(String), [
-            '-s',
-            'emulator-5554',
-            'shell',
-            'pm',
-            'grant',
-            'com.example.app',
-            'android.permission.ACCESS_FINE_LOCATION',
-        ]);
-    });
-    it('does nothing when the app has no grantable dangerous permissions', async () => {
-        const { grantPermissions } = await import('../adb.js');
-        const spawnSpy = vi
-            .spyOn(tools, 'spawn')
-            .mockResolvedValueOnce({
-            stdout: 'package:com.example.app\n',
-        })
-            .mockResolvedValueOnce({
-            stdout: `requested permissions:\n  android.permission.INTERNET\ninstall permissions:\n`,
-        })
-            .mockResolvedValueOnce({
-            stdout: `Dangerous Permissions:\n  permission:android.permission.CAMERA\n`,
-        });
-        await grantPermissions('emulator-5554', 'com.example.app');
-        expect(spawnSpy).toHaveBeenCalledTimes(3);
-    });
-});

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

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

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

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