Function launchSimulatorAppWithLogging

src/utils/simulator-steps.ts:176–276

(
  simulatorUuid: string,
  bundleId: string,
  executor: CommandExecutor,
  options?: {
    args?: string[];
    env?: Record<string, string>;
  },
  deps?: {
    spawner?: ProcessSpawner;
  },
)

 * OSLog (Logger) messages are captured separately via `simctl spawn log stream`.
 */
export async function launchSimulatorAppWithLogging(
  simulatorUuid: string,
  bundleId: string,
  executor: CommandExecutor,
  options?: {
    args?: string[];
    env?: Record<string, string>;
  },
  deps?: {
    spawner?: ProcessSpawner;
  },
): Promise<LaunchWithLoggingResult> {
  const validationError = validateLogSubsystem(bundleId);
  if (validationError) {
    return { success: false, error: validationError };
  }

  const spawner = deps?.spawner ?? spawn;

  const logsDir = resolveSimulatorLogDir();
  const ts = formatLogTimestamp();
  const suffix = shortRandomSuffix();
  let logFilePath = path.join(
    logsDir.path,
    `${bundleId}_${ts}_ownerpid${process.pid}_${suffix}.log`,
  );

  let fd: number | undefined;
  try {
    fs.mkdirSync(logsDir.path, { recursive: true });
    scheduleArtifactCreatedSweep(logsDir);
    fd = fs.openSync(logFilePath, 'wx');

    const args = [
      'simctl',
      'launch',
      '--console-pty',
      '--terminate-running-process',
      simulatorUuid,
      bundleId,
    ];
    if (options?.args?.length) {
      args.push(...options.args);
    }

    const spawnOpts: SpawnOptions = {
      stdio: ['ignore', fd, fd],
      detached: true,
    };
    if (options?.env && Object.keys(options.env).length > 0) {
      spawnOpts.env = { ...process.env, ...normalizeSimctlChildEnv(options.env) };
    }

    const child = spawner('xcrun', args, spawnOpts);
    if (child.pid && Number.isInteger(child.pid)) {
      const helperLogFilePath = path.join(
        logsDir.path,
        `${bundleId}_${ts}_helperpid${child.pid}_ownerpid${process.pid}_${suffix}.log`,