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

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

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

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

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

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

@@ -0,0 +1,119 @@
+import { describe, expect, it } from 'vitest';
+import { collectDropboxArtifacts, filterExitInfo, getBestDropboxArtifact, parseDropboxOutput, } from '../crash-diagnostics.js';
+const javaCrashDropbox = `
+Drop box contents: 1 entries
+Max entries: 1000
+========================================
+2026-03-12 10:30:45.123 data_app_crash (text, 500 bytes)
+Process: com.harnessplayground
+PID: 7777
+Package: com.harnessplayground v1 (1.0)
+java.lang.RuntimeException: boom
+\tat com.harnessplayground.MainActivity.onCreate(MainActivity.kt:38)
+`;
+const nativeCrashDropbox = `
+========================================
+2026-03-12 10:31:10.456 data_app_native_crash (text, 800 bytes)
+Process: com.harnessplayground
+PID: 8888
+signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0xdeadbeef
+Abort message: 'JNI DETECTED ERROR IN APPLICATION'
+backtrace:
+      #00 pc 00001234  /data/app/lib/libapp.so
+`;
+const deviceJavaCrashDropbox = `
+Drop box contents: 8 entries
+Searching for: data_app_crash
+
+========================================
+2026-05-29 10:22:34 data_app_crash (text, 1328 bytes)
+SystemUptimeMs: 79467172
+Process: com.harnessplayground
+PID: 586
+Package: com.harnessplayground v1 (1.0)
+java.lang.RuntimeException: Intentional asynchronous Kotlin crash
+\tat com.harnessplayground.PlaygroundCrashModule.crashFromKotlinAsync(PlaygroundCrashModule.kt:44)
+`;
+describe('collectDropboxArtifacts', () => {
+    it('matches harness playground crashes from merged per-tag dropbox output', async () => {
+        const artifacts = await collectDropboxArtifacts({
+            bundleId: 'com.harnessplayground',
+            getDropboxOutput: async () => deviceJavaCrashDropbox,
+            occurredAt: Date.now(),
+            pid: 586,
+        });
+        expect(artifacts).toHaveLength(1);
+        expect(artifacts[0]).toMatchObject({
+            artifactType: 'dropbox-crash',
+            pid: 586,
+            processName: 'com.harnessplayground',
+        });
+    });
+    it('ignores Dropbox entries older than the session start time', async () => {
+        const artifacts = await collectDropboxArtifacts({
+            bundleId: 'com.harnessplayground',
+            getDropboxOutput: async () => deviceJavaCrashDropbox,
+            minOccurredAt: Date.parse('2026-05-29T10:22:35.000Z'),
+            occurredAt: Date.parse('2026-05-29T10:22:36.000Z'),
+        });
+        expect(artifacts).toHaveLength(0);
+    });
+});
+describe('parseDropboxOutput', () => {
+    it('parses java and native dropbox entries', () => {
+        const entries = parseDropboxOutput(`${javaCrashDropbox}\n${nativeCrashDropbox}`);
+        expect(entries).toHaveLength(2);
+        expect(entries[0]).toMatchObject({
+            tag: 'data_app_crash',
+            pid: 7777,
+        });
+        expect(entries[1]).toMatchObject({
+            tag: 'data_app_native_crash',
+            pid: 8888,
+        });
+        expect(entries[1]?.content).toContain('SIGSEGV');
+    });
+});
+describe('getBestDropboxArtifact', () => {
+    it('prefers the highest-scored artifact', () => {
+        const entries = parseDropboxOutput(`${javaCrashDropbox}\n${nativeCrashDropbox}`);
+        const artifacts = entries.map((entry, index) => ({
+            artifactType: entry.tag === 'data_app_native_crash'
+                ? 'dropbox-native-crash'
+                : 'dropbox-crash',
+            dropboxTag: entry.tag,
+            occurredAt: Date.now(),
+            score: index === 0 ? 100 : 300,
+            summary: entry.content,
+            pid: entry.pid,
+            processName: 'com.harnessplayground',
+        }));
+        expect(getBestDropboxArtifact(artifacts)?.dropboxTag).toBe('data_app_native_crash');
+    });
+});
+describe('filterExitInfo', () => {
+    it('returns matching exit-info records for the target package and pid', () => {
+        const output = `
+ApplicationExitInfo #0:
+  package=com.harnessplayground pid=7777 realUid=10123
+  reason=4 (APP CRASH(NATIVE))
+  timestamp=2026-03-12 10:31:10.456
+ApplicationExitInfo #1:
+  package=com.other.app pid=9999 realUid=10199
+  reason=10 (USER REQUESTED)
+`;
+        const filtered = filterExitInfo({
+            output,
+            bundleId: 'com.harnessplayground',
+            pid: 7777,
+        });
+        expect(filtered).toContain('com.harnessplayground pid=7777');
+        expect(filtered).not.toContain('com.other.app');
+    });
+    it('returns null when no exit-info records exist', () => {
+        expect(filterExitInfo({
+            output: 'No exit info records for com.harnessplayground',
+            bundleId: 'com.harnessplayground',
+        })).toBeNull();
+    });
+});

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

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

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

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

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

