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

package/dist/__tests__/instance.test.js

@@ -5,6 +5,23 @@ 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';
+import * as emulatorStartup from '../emulator-startup.js';
+const { getEmulatorCpuCores } = emulatorStartup;
+const createLogcatProcess = (lines = []) => {
+    // Mirrors nano-spawn's real Subprocess, which is both a Promise and an
+    // async iterable, since app-session.ts relies on it being thenable.
+    const process = Object.assign(Promise.resolve(undefined), {
+        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,7 +36,9 @@ describe('Android platform instance', () => {
     beforeEach(async () => {
         vi.restoreAllMocks();
         vi.unstubAllEnvs();
+        vi.useRealTimers();
         vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorAvailable').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(emulatorStartup, 'warnIfEmulatorAccelerationUnavailable').mockResolvedValue(undefined);
     });
     it('reuses a running emulator and does not shut it down on dispose', async () => {
         const ensureAndroidEmulatorEnvironment = vi
@@ -32,6 +51,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 +88,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 +134,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',
@@ -145,6 +167,7 @@ describe('Android platform instance', () => {
             hwDeviceName: 'pixel_8',
             diskDataPartitionSize: '1G',
             vmHeapSize: '1G',
+            hwCpuNcore: String(getEmulatorCpuCores()),
         });
         vi.spyOn(adb, 'startEmulator').mockResolvedValue(undefined);
         vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
@@ -152,6 +175,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 +220,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 +263,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 +341,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 +351,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 +375,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',
+        ], { signal: expect.any(AbortSignal) });
+        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('returns a noop physical device app monitor when native crash detection is disabled', async () => {
+    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('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 +462,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 +481,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',
+        ], { signal: expect.any(AbortSignal) });
+        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,16 @@ 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 startLogcat: (adbId: string, args: readonly string[], options?: {
+    signal?: AbortSignal;
+}) => 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":"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"}

package/dist/adb.js

@@ -1,30 +1,27 @@
-import { logger, spawn, SubprocessError, } from '@react-native-harness/tools';
+import { delay, logger, spawn, SubprocessError, waitForAbort, } from '@react-native-harness/tools';
 import { spawn as nodeSpawn } from 'node:child_process';
 import { access, rm } from 'node:fs/promises';
 import { getAvdConfigPath, getAvdDirectory, readAvdConfig, } from './avd-config.js';
 import { ensureAndroidEmulatorAvailable, ensureAndroidSdkPackages, getAdbBinaryPath, getAndroidSystemImagePackage, getAvdManagerBinaryPath, getEmulatorBinaryPath, getHostAndroidSystemImageArch, getRequiredAndroidSdkPackages, } from './environment.js';
-import { getEmulatorStartupArgs, } from './emulator-startup.js';
+import { getEmulatorCpuCores, getEmulatorStartupArgs, } from './emulator-startup.js';
 import { AdbAppNotInstalledError, AdbPermissionGrantError, } from './adb-errors.js';
-const wait = async (ms) => {
-    await new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-};
-const waitForAbort = (signal) => {
-    if (signal.aborted) {
-        return Promise.reject(signal.reason);
-    }
-    return new Promise((_, reject) => {
-        signal.addEventListener('abort', () => {
-            reject(signal.reason);
-        }, { once: true });
-    });
-};
 const waitWithSignal = async (ms, signal) => {
     if (signal.aborted) {
         throw signal.reason;
     }
-    await Promise.race([wait(ms), waitForAbort(signal)]);
+    // Both sides of this race must be torn down explicitly when they lose:
+    // an uncancelled timer keeps a ref'd Timeout alive, and an uncancelled
+    // abort wait leaks a listener on `signal`, which is a session-lifetime
+    // signal here and gets polled against once per second.
+    const timer = delay(ms);
+    const abort = waitForAbort(signal);
+    try {
+        await Promise.race([timer.promise, abort.promise]);
+    }
+    finally {
+        timer.cancel();
+        abort.cancel();
+    }
 };
 const EMULATOR_STARTUP_OBSERVATION_TIMEOUT_MS = 5000;
 const EMULATOR_OUTPUT_BUFFER_LIMIT = 16 * 1024;
@@ -311,9 +308,14 @@ export const createAvd = async ({ name, apiLevel, profile, diskSize, heapSize, }
     ]);
     await ensureAvdIniExists({ name, apiLevel });
     const configPath = await ensureAvdConfigExists(name);
+    // hw.cpu.ncore is baked into config.ini (rather than passed as a `-cores`
+    // boot flag) so it's part of the AVD's persisted hardware profile: boot
+    // snapshots require an identical hardware config to load, so the vCPU
+    // count must be fixed at AVD-creation time and stay consistent across
+    // boots.
     await spawn('bash', [
         '-lc',
-        `printf '%s\n%s\n' 'disk.dataPartition.size=${diskSize}' 'vm.heapSize=${heapSize}' >> "${configPath}"`,
+        `printf '%s\n%s\n%s\n' 'disk.dataPartition.size=${diskSize}' 'vm.heapSize=${heapSize}' 'hw.cpu.ncore=${getEmulatorCpuCores()}' >> "${configPath}"`,
     ]);
 };
 export const deleteAvd = async (name) => {
@@ -375,11 +377,17 @@ export const startEmulator = async (name, mode = 'default-boot') => {
         }
         throw error;
     });
-    const observationTimeout = wait(EMULATOR_STARTUP_OBSERVATION_TIMEOUT_MS).then(() => 'timeout');
+    const observationTimer = delay(EMULATOR_STARTUP_OBSERVATION_TIMEOUT_MS);
+    const observationTimeout = observationTimer.promise.then(() => 'timeout');
     try {
         await Promise.race([earlyExit, observedBoot, observationTimeout]);
     }
     finally {
+        // If `earlyExit` or `observedBoot` won the race, this timer would
+        // otherwise sit ref'd in the event loop for the rest of its 5s;
+        // cancelling here is a no-op on the happy "proceed detached" path
+        // where the timer itself won.
+        observationTimer.cancel();
         cleanup();
     }
     childProcess.stdout?.destroy();
@@ -432,6 +440,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 +451,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;
     }
@@ -490,10 +505,44 @@ export const getLogcatTimestamp = async (adbId) => {
     ]);
     return stdout.trim().replace(/^'+|'+$/g, '');
 };
