android-device.ts

/* eslint-disable no-console */
import { readFile } from 'fs/promises';
import { parseAppMeta, pause, platformApi } from '../src/index';

// You can pass the following command line arguments:
// `npx tsx examples/android-device.ts <app ID> <app path> <CA cert path?> <WireGuard config path?>`

(async () => {
    const android = platformApi({
        platform: 'android',
        runTarget: 'device',
        capabilities: ['root', 'frida', 'wireguard', 'certificate-pinning-bypass'],
    });

    const appId = process.argv[2] || 'de.hafas.android.db';
    const appPath = process.argv[3] || '/path/to/app-files';
    const caCertPath = process.argv[4];
    const wireguardConfigPath = process.argv[5];

    await android.ensureDevice();

    const osVersion = await android.getDeviceAttribute('osVersion');
    console.log('OS version:', osVersion);

    const installedApps = await android.listApps();
    console.log('Installed apps:', installedApps);

    if (caCertPath) await android.installCertificateAuthority(caCertPath);
    if (wireguardConfigPath) await android.setProxy(await readFile(wireguardConfigPath, 'utf8'));

    await android.setClipboard('I copied this.');
    await android.addCalendarEvent({
        title: 'Secret meeting',
        startDate: new Date('2024-01-01T12:00:00'),
        endDate: new Date('2024-01-01T12:12:00'),
    });
    await android.addContact({
        lastName: 'Doe',
        firstName: 'Kim',
        email: 'kim.doe@example.org',
        phoneNumber: '0123456789',
    });
    await android.setDeviceName('honeypotdontcopy');

    const appMeta = await parseAppMeta(`${appPath}/${appId}/${appId}.apk`);
    if (!appMeta) throw new Error('Invalid app.');
    console.log('App:', appMeta.id, '@', appMeta.version);

    console.log('Installed already?', await android.isAppInstalled(appId));

    await android.installApp(`${appPath}/${appId}/${appId}.apk`);
    await android.setAppBackgroundBatteryUsage(appId, 'unrestricted');
    // First, grant all permissions.
    await android.setAppPermissions(appId);
    // Then, revoke the camera and location permissions.
    await android.setAppPermissions(appId, {
        'android.permission.CAMERA': 'deny',
        'android.permission.ACCESS_FINE_LOCATION': 'deny',
        'android.permission.ACCESS_COARSE_LOCATION': 'deny',
        'android.permission.ACCESS_BACKGROUND_LOCATION': 'deny',
    });
    await android.startApp(appId);

    // Give the app some time to start.
    await pause(5000);

    const prefs = await android.getPrefs(appId);
    console.log(prefs);

    await android.clearStuckModals();
    await android.uninstallApp(appId);

    if (caCertPath) await android.removeCertificateAuthority(caCertPath);
    if (wireguardConfigPath) await android.setProxy(null);
})();
/* eslint-enable no-console */