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

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

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

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

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

package/dist/__tests__/adb.test.js

@@ -0,0 +1,72 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getAppUid, getLogcatTimestamp, getStartAppArgs } from '../adb.js';
+import * as tools from '@react-native-harness/tools';
+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('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('adb', [
+            '-s',
+            'emulator-5554',
+            'shell',
+            'date',
+            "+'%m-%d %H:%M:%S.000'",
+        ]);
+    });
+});

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

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

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

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

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

@@ -0,0 +1,202 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import { tmpdir } from 'node:os';
+import { createAndroidAppMonitor, createAndroidLogEvent } from '../app-monitor.js';
+import * as tools from '@react-native-harness/tools';
+import { createCrashArtifactWriter } from '@react-native-harness/tools';
+const createMockSubprocess = () => ({
+    nodeChildProcess: Promise.resolve({
+        kill: vi.fn(),
+    }),
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    [Symbol.asyncIterator]: async function* () { },
+});
+const createStreamingSubprocess = (chunks) => ({
+    nodeChildProcess: Promise.resolve({
+        kill: vi.fn(),
+    }),
+    [Symbol.asyncIterator]: async function* () {
+        for (const { line, delayMs = 0 } of chunks) {
+            if (delayMs > 0) {
+                await new Promise((resolve) => setTimeout(resolve, delayMs));
+            }
+            yield line;
+        }
+    },
+});
+const artifactRoot = fs.mkdtempSync(path.join(tmpdir(), 'rn-harness-android-monitor-artifacts-'));
+afterEach(() => {
+    fs.rmSync(artifactRoot, { recursive: true, force: true });
+    fs.mkdirSync(artifactRoot, { recursive: true });
+});
+describe('createAndroidLogEvent', () => {
+    it('extracts crash details from fatal signal log lines', () => {
+        const event = createAndroidLogEvent('03-12 11:35:08.000  1234  1234 F libc    : Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR) in tid 1234 (com.harnessplayground), pid 1234 (com.harnessplayground)', 'com.harnessplayground');
+        expect(event).toMatchObject({
+            type: 'possible_crash',
+            source: 'logs',
+            crashDetails: {
+                source: 'logs',
+                signal: 'SIGSEGV',
+                summary: '03-12 11:35:08.000  1234  1234 F libc    : Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR) in tid 1234 (com.harnessplayground), pid 1234 (com.harnessplayground)',
+            },
+        });
+    });
+    it('extracts process and pid when AndroidRuntime reports a crash', () => {
+        const event = createAndroidLogEvent('03-12 11:35:09.000  1234  1234 E AndroidRuntime: Process: com.harnessplayground, PID: 1234', 'com.harnessplayground');
+        expect(event).toMatchObject({
+            type: 'possible_crash',
+            pid: 1234,
+            crashDetails: {
+                processName: 'com.harnessplayground',
+                pid: 1234,
+            },
+        });
+    });
+    it('starts logcat from the current device timestamp', async () => {
+        const spawnSpy = vi.spyOn(tools, 'spawn');
+        spawnSpy.mockImplementation(((file, args) => {
+            if (file === 'adb' && args?.includes('date')) {
+                return {
+                    stdout: '03-12 11:35:08.000\n',
+                };
+            }
+            return createMockSubprocess();
+        }));
+        const monitor = createAndroidAppMonitor({
+            adbId: 'emulator-5554',
+            bundleId: 'com.harnessplayground',
+            appUid: 10234,
+        });
+        await monitor.start();
+        await monitor.stop();
+        expect(spawnSpy).toHaveBeenNthCalledWith(2, 'adb', [
+            '-s',
+            'emulator-5554',
+            'logcat',
+            '-v',
+            'threadtime',
+            '-b',
+            'crash',
+            '--uid=10234',
+            '-T',
+            '03-12 11:35:08.000',
+        ], {
+            stdout: 'pipe',
+            stderr: 'pipe',
+        });
+    });
+    it('hydrates crash details with stack lines that arrive after the first crash event', async () => {
+        const spawnSpy = vi.spyOn(tools, 'spawn');
+        spawnSpy.mockImplementation(((file, args) => {
+            if (file === 'adb' && args?.includes('date')) {
+                return {
+                    stdout: '03-12 10:44:40.000\n',
+                };
+            }
+            return createStreamingSubprocess([
+                { line: '--------- beginning of crash' },
+                {
+                    line: '03-12 10:44:40.420 13861 13861 E AndroidRuntime: Process: com.harnessplayground, PID: 13861',
+                },
+                {
+                    line: '03-12 10:44:40.421 13861 13861 E AndroidRuntime: java.lang.RuntimeException: boom',
+                    delayMs: 25,
+                },
+                {
+                    line: '03-12 10:44:40.422 13861 13861 E AndroidRuntime:     at com.harnessplayground.MainActivity.onCreate(MainActivity.kt:42)',
+                    delayMs: 25,
+                },
+            ]);
+        }));
+        const monitor = createAndroidAppMonitor({
+            adbId: 'emulator-5554',
+            bundleId: 'com.harnessplayground',
+            appUid: 10234,
+        });
+        await monitor.start();
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        const details = await monitor.getCrashDetails({
+            pid: 13861,
+            occurredAt: Date.now(),
+        });
+        await monitor.stop();
+        expect(details?.rawLines).toEqual([
+            '--------- beginning of crash',
+            '03-12 10:44:40.420 13861 13861 E AndroidRuntime: Process: com.harnessplayground, PID: 13861',
+            '03-12 10:44:40.421 13861 13861 E AndroidRuntime: java.lang.RuntimeException: boom',
+            '03-12 10:44:40.422 13861 13861 E AndroidRuntime:     at com.harnessplayground.MainActivity.onCreate(MainActivity.kt:42)',
+        ]);
+    });
+    it('persists resolved Android crash blocks into .harness', async () => {
+        const spawnSpy = vi.spyOn(tools, 'spawn');
+        spawnSpy.mockImplementation(((file, args) => {
+            if (file === 'adb' && args?.includes('date')) {
+                return {
+                    stdout: '03-12 10:44:40.000\n',
+                };
+            }
+            return createStreamingSubprocess([
+                { line: '--------- beginning of crash' },
+                {
+                    line: '03-12 10:44:40.420 13861 13861 E AndroidRuntime: Process: com.harnessplayground, PID: 13861',
+                },
+                {
+                    line: '03-12 10:44:40.421 13861 13861 E AndroidRuntime: java.lang.RuntimeException: boom',
+                    delayMs: 20,
+                },
+            ]);
+        }));
+        const monitor = createAndroidAppMonitor({
+            adbId: 'emulator-5554',
+            bundleId: 'com.harnessplayground',
+            appUid: 10234,
+            crashArtifactWriter: createCrashArtifactWriter({
+                runnerName: 'android',
+                platformId: 'android',
+                rootDir: path.join(artifactRoot, '.harness', 'crash-reports'),
+                runTimestamp: '2026-03-12T11-35-08-000Z',
+            }),
+        });
+        await monitor.start();
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        const details = await monitor.getCrashDetails({
+            pid: 13861,
+            occurredAt: Date.now(),
+        });
+        await monitor.stop();
+        expect(details?.artifactPath).toContain('/.harness/crash-reports/');
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        expect(fs.readFileSync(details.artifactPath, 'utf8')).toContain('RuntimeException: boom');
+    });
+    it('can be started again after timestamp lookup fails', async () => {
+        const spawnSpy = vi.spyOn(tools, 'spawn');
+        const timestampError = new Error('date failed');
+        spawnSpy.mockImplementation(((file, args) => {
+            if (file === 'adb' && args?.includes('date')) {
+                if (spawnSpy.mock.calls.filter(([calledFile, calledArgs]) => calledFile === 'adb' &&
+                    Array.isArray(calledArgs) &&
+                    calledArgs.includes('date')).length === 1) {
+                    throw timestampError;
+                }
+                return {
+                    stdout: '03-12 11:35:08.000\n',
+                };
+            }
+            return createMockSubprocess();
+        }));
+        const monitor = createAndroidAppMonitor({
+            adbId: 'emulator-5554',
+            bundleId: 'com.harnessplayground',
+            appUid: 10234,
+        });
+        await expect(monitor.start()).rejects.toThrow(timestampError);
+        await expect(monitor.start()).resolves.toBeUndefined();
+        await monitor.stop();
+        expect(spawnSpy.mock.calls.some(([file, args]) => file === 'adb' &&
+            Array.isArray(args) &&
+            args.includes('logcat') &&
+            args.includes('--uid=10234'))).toBe(true);
+    });
+});