-export const startLogcat = (adbId, args) => spawn(getAdbBinaryPath(), ['-s', adbId, ...args], {
+export const startLogcat = (adbId, args, options) => spawn(getAdbBinaryPath(), ['-s', adbId, ...args], {
     stdout: 'pipe',
     stderr: 'pipe',
+    signal: options?.signal,
 });
+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,26 @@
+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[], options: {
+        signal: AbortSignal;
+    }) => Subprocess;
+    getDropboxOutput?: () => Promise<string>;
+    getExitInfo?: () => Promise<string>;
+    crashArtifactWriter?: CrashArtifactWriter;
+    /**
+     * Session-lifetime abort signal (see HarnessPlatformInitOptions.signal).
+     * Combined with the app session's own logcatAbortController so that
+     * aborting the session stops the logcat stream even if dispose() hasn't
+     * been called yet (e.g. SIGTERM during teardown of other resources).
+     */
+    signal?: AbortSignal;
+};
+export declare const createAndroidAppSession: ({ appUid, bundleId, startApp, stopApp, getAppPid, getLogcatTimestamp, startLogcat, getDropboxOutput, getExitInfo, crashArtifactWriter, signal, }: 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;AA0DrC,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,CACX,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,KAC7B,UAAU,CAAC;IAChB,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;IAC1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,kJAY3C,8BAA8B,KAAG,OAAO,CAAC,UAAU,CAmNrD,CAAC"}