Function resolveAndroidApp

src/platforms/android/app-lifecycle.ts:63–104

(
  device: DeviceInfo,
  app: string,
)

}

export async function resolveAndroidApp(
  device: DeviceInfo,
  app: string,
): Promise<AndroidAppResolution> {
  const trimmed = app.trim();
  if (classifyAndroidAppTarget(trimmed) === 'package') return { type: 'package', value: trimmed };

  const alias = ALIASES[trimmed.toLowerCase()];
  if (alias) return alias;

  const cacheScope = androidAppResolutionScope(device);
  const cached = androidAppResolutionCache.get(cacheScope, trimmed);
  if (cached) return cached;

  const result = await runAndroidAdb(device, ['shell', 'pm', 'list', 'packages']);
  const packages = result.stdout
    .split('\n')
    .map((line: string) => line.replace('package:', '').trim())
    .filter(Boolean);

  const matches = packages.filter((pkg: string) =>
    pkg.toLowerCase().includes(trimmed.toLowerCase()),
  );
  const match = matches[0];
  if (match !== undefined && matches.length === 1) {
    return androidAppResolutionCache.set(cacheScope, trimmed, {
      type: 'package',
      value: match,
    });
  }

  if (matches.length > 1) {
    throw new AppError('INVALID_ARGS', `Multiple packages matched "${app}"`, {
      matches,
      hint: ANDROID_AMBIGUOUS_APP_HINT,
    });
  }

  throw new AppError('APP_NOT_INSTALLED', `No package found matching "${app}"`, {
    hint: ANDROID_APPS_DISCOVERY_HINT,
  });
}

export async function listAndroidApps(
  device: DeviceInfo,