package/dist/__tests__/crash-parser.test.d.ts

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

package/dist/__tests__/crash-parser.test.d.ts.map

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

package/dist/__tests__/crash-parser.test.js

@@ -0,0 +1,45 @@
+import { describe, expect, it } from 'vitest';
+import { androidCrashParser } from '../crash-parser.js';
+describe('androidCrashParser.parse', () => {
+    it('parses an AndroidRuntime crash block into a crash details object', () => {
+        expect(androidCrashParser.parse({
+            contents: [
+                '--------- beginning of crash',
+                '03-12 11:35:09.000  1234  1234 E AndroidRuntime: Process: com.harnessplayground, PID: 1234',
+                '03-12 11:35:09.001  1234  1234 E AndroidRuntime: java.lang.RuntimeException: boom',
+                '03-12 11:35:09.002  1234  1234 E AndroidRuntime:     at com.harnessplayground.MainActivity.onCreate(MainActivity.kt:42)',
+            ].join('\n'),
+            bundleId: 'com.harnessplayground',
+        })).toEqual({
+            source: 'logs',
+            summary: [
+                '--------- beginning of crash',
+                '03-12 11:35:09.000  1234  1234 E AndroidRuntime: Process: com.harnessplayground, PID: 1234',
+                '03-12 11:35:09.001  1234  1234 E AndroidRuntime: java.lang.RuntimeException: boom',
+                '03-12 11:35:09.002  1234  1234 E AndroidRuntime:     at com.harnessplayground.MainActivity.onCreate(MainActivity.kt:42)',
+            ].join('\n'),
+            signal: undefined,
+            exceptionType: 'java.lang.RuntimeException: boom',
+            processName: 'com.harnessplayground',
+            pid: 1234,
+            rawLines: [
+                '--------- beginning of crash',
+                '03-12 11:35:09.000  1234  1234 E AndroidRuntime: Process: com.harnessplayground, PID: 1234',
+                '03-12 11:35:09.001  1234  1234 E AndroidRuntime: java.lang.RuntimeException: boom',
+                '03-12 11:35:09.002  1234  1234 E AndroidRuntime:     at com.harnessplayground.MainActivity.onCreate(MainActivity.kt:42)',
+            ],
+            stackTrace: [
+                '03-12 11:35:09.002  1234  1234 E AndroidRuntime:     at com.harnessplayground.MainActivity.onCreate(MainActivity.kt:42)',
+            ],
+        });
+    });
+    it('extracts fatal signals from a native crash block', () => {
+        expect(androidCrashParser.parse({
+            contents: '03-12 11:35:08.000  1234  1234 F libc    : Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR) in tid 1234 (com.harnessplayground), pid 1234 (com.harnessplayground)',
+            bundleId: 'com.harnessplayground',
+        })).toMatchObject({
+            signal: 'SIGSEGV',
+            processName: 'com.harnessplayground',
+        });
+    });
+});

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,7 +1,9 @@
+import { type AndroidAppLaunchOptions } from '@react-native-harness/platforms';
+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>;
 export declare const stopApp: (adbId: string, bundleId: string) => Promise<void>;
