@react-native-harness/platform-android 1.1.0 → 1.2.0-rc.1

package/dist/__tests__/adb.test.js

@@ -2,7 +2,7 @@ import { EventEmitter } from 'node:events';
 import { PassThrough } from 'node:stream';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { SubprocessError } from '@react-native-harness/tools';
-import { createAvd, deleteAvd, emulatorProcess, getAppUid, getLogcatTimestamp, getStartAppArgs, hasAvd, installApp, startEmulator, waitForBoot, waitForEmulatorDisconnect, } from '../adb.js';
+import { createAvd, deleteAvd, emulatorProcess, getAppUid, getLogcatTimestamp, getStartAppArgs, hasAvd, installApp, 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';
@@ -101,6 +101,18 @@ describe('getStartAppArgs', () => {
             '/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
@@ -414,4 +426,84 @@ describe('getStartAppArgs', () => {
         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__/emulator-startup.test.js

@@ -7,6 +7,7 @@ describe('emulator startup modes', () => {
             '-no-snapshot-load',
             '-no-snapshot-save',
         ]));
+        expect(getEmulatorStartupArgs('Pixel_8_API_35', 'default-boot')).not.toEqual(expect.arrayContaining(['-camera-back', 'none']));
     });
     it('builds clean snapshot generation args', () => {
         expect(getEmulatorStartupArgs('Pixel_8_API_35', 'clean-snapshot-generation')).toEqual(expect.arrayContaining(['@Pixel_8_API_35', '-no-snapshot-load']));

package/dist/__tests__/instance.test.js

@@ -293,6 +293,42 @@ describe('Android platform instance', () => {
         expect(installApp).toHaveBeenCalledWith('emulator-5554', appPath);
         fs.rmSync(appPath, { force: true });
     });
+    it('reinstalls the app from HARNESS_APP_PATH when already installed', async () => {
+        const appPath = path.join(os.tmpdir(), 'HarnessPlayground-installed.apk');
+        fs.writeFileSync(appPath, 'apk');
+        vi.stubEnv('HARNESS_APP_PATH', appPath);
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
+        vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        const uninstallApp = vi
+            .spyOn(adb, 'uninstallApp')
+            .mockResolvedValue(undefined);
+        const installApp = vi.spyOn(adb, 'installApp').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        await expect(getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init)).resolves.toBeDefined();
+        expect(uninstallApp).toHaveBeenCalledWith('emulator-5554', 'com.harnessplayground');
+        expect(installApp).toHaveBeenCalledWith('emulator-5554', appPath);
+        fs.rmSync(appPath, { force: true });
+    });
     it('throws a HarnessAppPathError when HARNESS_APP_PATH is missing', async () => {
         vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
         vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
@@ -420,4 +456,98 @@ describe('Android platform instance', () => {
         expect(appMonitor.addListener(listener)).toBeUndefined();
         expect(appMonitor.removeListener(listener)).toBeUndefined();
     });
+    it('grants permissions when permissions are enabled for emulator', async () => {
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
+        vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        const grantPermissions = vi
+            .spyOn(adb, 'grantPermissions')
+            .mockResolvedValue(undefined);
+        const harnessConfigWithPermissions = {
+            ...harnessConfig,
+            permissions: true,
+        };
+        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',
+        }, harnessConfigWithPermissions, init);
+        expect(grantPermissions).toHaveBeenCalledWith('emulator-5554', 'com.harnessplayground');
+    });
+    it('does not grant permissions when permissions are disabled for emulator', async () => {
+        vi.spyOn(await import('../environment.js'), 'ensureAndroidEmulatorEnvironment').mockResolvedValue('/tmp/android-sdk');
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['emulator-5554']);
+        vi.spyOn(adb, 'getEmulatorName').mockResolvedValue('Pixel_8_API_35');
+        vi.spyOn(adb, 'waitForBoot').mockResolvedValue('emulator-5554');
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        const grantPermissions = vi
+            .spyOn(adb, 'grantPermissions')
+            .mockResolvedValue(undefined);
+        await getAndroidEmulatorPlatformInstance({
+            name: 'android',
+            device: {
+                type: 'emulator',
+                name: 'Pixel_8_API_35',
+                avd: {
+                    apiLevel: 35,
+                    profile: 'pixel_8',
+                    diskSize: '1G',
+                    heapSize: '1G',
+                },
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfig, init);
+        expect(grantPermissions).not.toHaveBeenCalled();
+    });
+    it('grants permissions when permissions are enabled for physical device', async () => {
+        vi.spyOn(adb, 'getDeviceIds').mockResolvedValue(['012345']);
+        vi.spyOn(adb, 'getDeviceInfo').mockResolvedValue({
+            manufacturer: 'motorola',
+            model: 'moto g72',
+        });
+        vi.spyOn(adb, 'isAppInstalled').mockResolvedValue(true);
+        vi.spyOn(adb, 'reversePort').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'setHideErrorDialogs').mockResolvedValue(undefined);
+        vi.spyOn(adb, 'getAppUid').mockResolvedValue(10234);
+        vi.spyOn(sharedPrefs, 'applyHarnessDebugHttpHost').mockResolvedValue(undefined);
+        const grantPermissions = vi
+            .spyOn(adb, 'grantPermissions')
+            .mockResolvedValue(undefined);
+        const harnessConfigWithPermissions = {
+            ...harnessConfig,
+            permissions: true,
+        };
+        await getAndroidPhysicalDevicePlatformInstance({
+            name: 'android-device',
+            device: {
+                type: 'physical',
+                manufacturer: 'motorola',
+                model: 'moto g72',
+            },
+            bundleId: 'com.harnessplayground',
+            activityName: '.MainActivity',
+        }, harnessConfigWithPermissions);
+        expect(grantPermissions).toHaveBeenCalledWith('012345', 'com.harnessplayground');
+    });
 });

package/dist/adb-errors.d.ts

@@ -0,0 +1,16 @@
+export declare class AdbError extends Error {
+    constructor(message: string);
+}
+export declare class AdbDeviceNotFoundError extends AdbError {
+    constructor(adbId: string);
+}
+export declare class AdbAppNotInstalledError extends AdbError {
+    constructor(bundleId: string, adbId: string);
+}
+export declare class AdbPermissionGrantError extends AdbError {
+    constructor(bundleId: string, permissions: string[], adbId: string);
+}
+export declare class AdbBinaryNotFoundError extends AdbError {
+    constructor();
+}
+//# sourceMappingURL=adb-errors.d.ts.map

package/dist/adb-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb-errors.d.ts","sourceRoot":"","sources":["../src/adb-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;gBACtC,KAAK,EAAE,MAAM;CAO1B;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAO5C;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM;CAQnE;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;;CAQnD"}

package/dist/adb-errors.js

@@ -0,0 +1,35 @@
+export class AdbError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AdbError';
+    }
+}
+export class AdbDeviceNotFoundError extends AdbError {
+    constructor(adbId) {
+        super(`Android device "${adbId}" not found or not connected. ` +
+            `Run "adb devices" to see available devices.`);
+        this.name = 'AdbDeviceNotFoundError';
+    }
+}
+export class AdbAppNotInstalledError extends AdbError {
+    constructor(bundleId, adbId) {
+        super(`App "${bundleId}" is not installed on device "${adbId}". ` +
+            `Install the app before running tests.`);
+        this.name = 'AdbAppNotInstalledError';
+    }
+}
+export class AdbPermissionGrantError extends AdbError {
+    constructor(bundleId, permissions, adbId) {
+        const permissionList = permissions.join(', ');
+        super(`Failed to grant permissions [${permissionList}] to "${bundleId}" on device "${adbId}". ` +
+            `Verify the app is installed and the device supports these permissions.`);
+        this.name = 'AdbPermissionGrantError';
+    }
+}
+export class AdbBinaryNotFoundError extends AdbError {
+    constructor() {
+        super(`adb binary not found or not accessible. ` +
+            `Ensure Android SDK is properly installed and ANDROID_HOME is set.`);
+        this.name = 'AdbBinaryNotFoundError';
+    }
+}

