Function launchIosSimulatorApp

src/platforms/apple/core/apps.ts:1119–1180

(
  device: DeviceInfo,
  bundleId: string,
  options?: { launchConsole?: string; launchArgs?: string[]; terminateRunningApp?: boolean },
)

}

async function launchIosSimulatorApp(
  device: DeviceInfo,
  bundleId: string,
  options?: { launchConsole?: string; launchArgs?: string[]; terminateRunningApp?: boolean },
): Promise<void> {
  await ensureBootedSimulator(device);

  let consecutiveFBSFailures = 0;
  const MAX_CONSECUTIVE_FBS_FAILURES = 3;

  const launchDeadline = Deadline.fromTimeoutMs(IOS_APP_LAUNCH_TIMEOUT_MS);
  try {
    await retryWithPolicy(
      async ({ deadline: attemptDeadline }) => {
        if (attemptDeadline?.isExpired()) {
          throw new AppError('COMMAND_FAILED', 'App launch deadline exceeded', {
            timeoutMs: IOS_APP_LAUNCH_TIMEOUT_MS,
          });
        }

        const launchArgs = simctlArgs(
          device,
          buildIosSimulatorLaunchArgs(device.id, bundleId, options),
        );
        const result = options?.launchConsole
          ? await runIosSimulatorConsoleLaunch(launchArgs, options.launchConsole)
          : await runXcrun(launchArgs, {
              allowFailure: true,
            });
        if (result.exitCode === 0) return;

        throw new AppError('COMMAND_FAILED', `xcrun exited with code ${result.exitCode}`, {
          cmd: 'xcrun',
          args: launchArgs,
          stdout: result.stdout,
          stderr: result.stderr,
          exitCode: result.exitCode,
        });
      },
      {
        maxAttempts: 10,
        baseDelayMs: 1_000,
        maxDelayMs: 5_000,
        jitter: 0.2,
        shouldRetry(error: unknown) {
          if (!isSimulatorLaunchFBSError(error)) return false;
          consecutiveFBSFailures += 1;
          return consecutiveFBSFailures < MAX_CONSECUTIVE_FBS_FAILURES;
        },
      },
      { deadline: launchDeadline },
    );
  } catch (error) {
    if (isSimulatorLaunchFBSError(error)) {
      const appError = error as AppError;
      const probe = await probeSimulatorLaunchContext(device, bundleId);
      const reason = classifyLaunchFailure(probe);
      appError.details = { ...appError.details, hint: launchFailureHint(reason) };