-export declare const startApp: (adbId: string, bundleId: string, activityName: string) => Promise<void>;
+export declare const startApp: (adbId: string, bundleId: string, activityName: string, options?: AndroidAppLaunchOptions) => Promise<void>;
 export declare const getDeviceIds: () => Promise<string[]>;
 export declare const getEmulatorName: (adbId: string) => Promise<string | null>;
 export declare const getShellProperty: (adbId: string, property: string) => Promise<string | null>;
@@ -13,6 +15,9 @@ 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 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>;
+export declare const getLogcatTimestamp: (adbId: string) => Promise<string>;
 export declare const getAvds: () => Promise<string[]>;
 export type AdbDevice = {
     id: string;

package/dist/adb.d.ts.map

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

package/dist/adb.js

@@ -1,4 +1,33 @@
-import { spawn } from '@react-native-harness/tools';
+import { spawn, SubprocessError } from '@react-native-harness/tools';
+export const getStartAppArgs = (bundleId, activityName, options) => {
+    const args = [
+        'shell',
+        'am',
+        'start',
+        '-a',
+        'android.intent.action.MAIN',
+        '-c',
+        'android.intent.category.LAUNCHER',
+        '-n',
+        `${bundleId}/${activityName}`,
+    ];
+    const extras = options?.extras ?? {};
+    for (const [key, value] of Object.entries(extras)) {
+        if (typeof value === 'string') {
+            args.push('--es', key, value);
+            continue;
+        }
+        if (typeof value === 'boolean') {
+            args.push('--ez', key, value ? 'true' : 'false');
+            continue;
+        }
+        if (!Number.isSafeInteger(value)) {
+            throw new Error(`Android app launch option "${key}" must be a safe integer.`);
+        }
+        args.push('--ei', key, value.toString());
+    }
+    return args;
+};
 export const isAppInstalled = async (adbId, bundleId) => {
     const { stdout } = await spawn('adb', [
         '-s',
@@ -23,20 +52,8 @@ export const reversePort = async (adbId, port, hostPort = port) => {
 export const stopApp = async (adbId, bundleId) => {
     await spawn('adb', ['-s', adbId, 'shell', 'am', 'force-stop', bundleId]);
 };
-export const startApp = async (adbId, bundleId, activityName) => {
-    await spawn('adb', [
-        '-s',
-        adbId,
-        'shell',
-        'am',
-        'start',
-        '-a',
-        'android.intent.action.MAIN',
-        '-c',
-        'android.intent.category.LAUNCHER',
-        '-n',
-        `${bundleId}/${activityName}`,
-    ]);
+export const startApp = async (adbId, bundleId, activityName, options) => {
+    await spawn('adb', ['-s', adbId, ...getStartAppArgs(bundleId, activityName, options)]);
 };
 export const getDeviceIds = async () => {
     const { stdout } = await spawn('adb', ['devices']);
@@ -73,14 +90,63 @@ export const stopEmulator = async (adbId) => {
     await spawn('adb', ['-s', adbId, 'emu', 'kill']);
 };
 export const isAppRunning = async (adbId, bundleId) => {
+    try {
+        const { stdout } = await spawn('adb', [
+            '-s',
+            adbId,
+            'shell',
+            'pidof',
+            bundleId,
+        ]);
+        return stdout.trim() !== '';
+    }
+    catch (error) {
+        if (error instanceof SubprocessError && error.exitCode === 1) {
+            return false;
+        }
+        throw error;
+    }
+};
+export const getAppUid = async (adbId, bundleId) => {
     const { stdout } = await spawn('adb', [
         '-s',
         adbId,
         'shell',
-        'pidof',
-        bundleId,
+        'pm',
+        'list',
+        'packages',
+        '-U',
     ]);
-    return stdout.trim() !== '';
+    const line = stdout
+        .split('\n')
+        .find((entry) => entry.includes(`package:${bundleId}`));
+    const match = line?.match(/\buid:(\d+)\b/);
+    if (!match) {
+        throw new Error(`Failed to resolve Android app UID for "${bundleId}".`);
+    }
+    return Number(match[1]);
+};
+export const setHideErrorDialogs = async (adbId, hide) => {
+    await spawn('adb', [
+        '-s',
+        adbId,
+        'shell',
+        'settings',
+        'put',
+        'global',
+        'hide_error_dialogs',
+        hide ? '1' : '0',
+    ]);
+};
+export const getLogcatTimestamp = async (adbId) => {
+    const { stdout } = await spawn('adb', [
+        '-s',
+        adbId,
+        'shell',
+        'date',
+        "+'%m-%d %H:%M:%S.000'",
+    ]);
+    return stdout.trim().replace(/^'+|'+$/g, '');
 };
 export const getAvds = async () => {
     try {

package/dist/app-monitor.d.ts

@@ -0,0 +1,13 @@
+import { type AppMonitor, type AppCrashDetails, type CrashArtifactWriter, type CrashDetailsLookupOptions, type AppMonitorEvent } from '@react-native-harness/platforms';
+declare const createAndroidLogEvent: (line: string, bundleId: string) => AppMonitorEvent | null;
+export declare const createAndroidAppMonitor: ({ adbId, bundleId, appUid, crashArtifactWriter, }: {
+    adbId: string;
+    bundleId: string;
+    appUid: number;
+    crashArtifactWriter?: CrashArtifactWriter;
+}) => AndroidAppMonitor;
+export { createAndroidLogEvent };
+export type AndroidAppMonitor = AppMonitor & {
+    getCrashDetails: (options: CrashDetailsLookupOptions) => Promise<AppCrashDetails | null>;
+};
+//# sourceMappingURL=app-monitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-monitor.d.ts","sourceRoot":"","sources":["../src/app-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EAErB,MAAM,iCAAiC,CAAC;AAuRzC,QAAA,MAAM,qBAAqB,GACzB,MAAM,MAAM,EACZ,UAAU,MAAM,KACf,eAAe,GAAG,IAwEpB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,mDAKrC;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,KAAG,iBAmKH,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,CAAC;AACjC,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG;IAC3C,eAAe,EAAE,CACf,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;CACtC,CAAC"}