package/dist/adb-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adb-id.d.ts","sourceRoot":"","sources":["../src/adb-id.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,OAE/C,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,QAAQ,aAAa,KACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CA+BvB,CAAC"}
+{"version":3,"file":"adb-id.d.ts","sourceRoot":"","sources":["../src/adb-id.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,OAE/C,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,QAAQ,aAAa,KACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAmCvB,CAAC"}

package/dist/adb-id.js

@@ -7,6 +7,9 @@ export const getAdbId = async (device) => {
     const adbIds = await adb.getDeviceIds();
     for (const adbId of adbIds) {
         if (isAndroidDeviceEmulator(device)) {
+            if (!isAdbIdEmulator(adbId)) {
+                continue;
+            }
             const emulatorName = await adb.getEmulatorName(adbId);
             if (emulatorName === device.name) {
                 return adbId;

package/dist/adb.d.ts

@@ -30,6 +30,7 @@ export declare const getDeviceInfo: (adbId: string) => Promise<DeviceInfo | null
 export declare const isBootCompleted: (adbId: string) => Promise<boolean>;
 export declare const stopEmulator: (adbId: string) => Promise<void>;
 export declare const installApp: (adbId: string, appPath: string) => Promise<void>;
+export declare const uninstallApp: (adbId: string, bundleId: string) => Promise<void>;
 export declare const hasAvd: (name: string) => Promise<boolean>;
 export declare const createAvd: ({ name, apiLevel, profile, diskSize, heapSize, }: CreateAvdOptions) => Promise<void>;
 export declare const deleteAvd: (name: string) => Promise<void>;
@@ -48,4 +49,5 @@ export type AdbDevice = {
     manufacturer: string;
 };
 export declare const getConnectedDevices: () => Promise<AdbDevice[]>;
+export declare const grantPermissions: (adbId: string, bundleId: string) => Promise<void>;
 //# sourceMappingURL=adb.d.ts.map

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,9 +1,10 @@
-import { spawn, SubprocessError } from '@react-native-harness/tools';
+import { logger, spawn, SubprocessError } 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 { AdbAppNotInstalledError, AdbPermissionGrantError, } from './adb-errors.js';
 const wait = async (ms) => {
     await new Promise((resolve) => {
         setTimeout(resolve, ms);
@@ -27,6 +28,7 @@ const waitWithSignal = async (ms, signal) => {
 };
 const EMULATOR_STARTUP_OBSERVATION_TIMEOUT_MS = 5000;
 const EMULATOR_OUTPUT_BUFFER_LIMIT = 16 * 1024;
+const androidAdbLogger = logger.child('android-adb');
 export const emulatorProcess = {
     startDetachedProcess: (file, args) => nodeSpawn(file, args, {
         detached: true,
@@ -219,6 +221,61 @@ export const getDeviceInfo = async (adbId) => {
     const model = await getShellProperty(adbId, 'ro.product.model');
     return { manufacturer, model };
 };
+const getRequestedPermissions = async (adbId, bundleId) => {
+    const { stdout } = await spawn(getAdbBinaryPath(), [
+        '-s',
+        adbId,
+        'shell',
+        'dumpsys',
+        'package',
+        bundleId,
+    ]);
+    const requestedPermissions = new Set();
+    const lines = stdout.split('\n');
+    let inRequestedPermissionsSection = false;
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (trimmedLine === 'requested permissions:') {
+            inRequestedPermissionsSection = true;
+            continue;
+        }
+        if (!inRequestedPermissionsSection) {
+            continue;
+        }
+        if (trimmedLine === '') {
+            continue;
+        }
+        if (trimmedLine.endsWith(':')) {
+            break;
+        }
+        if (/^[a-zA-Z0-9_.]+$/.test(trimmedLine)) {
+            requestedPermissions.add(trimmedLine);
+            continue;
+        }
+        break;
+    }
+    return [...requestedPermissions];
+};
+const getDangerousPermissions = async (adbId) => {
+    const { stdout } = await spawn(getAdbBinaryPath(), [
+        '-s',
+        adbId,
+        'shell',
+        'pm',
+        'list',
+        'permissions',
+        '-g',
+        '-d',
+    ]);
+    const dangerousPermissions = new Set();
+    for (const match of stdout.matchAll(/permission:([a-zA-Z0-9_.]+)/g)) {
+        const permission = match[1]?.trim();
+        if (permission) {
+            dangerousPermissions.add(permission);
+        }
+    }
+    return dangerousPermissions;
+};
 export const isBootCompleted = async (adbId) => {
     try {
         const bootCompleted = await getShellProperty(adbId, 'sys.boot_completed');
@@ -237,6 +294,9 @@ export const stopEmulator = async (adbId) => {
 export const installApp = async (adbId, appPath) => {
     await spawn(getAdbBinaryPath(), ['-s', adbId, 'install', '-r', appPath]);
 };
+export const uninstallApp = async (adbId, bundleId) => {
+    await spawn(getAdbBinaryPath(), ['-s', adbId, 'uninstall', bundleId]);
+};
 export const hasAvd = async (name) => {
     const avds = await getAvds();
     return avds.includes(name);
@@ -468,3 +528,62 @@ export const getConnectedDevices = async () => {
     }
     return devices;
 };
+export const grantPermissions = async (adbId, bundleId) => {
+    androidAdbLogger.debug('grantPermissions:start %o', {
+        adbId,
+        bundleId,
+    });
+    const isInstalled = await isAppInstalled(adbId, bundleId);
+    if (!isInstalled) {
+        throw new AdbAppNotInstalledError(bundleId, adbId);
+    }
+    const [requestedPermissions, dangerousPermissions] = await Promise.all([
+        getRequestedPermissions(adbId, bundleId),
+        getDangerousPermissions(adbId),
+    ]);
+    const permissions = requestedPermissions.filter((permission) => dangerousPermissions.has(permission));
+    androidAdbLogger.debug('grantPermissions:resolved %o', {
+        adbId,
+        bundleId,
+        requestedPermissions,
+        permissions,
+    });
+    if (permissions.length === 0) {
+        androidAdbLogger.debug('grantPermissions:skip %o', {
+            adbId,
+            bundleId,
+        });
+        return;
+    }
+    const grantCommands = permissions.map((permission) => [
+        '-s',
+        adbId,
+        'shell',
+        'pm',
+        'grant',
+        bundleId,
+        permission,
+    ]);
+    try {
+        androidAdbLogger.debug('grantPermissions:commands %o', {
+            adbId,
+            bundleId,
+            grantCommands,
+        });
+        await Promise.all(grantCommands.map((args) => spawn(getAdbBinaryPath(), args)));
+        androidAdbLogger.debug('grantPermissions:success %o', {
+            adbId,
+            bundleId,
+            permissions,
+        });
+    }
+    catch (error) {
+        androidAdbLogger.debug('grantPermissions:error %o', {
+            adbId,
+            bundleId,
+            permissions,
+            error,
+        });
+        throw new AdbPermissionGrantError(bundleId, permissions, adbId);
+    }
+};

package/dist/emulator-startup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emulator-startup.d.ts","sourceRoot":"","sources":["../src/emulator-startup.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,2BAA2B,GAC3B,gBAAgB,CAAC;AAYrB,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,MAAM,gBAAgB,KACrB,MAAM,EASR,CAAC"}
+{"version":3,"file":"emulator-startup.d.ts","sourceRoot":"","sources":["../src/emulator-startup.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,2BAA2B,GAC3B,gBAAgB,CAAC;AAUrB,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,MAAM,gBAAgB,KACrB,MAAM,EASR,CAAC"}

package/dist/emulator-startup.js

@@ -4,8 +4,6 @@ const COMMON_EMULATOR_ARGS = [
     'swiftshader_indirect',
     '-noaudio',
     '-no-boot-anim',
-    '-camera-back',
-    'none',
 ];
 export const getEmulatorStartupArgs = (name, mode) => {
     const modeArgs = mode === 'clean-snapshot-generation'

package/dist/instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,0BAA0B,EAC/B,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EACL,qBAAqB,EAGtB,MAAM,aAAa,CAAC;AAkKrB,eAAO,MAAM,kCAAkC,GAC7C,QAAQ,qBAAqB,EAC7B,eAAe,aAAa,EAC5B,MAAM,0BAA0B,KAC/B,OAAO,CAAC,qBAAqB,CAkI/B,CAAC;AAEF,eAAO,MAAM,wCAAwC,GACnD,QAAQ,qBAAqB,EAC7B,eAAe,aAAa,KAC3B,OAAO,CAAC,qBAAqB,CAiE/B,CAAC"}
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,0BAA0B,EAC/B,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EACL,qBAAqB,EAGtB,MAAM,aAAa,CAAC;AAgLrB,eAAO,MAAM,kCAAkC,GAC7C,QAAQ,qBAAqB,EAC7B,eAAe,aAAa,EAC5B,MAAM,0BAA0B,KAC/B,OAAO,CAAC,qBAAqB,CA2I/B,CAAC;AAEF,eAAO,MAAM,wCAAwC,GACnD,QAAQ,qBAAqB,EAC7B,eAAe,aAAa,KAC3B,OAAO,CAAC,qBAAqB,CAsE/B,CAAC"}

package/dist/instance.js

@@ -29,6 +29,16 @@ const getHarnessAppPath = () => {
     }
     return appPath;
 };
+const getOptionalHarnessAppPath = () => {
+    const appPath = process.env.HARNESS_APP_PATH;
+    if (!appPath) {
+        return undefined;
+    }
+    if (!fs.existsSync(appPath)) {
+        throw new HarnessAppPathError('invalid', appPath);
+    }
+    return appPath;
+};
 const configureAndroidRuntime = async (adbId, config, harnessConfig) => {
     const metroPort = harnessConfig.metroPort;
     await Promise.all([
@@ -98,6 +108,7 @@ const prepareCachedAvd = async ({ emulatorConfig, signal, }) => {
 export const getAndroidEmulatorPlatformInstance = async (config, harnessConfig, init) => {
     assertAndroidDeviceEmulator(config.device);
     const detectNativeCrashes = harnessConfig.detectNativeCrashes ?? true;
+    const permissionsEnabled = harnessConfig.permissions ?? false;
     const emulatorConfig = config.device;
     const emulatorName = emulatorConfig.name;
     const avdConfig = emulatorConfig.avd;
@@ -141,11 +152,19 @@ export const getAndroidEmulatorPlatformInstance = async (config, harnessConfig,
     }
     androidInstanceLogger.debug('waiting for Android emulator %s to finish booting', adbId);
     const isInstalled = await adb.isAppInstalled(adbId, config.bundleId);
-    if (!isInstalled) {
-        const appPath = getHarnessAppPath();
+    const appPath = getOptionalHarnessAppPath();
+    if (isInstalled && appPath) {
+        await adb.uninstallApp(adbId, config.bundleId);
         await adb.installApp(adbId, appPath);
     }
+    else if (!isInstalled) {
+        const installPath = appPath ?? getHarnessAppPath();
+        await adb.installApp(adbId, installPath);
+    }
     const appUid = await configureAndroidRuntime(adbId, config, harnessConfig);
+    if (permissionsEnabled) {
+        await adb.grantPermissions(adbId, config.bundleId);
+    }
     return {
         startApp: async (options) => {
             await adb.startApp(adbId, config.bundleId, config.activityName, options ??
@@ -187,6 +206,7 @@ export const getAndroidEmulatorPlatformInstance = async (config, harnessConfig,
 export const getAndroidPhysicalDevicePlatformInstance = async (config, harnessConfig) => {
     assertAndroidDevicePhysical(config.device);
     const detectNativeCrashes = harnessConfig.detectNativeCrashes ?? true;
+    const permissionsEnabled = harnessConfig.permissions ?? false;
     const adbId = await getAdbId(config.device);
     if (!adbId) {
         throw new DeviceNotFoundError(getDeviceName(config.device));
@@ -196,6 +216,9 @@ export const getAndroidPhysicalDevicePlatformInstance = async (config, harnessCo
         throw new AppNotInstalledError(config.bundleId, getDeviceName(config.device));
     }
     const appUid = await configureAndroidRuntime(adbId, config, harnessConfig);
+    if (permissionsEnabled) {
+        await adb.grantPermissions(adbId, config.bundleId);
+    }
     return {
         startApp: async (options) => {
             await adb.startApp(adbId, config.bundleId, config.activityName, options ??