@@ -0,0 +1,150 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { createAndroidCrashReporter } from '../crash-reporter.js';
+const javaCrashDropbox = `
+========================================
+2026-03-12 10:30:45.123 data_app_crash (text, 500 bytes)
+Process: com.harnessplayground
+PID: 7777
+Package: com.harnessplayground v1 (1.0)
+java.lang.RuntimeException: boom
+\tat com.harnessplayground.MainActivity.onCreate(MainActivity.kt:38)
+`;
+const nativeCrashDropbox = `
+========================================
+2026-03-12 10:31:10.456 data_app_native_crash (text, 800 bytes)
+Process: com.harnessplayground
+PID: 8888
+signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0xdeadbeef
+Abort message: 'JNI DETECTED ERROR IN APPLICATION'
+backtrace:
+      #00 pc 00001234  /data/app/lib/libapp.so
+`;
+describe('createAndroidCrashReporter', () => {
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('persists the current logcat crash block with the test file path', async () => {
+        vi.useFakeTimers();
+        const persistArtifact = vi.fn(() => '/tmp/.harness/crash-reports/logcat.txt');
+        const reporter = createAndroidCrashReporter({
+            bundleId: 'com.harnessplayground',
+            crashArtifactWriter: {
+                runTimestamp: '2026-03-12T11-35-08-000Z',
+                persistArtifact,
+            },
+            getLogs: () => [
+                { line: 'ordinary crash-buffer line', occurredAt: 1_000 },
+                { line: '--------- beginning of crash', occurredAt: 1_100 },
+                {
+                    line: 'Process: com.harnessplayground, PID: 7777',
+                    occurredAt: 1_100,
+                },
+                { line: 'FATAL EXCEPTION: main', occurredAt: 1_100 },
+            ],
+        });
+        const detailsPromise = reporter.getCrashDetails({
+            occurredAt: 1_100,
+            pid: 7777,
+            testFilePath: '/test/native-crash.test.ts',
+        });
+        await vi.advanceTimersByTimeAsync(100);
+        const details = await detailsPromise;
+        expect(details).toMatchObject({
+            artifactType: 'logcat',
+            artifactPath: '/tmp/.harness/crash-reports/logcat.txt',
+            pid: 7777,
+            processName: 'com.harnessplayground',
+        });
+        expect(persistArtifact).toHaveBeenCalledWith({
+            artifactKind: 'logcat',
+            testFilePath: '/test/native-crash.test.ts',
+            source: {
+                kind: 'text',
+                fileName: 'logcat.txt',
+                text: [
+                    '--------- beginning of crash',
+                    'Process: com.harnessplayground, PID: 7777',
+                    'FATAL EXCEPTION: main',
+                    '',
+                ].join('\n'),
+            },
+        });
+    });
+    it('adds dropbox artifacts as enrichment when logcat evidence is available', async () => {
+        vi.useFakeTimers();
+        const persistArtifact = vi
+            .fn()
+            .mockImplementation(({ artifactKind }) => {
+            return `/tmp/.harness/crash-reports/${artifactKind}.txt`;
+        });
+        const reporter = createAndroidCrashReporter({
+            bundleId: 'com.harnessplayground',
+            crashArtifactWriter: {
+                runTimestamp: '2026-03-12T11-35-08-000Z',
+                persistArtifact,
+            },
+            getLogs: () => [
+                { line: '--------- beginning of crash', occurredAt: 1_100 },
+                {
+                    line: 'Process: com.harnessplayground, PID: 7777',
+                    occurredAt: 1_100,
+                },
+                { line: 'FATAL EXCEPTION: main', occurredAt: 1_100 },
+            ],
+            getDropboxOutput: async () => javaCrashDropbox,
+            getExitInfo: async () => 'ApplicationExitInfo #0:\n  package=com.harnessplayground pid=7777 reason=4 (APP CRASH(NATIVE))',
+        });
+        const detailsPromise = reporter.getCrashDetails({
+            occurredAt: 1_100,
+            pid: 7777,
+            testFilePath: '/test/native-crash.test.ts',
+        });
+        await vi.advanceTimersByTimeAsync(100);
+        const details = await detailsPromise;
+        expect(details).toMatchObject({
+            artifactType: 'logcat',
+            artifactPath: '/tmp/.harness/crash-reports/logcat.txt',
+        });
+        expect(details?.enrichmentArtifacts).toEqual(expect.arrayContaining([
+            {
+                artifactType: 'dropbox-crash',
+                artifactPath: '/tmp/.harness/crash-reports/dropbox-crash.txt',
+            },
+            {
+                artifactType: 'exit-info',
+                artifactPath: '/tmp/.harness/crash-reports/exit-info.txt',
+            },
+        ]));
+    });
+    it('falls back to native dropbox evidence when logcat is empty', async () => {
+        vi.useFakeTimers();
+        const persistArtifact = vi
+            .fn()
+            .mockImplementation(({ artifactKind }) => {
+            return `/tmp/.harness/crash-reports/${artifactKind}.txt`;
+        });
+        const reporter = createAndroidCrashReporter({
+            bundleId: 'com.harnessplayground',
+            crashArtifactWriter: {
+                runTimestamp: '2026-03-12T11-35-08-000Z',
+                persistArtifact,
+            },
+            getLogs: () => [],
+            getDropboxOutput: async () => nativeCrashDropbox,
+        });
+        const detailsPromise = reporter.getCrashDetails({
+            occurredAt: 1_100,
+            pid: 8888,
+            testFilePath: '/test/native-crash.test.ts',
+        });
+        await vi.advanceTimersByTimeAsync(100);
+        const details = await detailsPromise;
+        expect(details).toMatchObject({
+            artifactType: 'dropbox-native-crash',
+            artifactPath: '/tmp/.harness/crash-reports/dropbox-native-crash.txt',
+            pid: 8888,
+            signal: 'SIGSEGV',
+            processName: 'com.harnessplayground',
+        });
+    });
+});

