@react-native-harness/platform-android 1.1.0 → 1.2.0

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

@@ -1,4 +1,5 @@
 import { type AndroidAppLaunchOptions } from '@react-native-harness/platforms';
+import { type Subprocess } from '@react-native-harness/tools';
 import type { ChildProcessByStdio } from 'node:child_process';
 import type { Readable } from 'node:stream';
 import { type EmulatorBootMode } from './emulator-startup.js';
@@ -30,6 +31,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>;
@@ -41,6 +43,7 @@ export declare const isAppRunning: (adbId: string, bundleId: string) => Promise<
 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 getAvds: () => Promise<string[]>;
 export type AdbDevice = {
     id: string;
@@ -48,4 +51,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);
@@ -430,6 +490,10 @@ export const getLogcatTimestamp = async (adbId) => {
     ]);
     return stdout.trim().replace(/^'+|'+$/g, '');
 };
+export const startLogcat = (adbId, args) => spawn(getAdbBinaryPath(), ['-s', adbId, ...args], {
+    stdout: 'pipe',
+    stderr: 'pipe',
+});
 export const getAvds = async () => {
     try {
         const emulatorBinaryPath = await ensureEmulatorInstalled();
@@ -468,3 +532,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/app-monitor.d.ts.map

@@ -1 +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;AAgTzC,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,iBAgLH,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"}
+{"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;AA+SzC,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,iBA4KH,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"}

package/dist/app-monitor.js

@@ -1,4 +1,4 @@
-import { escapeRegExp, getEmitter, logger, spawn, SubprocessError, } from '@react-native-harness/tools';
+import { escapeRegExp, getEmitter, logger, SubprocessError, } from '@react-native-harness/tools';
 import * as adb from './adb.js';
 import { androidCrashParser } from './crash-parser.js';
 const androidAppMonitorLogger = logger.child('android-app-monitor');
@@ -281,10 +281,7 @@ export const createAndroidAppMonitor = ({ adbId, bundleId, appUid, crashArtifact
     };
     const startLogcat = async () => {
         const logcatTimestamp = await adb.getLogcatTimestamp(adbId);
-        logcatProcess = spawn('adb', ['-s', adbId, ...getLogcatArgs(appUid, logcatTimestamp)], {
-            stdout: 'pipe',
-            stderr: 'pipe',
-        });
+        logcatProcess = adb.startLogcat(adbId, getLogcatArgs(appUid, logcatTimestamp));
         const currentProcess = logcatProcess;
         if (!currentProcess) {
             return;

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 ??