Function startTrackedOsLogStream

src/utils/simulator-steps.ts:338–422

(
  simulatorUuid: string,
  bundleId: string,
  logsDir: ResolvedSimulatorLogDir,
  spawner: ProcessSpawner,
)

}

async function startTrackedOsLogStream(
  simulatorUuid: string,
  bundleId: string,
  logsDir: ResolvedSimulatorLogDir,
  spawner: ProcessSpawner,
): Promise<string | undefined> {
  const ts = formatLogTimestamp();
  const suffix = shortRandomSuffix();
  let osLogFilePath = path.join(
    logsDir.path,
    `${bundleId}_oslog_${ts}_ownerpid${process.pid}_${suffix}.log`,
  );

  let fd: number | undefined;
  try {
    const cleanupResult = await stopSimulatorLaunchOsLogSessionsForApp(
      simulatorUuid,
      bundleId,
      1000,
    );
    if (cleanupResult.errorCount > 0) {
      log(
        'warn',
        `Skipping OSLog stream start after cleanup failure: ${cleanupResult.errors.join('; ')}`,
      );
      return undefined;
    }

    scheduleArtifactCreatedSweep(logsDir);
    fd = fs.openSync(osLogFilePath, 'wx');

    const child = spawner(
      'xcrun',
      [
        'simctl',
        'spawn',
        simulatorUuid,
        'log',
        'stream',
        '--level=debug',
        '--predicate',
        `subsystem == "${bundleId}"`,
      ],
      {
        stdio: ['ignore', fd, fd],
        detached: true,
      },
    );
    if (child.pid && Number.isInteger(child.pid)) {
      const helperOsLogFilePath = path.join(
        logsDir.path,
        `${bundleId}_oslog_${ts}_helperpid${child.pid}_ownerpid${process.pid}_${suffix}.log`,
      );
      osLogFilePath = renameHelperLogPathOrThrow(osLogFilePath, helperOsLogFilePath, child);
    }

    try {
      await registerSimulatorLaunchOsLogSession({