package/dist/__tests__/instance.test.js

@@ -5,6 +5,19 @@ 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 createLogcatProcess = (lines = []) => {
+    const process = {
+        nodeChildProcess: Promise.resolve({
+            kill: vi.fn(),
+        }),
+        [Symbol.asyncIterator]: async function* () {
+            for (const line of lines) {
+                yield line;
+            }
+        },
+    };
+    return process;
+};
 const harnessConfig = {
     metroPort: DEFAULT_METRO_PORT,
 };
@@ -19,6 +32,7 @@ describe('Android platform instance', () => {
     beforeEach(async () => {
         vi.restoreAllMocks();
         vi.unstubAllEnvs();
+        vi.useRealTimers();
         vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorAvailable').mockResolvedValue('/tmp/android-sdk');
     });
     it('reuses a running emulator and does not shut it down on dispose', async () => {
@@ -32,6 +46,7 @@ describe('Android platform instance', () => {
         vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
         vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
         vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
         vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
         vi.spyOn(sharedPrefs, 'clearHarnessDebugHttpHost').mockResolvedValue(undefined);
         vi.spyOn(adb, 'stopApp').mockResolvedValue(undefined);
@@ -68,6 +83,7 @@ describe('Android platform instance', () => {
         vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
         vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
         vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
         vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
         vi.spyOn(sharedPrefs, 'clearHarnessDebugHttpHost').mockResolvedValue(undefined);
         vi.spyOn(adb, 'stopApp').mockResolvedValue(undefined);
@@ -113,6 +129,7 @@ describe('Android platform instance', () => {
         vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
         vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
         vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
         vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
         await expect(getAndroidEmulatorPlatformInstance({
             name: 'android',
@@ -152,6 +169,7 @@ describe('Android platform instance', () => {
         vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
         vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
         vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
         vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
         await expect(getAndroidEmulatorPlatformInstance({
             name: 'android',
@@ -196,6 +214,7 @@ describe('Android platform instance', () => {
         vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
         vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
         vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
         vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
         await expect(getAndroidEmulatorPlatformInstance({
             name: 'android',
@@ -238,6 +257,7 @@ describe('Android platform instance', () => {
         vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
         vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
         vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
         vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
         await expect(getAndroidEmulatorPlatformInstance({
             name: 'android',
@@ -315,7 +335,8 @@ describe('Android platform instance', () => {
             activityName: '.MainActivity',
         }, harnessConfig, init)).rejects.toBeInstanceOf(HarnessEmulatorConfigError);
     });
-    it('returns a noop emulator app monitor when native crash detection is disabled', async () => {
+    it('creates a real emulator app session when native crash detection is disabled', async () => {
+        vi.useFakeTimers();
         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');
@@ -324,7 +345,14 @@ describe('Android platform instance', () => {
         vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
         vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
         vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
         vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        const stopApp = vi.spyOn(adb, 'stopApp').mockResolvedValue(undefined);
+        const startApp = vi.spyOn(adb, 'startApp').mockResolvedValue(undefined);
+        const getAppPid = vi.spyOn(adb, 'getAppPid').mockResolvedValue(4321);
+        const startLogcat = vi
+            .spyOn(adb, 'startLogcat')
+            .mockReturnValue(createLogcatProcess());
         const instance = await getAndroidEmulatorPlatformInstance({
             name: 'android',
             device: {
@@ -341,14 +369,84 @@ describe('Android platform instance', () => {
             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();
+        const appSession = await instance.createAppSession();
+        appSession.addListener(listener);
+        await vi.advanceTimersByTimeAsync(0);
+        expect(startLogcat).toHaveBeenCalledWith('emulator-5554', [
+            'logcat',
+            '-v',
+            'threadtime',
+            '-b',
+            'crash',
+            '--uid=10234',
+            '-T',
+            '01-01 00:00:00.000',
+        ]);
+        expect(startLogcat.mock.invocationCallOrder[0]).toBeLessThan(startApp.mock.invocationCallOrder[0]);
+        await expect(appSession.getState()).resolves.toEqual({
+            status: 'running',
+            pid: 4321,
+        });
+        expect(getAppPid).toHaveBeenCalled();
+        expect(listener).not.toHaveBeenCalled();
+        expect(appSession.removeListener(listener)).toBeUndefined();
+        await expect(appSession.dispose()).resolves.toBeUndefined();
+        expect(stopApp).toHaveBeenCalled();
+    });
+    it('reports an early Android crash from logcat before a PID poll succeeds', async () => {
+        vi.useFakeTimers();
+        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(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'stopApp').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'startApp').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppPid').mockResolvedValue(null);
+        vi.spyOn(adb, 'startLogcat').mockReturnValue(createLogcatProcess([
+            '--------- beginning of crash',
+            'Process: com.harnessplayground, PID: 7777',
+            'FATAL EXCEPTION: main',
+        ]));
+        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);
+        const listener = vi.fn();
+        const appSession = await instance.createAppSession();
+        appSession.addListener(listener);
+        await vi.advanceTimersByTimeAsync(0);
+        expect(appSession.getLogs().map((entry) => entry.line)).toEqual([
+            '--------- beginning of crash',
+            'Process: com.harnessplayground, PID: 7777',
+            'FATAL EXCEPTION: main',
+        ]);
+        await expect(appSession.getState()).resolves.toMatchObject({
+            status: 'exited',
+            pid: 7777,
+            reason: 'observed-exit',
+        });
+        expect(listener).toHaveBeenCalledWith({ type: 'app_exited' });
+        await appSession.dispose();
     });
-    it('returns a noop physical device app monitor when native crash detection is disabled', async () => {
+    it('creates a real physical-device app session when native crash detection is disabled', async () => {
+        vi.useFakeTimers();
         vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['012345']);
         vi.spyOn(adb, 'getDeviceInfo').mockResolvedValue({
             manufacturer: 'motorola',
@@ -358,17 +456,14 @@ describe('Android platform instance', () => {
         vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
         vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
         vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(adb, 'getLogcatTimestamp').mockResolvedValue('01-01 00:00:00.000');
         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();
+        vi.spyOn(adb, 'stopApp').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'startApp').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppPid').mockResolvedValue(8765);
+        const startLogcat = vi
+            .spyOn(adb, 'startLogcat')
+            .mockReturnValue(createLogcatProcess());
         const instance = await getAndroidPhysicalDevicePlatformInstance({
             name: 'android-device',
             device: {
@@ -380,12 +475,26 @@ describe('Android platform instance', () => {
             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();
+        const appSession = await instance.createAppSession();
+        appSession.addListener(listener);
+        await vi.advanceTimersByTimeAsync(0);
+        expect(startLogcat).toHaveBeenCalledWith('012345', [
+            'logcat',
+            '-v',
+            'threadtime',
+            '-b',
+            'crash',
+            '--uid=10234',
+            '-T',
+            '01-01 00:00:00.000',
+        ]);
+        await expect(appSession.getState()).resolves.toEqual({
+            status: 'running',
+            pid: 8765,
+        });
+        expect(listener).not.toHaveBeenCalled();
+        expect(appSession.removeListener(listener)).toBeUndefined();
+        await expect(appSession.dispose()).resolves.toBeUndefined();
     });
     it('grants permissions when permissions are enabled for emulator', async () => {
         vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');

package/dist/adb.d.ts

@@ -40,10 +40,14 @@ export declare const waitForEmulator: (name: string, signal: AbortSignal) => Pro
 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 getAppPid: (adbId: string, bundleId: string) => Promise<number | null>;
 export declare const getAppUid: (adbId: string, bundleId: string) => Promise<number>;
 export declare const setHideErrorDialogs: (adbId: string, hide: boolean) => Promise<void>;
 export declare const getLogcatTimestamp: (adbId: string) => Promise<string>;
 export declare const startLogcat: (adbId: string, args: readonly string[]) => Subprocess;
+export declare const DROPBOX_CRASH_TAGS: readonly ["data_app_crash", "data_app_native_crash"];
+export declare const getDropboxPrint: (adbId: string, tags?: readonly string[]) => Promise<string>;
+export declare const getActivityExitInfo: (adbId: string, bundleId: string) => Promise<string>;
 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":"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"}
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgB5C,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AA2C/B,eAAO,MAAM,eAAe;iCAElB,MAAM,QACN,SAAS,MAAM,EAAE,KACtB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAKjD,CAAC;AAqEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,KAAG,MAAM,EAMpE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CAEd,CAAC;AAgEF,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,CASd,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,OAAO,MAAM,EACb,UAAU,MAAM,EAChB,cAAc,MAAM,EACpB,UAAU,uBAAuB,KAChC,OAAO,CAAC,IAAI,CAMd,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,CASvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CASvB,CAAC;AAMF,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;AA2EF,eAAO,MAAM,eAAe,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAWpE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAE9D,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,OAAO,MAAM,EACb,SAAS,MAAM,KACd,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,eAAO,MAAM,MAAM,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAG1D,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,kDAM7B,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAkBjC,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAkB1D,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,OAAM,gBAAiC,KACtC,OAAO,CAAC,IAAI,CAgFd,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,EACZ,QAAQ,WAAW,KAClB,OAAO,CAAC,MAAM,CAoBhB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,EACb,QAAQ,WAAW,KAClB,OAAO,CAAC,IAAI,CAYd,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EACZ,QAAQ,WAAW,KAClB,OAAO,CAAC,MAAM,CAwBhB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,OAAO,CAEjB,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAsBvB,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,WAAW,GACtB,OAAO,MAAM,EACb,MAAM,SAAS,MAAM,EAAE,KACtB,UAIC,CAAC;AAEL,eAAO,MAAM,kBAAkB,sDAGrB,CAAC;AAEX,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,OAAM,SAAS,MAAM,EAAuB,KAC3C,OAAO,CAAC,MAAM,CAoBhB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,MAAM,CAYhB,CAAC;AAEF,eAAO,MAAM,OAAO,QAAa,OAAO,CAAC,MAAM,EAAE,CAWhD,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;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CAqEd,CAAC"}

package/dist/adb.js

@@ -432,6 +432,9 @@ export const waitForBoot = async (name, signal) => {
     throw signal.reason;
 };
 export const isAppRunning = async (adbId, bundleId) => {
+    return (await getAppPid(adbId, bundleId)) != null;
+};
+export const getAppPid = async (adbId, bundleId) => {
     try {
         const { stdout } = await spawn(getAdbBinaryPath(), [
             '-s',
@@ -440,11 +443,15 @@ export const isAppRunning = async (adbId, bundleId) => {
             'pidof',
             bundleId,
         ]);
-        return stdout.trim() !== '';
+        const pid = stdout
+            .trim()
+            .split(/\s+/)
+            .find((value) => value !== '');
+        return pid ? Number(pid) : null;
     }
     catch (error) {
         if (error instanceof SubprocessError && error.exitCode === 1) {
-            return false;
+            return null;
         }
         throw error;
     }
@@ -494,6 +501,39 @@ export const startLogcat = (adbId, args) => spawn(getAdbBinaryPath(), ['-s', adb
     stdout: 'pipe',
     stderr: 'pipe',
 });
+export const DROPBOX_CRASH_TAGS = [
+    'data_app_crash',
+    'data_app_native_crash',
+];
+export const getDropboxPrint = async (adbId, tags = DROPBOX_CRASH_TAGS) => {
+    // Android treats multiple args after --print as one search string, so each
+    // tag must be queried separately and merged on the host.
+    const outputs = await Promise.all(tags.map(async (tag) => {
+        const { stdout } = await spawn(getAdbBinaryPath(), [
+            '-s',
+            adbId,
+            'shell',
+            'dumpsys',
+            'dropbox',
+            '--print',
+            tag,
+        ]);
+        return stdout;
+    }));
+    return outputs.join('\n');
+};
+export const getActivityExitInfo = async (adbId, bundleId) => {
+    const { stdout } = await spawn(getAdbBinaryPath(), [
+        '-s',
+        adbId,
+        'shell',
+        'dumpsys',
+        'activity',
+        'exit-info',
+        bundleId,
+    ]);
+    return stdout;
+};
 export const getAvds = async () => {
     try {
         const emulatorBinaryPath = await ensureEmulatorInstalled();

package/dist/app-session.d.ts

@@ -0,0 +1,17 @@
+import { type AppSession, type CrashArtifactWriter } from '@react-native-harness/platforms';
+import { type Subprocess } from '@react-native-harness/tools';
+type CreateAndroidAppSessionOptions = {
+    appUid: number;
+    bundleId: string;
+    startApp: () => Promise<void>;
+    stopApp: () => Promise<void>;
+    getAppPid: () => Promise<number | null>;
+    getLogcatTimestamp: () => Promise<string>;
+    startLogcat: (args: readonly string[]) => Subprocess;
+    getDropboxOutput?: () => Promise<string>;
+    getExitInfo?: () => Promise<string>;
+    crashArtifactWriter?: CrashArtifactWriter;
+};
+export declare const createAndroidAppSession: ({ appUid, bundleId, startApp, stopApp, getAppPid, getLogcatTimestamp, startLogcat, getDropboxOutput, getExitInfo, crashArtifactWriter, }: CreateAndroidAppSessionOptions) => Promise<AppSession>;
+export {};
+//# sourceMappingURL=app-session.d.ts.map

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

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