@hot-updater/apple-helper 0.25.8 → 0.25.10

package/dist/index.js

@@ -6,6 +6,7 @@ import { ExecaError, execa } from "execa";
 import { mkdtemp } from "node:fs/promises";
 import os, { tmpdir } from "node:os";
 import { join } from "node:path";
+import { pipeline } from "stream/promises";
 
 //#region src/utils/cocoapods.ts
 const installPodsIfNeeded = async (sourceDir) => {
@@ -71,26 +72,6 @@ const createRandomTmpDir = async (prefix = "apple-helper-") => {
 	return await mkdtemp(join(tmpdir(), prefix));
 };
 
-//#endregion
-//#region src/utils/createXcodebuildLogger.ts
-const createXcodebuildLogger = () => new BuildLogger({
-	failurePatterns: ["BUILD FAILED", "ARCHIVE FAILED"],
-	importantLogPatterns: [
-		"error:",
-		"** BUILD FAILED **",
-		"** ARCHIVE FAILED **",
-		"The following build commands failed:"
-	],
-	progressMapping: [
-		[["[CP-User] [RN]Check rncore"], 10],
-		[["[CP-User] [Hermes] Replace Hermes"], 35],
-		[["[CP-User] [RN]Check FBReactNativeSpec"], 53],
-		[["React-FabricComponents"], 66],
-		[["[CP] Check Pods Manifest.lock"], 90],
-		[["BUILD SUCCEEDED", "ARCHIVE SUCCEEDED"], 100]
-	]
-});
-
 //#endregion
 //#region src/utils/platform.ts
 /**
@@ -171,56 +152,213 @@ const prettifyXcodebuildError = (error) => {
 	return /* @__PURE__ */ new Error(`Xcodebuild failed: ${error}`);
 };
 
+//#endregion
+//#region src/utils/createXcodebuildLogger.ts
+const createXcodebuildLogger = ({ logPrefix }) => new BuildLogger({
+	logPrefix,
+	importantLogPatterns: [
+		"error:",
+		"** BUILD FAILED **",
+		"** ARCHIVE FAILED **",
+		"The following build commands failed:",
+		"note: Building targets in dependency order",
+		"note: Target dependency graph",
+		"Running script",
+		"[CP-User]",
+		"[CP] Check Pods Manifest.lock",
+		"Build Succeeded"
+	],
+	progressStages: [
+		["Building targets in dependency order", "Target dependency graph"],
+		["Write Auxiliary File", "[CP] Check Pods Manifest.lock"],
+		[
+			"Running script",
+			"[CP-User] [RN]Check rncore",
+			"[CP-User] [Hermes] Replace Hermes",
+			"[CP-User] [RN]Check FBReactNativeSpec"
+		],
+		[
+			"Processing",
+			"ProcessProductPackaging",
+			"ProcessProductPackagingDER"
+		],
+		["Compiling"],
+		["RegisterExecutionPolicyException"],
+		["Touching"],
+		["Building library", "Create Universal Binary"],
+		["Copying"],
+		[
+			"Build Succeeded",
+			"BUILD SUCCEEDED",
+			"ARCHIVE SUCCEEDED"
+		]
+	]
+});
+
+//#endregion
+//#region src/utils/runXcodebuildWithLogging.ts
+let cachedXcbeautifyAvailability = null;
+const TERMINATION_SIGNALS = ["SIGINT", "SIGTERM"];
+const IGNORED_PIPELINE_ERROR_CODES = ["EPIPE", "ERR_STREAM_PREMATURE_CLOSE"];
+const isXcbeautifyAvailable = async () => {
+	if (cachedXcbeautifyAvailability !== null) return cachedXcbeautifyAvailability;
+	try {
+		await execa("which", ["xcbeautify"]);
+		cachedXcbeautifyAvailability = true;
+		return true;
+	} catch {
+		cachedXcbeautifyAvailability = false;
+		return false;
+	}
+};
+const createRawXcodebuildProcess = ({ args, sourceDir }) => {
+	return execa("xcodebuild", args, {
+		cwd: sourceDir,
+		all: true,
+		env: {
+			...process.env,
+			NSUnbufferedIO: "YES"
+		}
+	});
+};
+const createXcbeautifyProcess = ({ cwd }) => {
+	return execa("xcbeautify", [], {
+		cwd,
+		all: true
+	});
+};
+const getErrorCode = (error) => {
+	if (typeof error !== "object" || error === null || !("code" in error)) return "";
+	const { code } = error;
+	return typeof code === "string" ? code : "";
+};
+const shouldIgnorePipelineError = (error) => {
+	const errorCode = getErrorCode(error);
+	return IGNORED_PIPELINE_ERROR_CODES.includes(errorCode);
+};
+const createXcodebuildOutputPipingPromise = async ({ xcodebuildOutput, xcbeautifyInput }) => {
+	try {
+		return await pipeline(xcodebuildOutput, xcbeautifyInput);
+	} catch (error) {
+		if (shouldIgnorePipelineError(error)) return;
+		throw error;
+	}
+};
+const processOutputStream = async ({ outputStream, logger }) => {
+	if (!outputStream) return;
+	await logger.processStream(outputStream);
+};
+const runXcodebuildWithLogging = async ({ args, sourceDir, successMessage, failureMessage, logPrefix }) => {
+	const useXcbeautify = await isXcbeautifyAvailable();
+	const logger = createXcodebuildLogger({ logPrefix });
+	await logger.start();
+	const activeProcesses = [];
+	const terminateActiveProcesses = () => {
+		for (const activeProcess of activeProcesses) activeProcess.kill();
+	};
+	for (const signal of TERMINATION_SIGNALS) process.once(signal, terminateActiveProcesses);
+	try {
+		if (useXcbeautify) {
+			const xcodebuildProcess = createRawXcodebuildProcess({
+				args,
+				sourceDir
+			});
+			const xcbeautifyProcess = createXcbeautifyProcess({ cwd: sourceDir });
+			activeProcesses.push(xcodebuildProcess, xcbeautifyProcess);
+			const xcodebuildOutput = xcodebuildProcess.all ?? xcodebuildProcess.stdout;
+			const xcbeautifyInput = xcbeautifyProcess.stdin;
+			if (!xcodebuildOutput || !xcbeautifyInput) throw new Error("Failed to pipe xcodebuild output into xcbeautify");
+			const pipingPromise = createXcodebuildOutputPipingPromise({
+				xcodebuildOutput,
+				xcbeautifyInput
+			});
+			await processOutputStream({
+				logger,
+				outputStream: xcbeautifyProcess.all ?? xcbeautifyProcess.stdout
+			});
+			await Promise.all([
+				xcbeautifyProcess,
+				xcodebuildProcess,
+				pipingPromise
+			]);
+		} else {
+			const xcodebuildProcess = createRawXcodebuildProcess({
+				args,
+				sourceDir
+			});
+			activeProcesses.push(xcodebuildProcess);
+			await processOutputStream({
+				logger,
+				outputStream: xcodebuildProcess.all ?? xcodebuildProcess.stdout
+			});
+			await xcodebuildProcess;
+		}
+		logger.stop(successMessage);
+	} catch (error) {
+		logger.writeError(error);
+		logger.stop(failureMessage, false);
+		throw error;
+	} finally {
+		for (const signal of TERMINATION_SIGNALS) process.off(signal, terminateActiveProcesses);
+		await logger.close();
+	}
+};
+
 //#endregion
 //#region src/builder/archiveXcodeProject.ts
-const archiveXcodeProject = async ({ sourceDir, platform, schemeConfig }) => {
+const archiveXcodeProject = async ({ sourceDir, platform, installPods, destination, extraParams, configuration, xcodeScheme, xcconfig, logPrefix }) => {
 	const xcodeProject = await parseXcodeProjectInfo(sourceDir);
-	if (schemeConfig.installPods ?? true) await installPodsIfNeeded(sourceDir);
+	if (installPods) await installPodsIfNeeded(sourceDir);
 	const tmpDir = await createRandomTmpDir();
 	const archiveName = `${xcodeProject.name.replace(".xcworkspace", "").replace(".xcodeproj", "")}.xcarchive`;
 	const archivePath = path.join(tmpDir, archiveName);
 	const archiveArgs = prepareArchiveArgs({
 		archivePath,
 		platform,
-		schemeConfig,
 		sourceDir,
-		xcodeProject
+		xcodeProject,
+		configuration,
+		extraParams,
+		destination,
+		xcconfig,
+		xcodeScheme
 	});
 	p.log.info(`Xcode Archive Settings:
 Project    ${xcodeProject.name}
-Scheme     ${schemeConfig.scheme}
+Scheme     ${xcodeScheme}
 Platform   ${platform}
 Command    xcodebuild ${archiveArgs.join(" ")}
 `);
-	const logger = createXcodebuildLogger();
-	logger.start(`${xcodeProject.name} (Archive)`);
 	try {
-		const process$1 = execa("xcodebuild", archiveArgs, { cwd: sourceDir });
-		for await (const line of process$1) logger.processLine(line);
-		logger.stop("Archive completed successfully");
+		await runXcodebuildWithLogging({
+			args: archiveArgs,
+			failureMessage: "Archive failed",
+			logPrefix,
+			sourceDir,
+			successMessage: "Archive completed successfully"
+		});
 		return { archivePath };
 	} catch (error) {
-		logger.stop("Archive failed", false);
 		throw prettifyXcodebuildError(error);
 	}
 };
-const prepareArchiveArgs = ({ archivePath, platform, schemeConfig, sourceDir, xcodeProject }) => {
+const prepareArchiveArgs = ({ xcodeScheme, archivePath, platform, sourceDir, xcodeProject, configuration = "Release", xcconfig, extraParams, destination = [] }) => {
 	const args = [
 		xcodeProject.isWorkspace ? "-workspace" : "-project",
 		path.join(sourceDir, xcodeProject.name),
 		"-scheme",
-		schemeConfig.scheme,
+		xcodeScheme,
 		"-configuration",
-		schemeConfig.configuration || "Release",
+		configuration,
 		"archive",
 		"-archivePath",
 		archivePath,
 		`HOT_UPDATER_MIN_BUNDLE_ID=${generateMinBundleId()}`
 	];
-	if (schemeConfig.xcconfig) args.push("-xcconfig", schemeConfig.xcconfig);
-	if (schemeConfig.extraParams) args.push(...schemeConfig.extraParams);
+	if (xcconfig) args.push("-xcconfig", xcconfig);
+	if (extraParams) args.push(...extraParams);
 	const resolvedDestinations = resolveDestinations({
-		destinations: schemeConfig.destination || [],
+		destinations: destination,
 		useGeneric: true
 	});
 	if (resolvedDestinations.length === 0) resolvedDestinations.push(getDefaultDestination({
@@ -228,209 +366,94 @@ const prepareArchiveArgs = ({ archivePath, platform, schemeConfig, sourceDir, xc
 		platform,
 		useGeneric: true
 	}));
-	for (const destination of resolvedDestinations) args.push("-destination", destination);
+	for (const destination$1 of resolvedDestinations) args.push("-destination", destination$1);
 	return args;
 };
 
-//#endregion
-//#region src/builder/exportXcodeArchive.ts
-const exportXcodeArchive = async ({ archivePath, sourceDir, exportExtraParams, exportOptionsPlist }) => {
-	const exportPath = await createRandomTmpDir();
-	const exportArgs = prepareExportArgs({
-		archivePath,
-		exportPath,
-		exportOptionsPlist,
-		exportExtraParams
-	});
-	const spinner = p.spinner();
-	spinner.start("Exporting archive to IPA");
-	try {
-		await execa("xcodebuild", exportArgs, { cwd: sourceDir });
-		spinner.stop("Archive exported successfully");
-		return { exportPath };
-	} catch (error) {
-		spinner.stop("Export failed");
-		throw prettifyXcodebuildError(error);
-	}
-};
-const prepareExportArgs = ({ exportPath, archivePath, exportExtraParams, exportOptionsPlist }) => {
-	const args = [
-		"-exportArchive",
-		"-archivePath",
-		archivePath,
-		"-exportPath",
-		exportPath
-	];
-	if (exportExtraParams) args.push(...exportExtraParams);
-	args.push("-exportOptionsPlist", exportOptionsPlist);
-	return args;
-};
-
-//#endregion
-//#region src/utils/assertXcodebuildExist.ts
-const assertXcodebuildExist = async () => {
-	try {
-		await execa("which", ["xcodebuild"]);
-	} catch {
-		p.log.error(`${colors.blueBright("xcodebuild")} resolve failed. Ensure that xcode is installed on your machine or xcodebuild is included in your path`);
-		process.exit(1);
-	}
-};
-
-//#endregion
-//#region src/utils/enrichNativeBuildIosScheme.ts
-const resolveExportOptionsPlist = (exportOptionsPlist) => {
-	const resolvedExportOptionsPlist = exportOptionsPlist ? path.isAbsolute(exportOptionsPlist) ? exportOptionsPlist : path.resolve(getCwd(), exportOptionsPlist) : void 0;
-	if (resolvedExportOptionsPlist && !fs.existsSync(resolvedExportOptionsPlist)) {
-		p.log.error(`exportOptionsPlist doesn't exist in ${resolvedExportOptionsPlist}`);
-		process.exit(1);
-	}
-	return resolvedExportOptionsPlist;
-};
-const enrichNativeBuildIosScheme = async (scheme) => {
-	return {
-		platform: "ios",
-		installPods: true,
-		configuration: "Release",
-		destination: [],
-		...scheme,
-		exportOptionsPlist: resolveExportOptionsPlist(scheme.exportOptionsPlist)
-	};
-};
-
-//#endregion
-//#region src/buildIos.ts
-const buildIos = async ({ schemeConfig: _schemeConfig }) => {
-	await assertXcodebuildExist();
-	const iosProjectRoot = path.join(getCwd(), "ios");
-	const schemeConfig = await enrichNativeBuildIosScheme(_schemeConfig);
-	const buildDirectory = await createRandomTmpDir();
-	const archiveDir = path.join(buildDirectory, "archive");
-	const exportDir = path.join(buildDirectory, "export");
-	await fs.promises.mkdir(archiveDir, { recursive: true });
-	const { archivePath } = await archiveXcodeProject({
-		platform: schemeConfig.platform,
-		schemeConfig,
-		sourceDir: iosProjectRoot
-	});
-	const finalArchivePath = path.join(archiveDir, path.basename(archivePath));
-	await fs.promises.cp(archivePath, finalArchivePath, { recursive: true });
-	const appFromArchive = extractAppFromXcarchive(finalArchivePath);
-	if (appFromArchive) {
-		await fs.promises.cp(appFromArchive, path.join(archiveDir, path.basename(appFromArchive)), { recursive: true });
-		p.log.success(".app extracted from .xcarchive");
-	}
-	if (schemeConfig.exportOptionsPlist) {
-		await fs.promises.mkdir(exportDir, { recursive: true });
-		const { exportPath } = await exportXcodeArchive({
-			archivePath,
-			exportExtraParams: schemeConfig.exportExtraParams,
-			exportOptionsPlist: schemeConfig.exportOptionsPlist,
-			sourceDir: iosProjectRoot
-		});
-		await fs.promises.cp(exportPath, exportDir, { recursive: true });
-		const ipaFile = fs.readdirSync(exportDir).find((file) => file.endsWith(".ipa"));
-		if (ipaFile) return {
-			buildDirectory,
-			buildArtifactPath: path.join(exportDir, ipaFile)
-		};
-		throw new Error("IPA file not found after export");
-	}
-	return {
-		buildDirectory,
-		buildArtifactPath: finalArchivePath
-	};
-};
-const extractAppFromXcarchive = (archivePath) => {
-	const productsPath = path.join(archivePath, "Products", "Applications");
-	if (!fs.existsSync(productsPath)) return;
-	const appFile = fs.readdirSync(productsPath).find((file) => file.endsWith(".app"));
-	if (appFile) return path.join(productsPath, appFile);
-	p.log.warn("Failed to extract .app from xcarchive");
-};
-
 //#endregion
 //#region src/builder/buildXcodeProject.ts
-const buildXcodeProject = async ({ sourceDir, platform, scheme, configuration, deviceType, udid, installPods, extraParams }) => {
+const buildXcodeProject = async ({ sourceDir, platform, xcodeScheme, configuration, deviceType, logPrefix, destination = [], useGenericDestination = false, installPods, extraParams }) => {
 	const xcodeProject = await parseXcodeProjectInfo(sourceDir);
-	if (installPods ?? true) await installPodsIfNeeded(sourceDir);
+	if (installPods) await installPodsIfNeeded(sourceDir);
 	const derivedDataPath = await createRandomTmpDir();
+	const resolvedDestinations = resolveDestinations({
+		destinations: destination,
+		useGeneric: useGenericDestination
+	});
+	if (resolvedDestinations.length === 0) resolvedDestinations.push(getDefaultDestination({
+		deviceType,
+		platform,
+		useGeneric: useGenericDestination
+	}));
 	const buildArgs = prepareBuildArgs({
 		configuration,
 		derivedDataPath,
 		deviceType,
+		resolvedDestinations,
 		extraParams,
 		platform,
-		scheme,
+		xcodeScheme,
 		sourceDir,
-		udid,
 		xcodeProject
 	});
 	p.log.info(`Xcode Build Settings:
 Project        ${xcodeProject.name}
-Scheme         ${scheme}
+Scheme         ${xcodeScheme}
 Configuration  ${configuration}
 Platform       ${platform}
 Device Type    ${deviceType}
 Command        xcodebuild ${buildArgs.join(" ")}
 `);
-	const logger = createXcodebuildLogger();
-	logger.start(`${xcodeProject.name} (Build)`);
 	try {
-		const process$1 = execa("xcodebuild", buildArgs, { cwd: sourceDir });
-		for await (const line of process$1) logger.processLine(line);
-		logger.stop("Build completed successfully");
+		await runXcodebuildWithLogging({
+			args: buildArgs,
+			sourceDir,
+			logPrefix,
+			successMessage: "Build completed successfully",
+			failureMessage: "Build failed"
+		});
 		return await getBuildSettings({
 			configuration,
 			derivedDataPath,
-			deviceType,
-			platform,
-			scheme,
+			resolvedDestinations,
+			xcodeScheme,
 			sourceDir,
-			udid,
 			xcodeProject
 		});
 	} catch (error) {
-		logger.stop("Build failed", false);
 		throw prettifyXcodebuildError(error);
 	}
 };
-const prepareBuildArgs = ({ xcodeProject, sourceDir, platform, scheme, configuration, deviceType, udid, derivedDataPath, extraParams }) => {
+const prepareBuildArgs = ({ xcodeProject, sourceDir, platform, xcodeScheme, configuration, deviceType, resolvedDestinations, derivedDataPath, extraParams }) => {
 	const sdk = deviceType === "simulator" ? platformConfigs[platform].simulatorSdk : platformConfigs[platform].deviceSdk;
-	const destination = udid ? `id=${udid}` : deviceType === "simulator" ? platformConfigs[platform].simulatorDestination : platformConfigs[platform].deviceDestination;
 	const args = [
 		xcodeProject.isWorkspace ? "-workspace" : "-project",
 		path.join(sourceDir, xcodeProject.name),
 		"-scheme",
-		scheme,
+		xcodeScheme,
 		"-configuration",
 		configuration,
 		"-sdk",
 		sdk,
-		"-destination",
-		destination,
 		"-derivedDataPath",
 		derivedDataPath,
 		`HOT_UPDATER_MIN_BUNDLE_ID=${generateMinBundleId()}`,
 		"build"
 	];
 	if (extraParams) args.push(...extraParams);
+	for (const dest of resolvedDestinations) args.push("-destination", dest);
 	return args;
 };
-const getBuildSettings = async ({ xcodeProject, sourceDir, platform, scheme, configuration, deviceType, udid, derivedDataPath }) => {
-	const sdk = deviceType === "simulator" ? platformConfigs[platform].simulatorSdk : platformConfigs[platform].deviceSdk;
-	const destination = udid ? `id=${udid}` : deviceType === "simulator" ? platformConfigs[platform].simulatorDestination : platformConfigs[platform].deviceDestination;
+const getBuildSettings = async ({ xcodeProject, sourceDir, xcodeScheme, configuration, resolvedDestinations, derivedDataPath }) => {
+	const destinationArgs = resolvedDestinations.flatMap((dest) => ["-destination", dest]);
 	const { stdout: buildSettings } = await execa("xcodebuild", [
 		xcodeProject.isWorkspace ? "-workspace" : "-project",
 		xcodeProject.name,
 		"-scheme",
-		scheme,
+		xcodeScheme,
 		"-configuration",
 		configuration,
-		"-sdk",
-		sdk,
-		"-destination",
-		destination,
+		...destinationArgs,
 		"-derivedDataPath",
 		derivedDataPath,
 		"-showBuildSettings",
@@ -452,6 +475,137 @@ const getBuildSettings = async ({ xcodeProject, sourceDir, platform, scheme, con
 	};
 };
 
+//#endregion
+//#region src/builder/exportXcodeArchive.ts
+const exportXcodeArchive = async ({ archivePath, sourceDir, exportExtraParams, exportOptionsPlist, logPrefix }) => {
+	const exportPath = await createRandomTmpDir();
+	const exportArgs = prepareExportArgs({
+		archivePath,
+		exportPath,
+		exportOptionsPlist,
+		exportExtraParams
+	});
+	try {
+		await runXcodebuildWithLogging({
+			args: exportArgs,
+			sourceDir,
+			successMessage: "Archive exported successfully",
+			failureMessage: "Export failed",
+			logPrefix
+		});
+		return { exportPath };
+	} catch (error) {
+		throw prettifyXcodebuildError(error);
+	}
+};
+const prepareExportArgs = ({ exportPath, archivePath, exportExtraParams, exportOptionsPlist }) => {
+	const args = [
+		"-exportArchive",
+		"-archivePath",
+		archivePath,
+		"-exportPath",
+		exportPath
+	];
+	if (exportExtraParams) args.push(...exportExtraParams);
+	args.push("-exportOptionsPlist", exportOptionsPlist);
+	return args;
+};
+
+//#endregion
+//#region src/utils/assertXcodebuildExist.ts
+const assertXcodebuildExist = async () => {
+	try {
+		await execa("which", ["xcodebuild"]);
+	} catch {
+		p.log.error(`${colors.blueBright("xcodebuild")} resolve failed. Ensure that xcode is installed on your machine or xcodebuild is included in your path`);
+		process.exit(1);
+	}
+};
+
+//#endregion
+//#region src/buildIos.ts
+const buildIos = async ({ schemeConfig }) => {
+	await assertXcodebuildExist();
+	const iosProjectRoot = path.join(getCwd(), "ios");
+	const buildDirectory = await createRandomTmpDir();
+	const archiveDir = path.join(buildDirectory, "archive");
+	const exportDir = path.join(buildDirectory, "export");
+	await fs.promises.mkdir(archiveDir, { recursive: true });
+	if (schemeConfig.simulator) {
+		if (schemeConfig.destination.length) {
+			p.log.error("The scheme option 'simulator' is not compatible with the 'destination' option.");
+			process.exit(1);
+		}
+		const appDir = path.join(buildDirectory, "app");
+		await fs.promises.mkdir(appDir, { recursive: true });
+		const { appPath } = await buildXcodeProject({
+			sourceDir: iosProjectRoot,
+			logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build`,
+			platform: schemeConfig.platform,
+			xcodeScheme: schemeConfig.scheme,
+			configuration: schemeConfig.configuration,
+			deviceType: "simulator",
+			installPods: schemeConfig.installPods,
+			extraParams: schemeConfig.extraParams,
+			useGenericDestination: true
+		});
+		const finalAppPath = path.join(appDir, path.basename(appPath));
+		await fs.promises.cp(appPath, finalAppPath, { recursive: true });
+		p.log.success(`.app file created: ${path.basename(appPath)}`);
+		return {
+			buildDirectory,
+			buildArtifactPath: finalAppPath
+		};
+	} else {
+		const { archivePath } = await archiveXcodeProject({
+			platform: schemeConfig.platform,
+			sourceDir: iosProjectRoot,
+			xcconfig: schemeConfig.xcconfig,
+			xcodeScheme: schemeConfig.scheme,
+			destination: schemeConfig.destination,
+			extraParams: schemeConfig.extraParams,
+			configuration: schemeConfig.configuration,
+			installPods: schemeConfig.installPods,
+			logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build-archive`
+		});
+		const finalArchivePath = path.join(archiveDir, path.basename(archivePath));
+		await fs.promises.cp(archivePath, finalArchivePath, { recursive: true });
+		const appFromArchive = extractAppFromXcarchive(finalArchivePath);
+		if (appFromArchive) {
+			await fs.promises.cp(appFromArchive, path.join(archiveDir, path.basename(appFromArchive)), { recursive: true });
+			p.log.success(".app extracted from .xcarchive");
+		}
+		if (schemeConfig.exportOptionsPlist) {
+			await fs.promises.mkdir(exportDir, { recursive: true });
+			const { exportPath } = await exportXcodeArchive({
+				archivePath,
+				exportExtraParams: schemeConfig.exportExtraParams,
+				exportOptionsPlist: schemeConfig.exportOptionsPlist,
+				sourceDir: iosProjectRoot,
+				logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build-export`
+			});
+			await fs.promises.cp(exportPath, exportDir, { recursive: true });
+			const ipaFile = fs.readdirSync(exportDir).find((file) => file.endsWith(".ipa"));
+			if (ipaFile) return {
+				buildDirectory,
+				buildArtifactPath: path.join(exportDir, ipaFile)
+			};
+			throw new Error("IPA file not found after export");
+		}
+		return {
+			buildDirectory,
+			buildArtifactPath: finalArchivePath
+		};
+	}
+};
+const extractAppFromXcarchive = (archivePath) => {
+	const productsPath = path.join(archivePath, "Products", "Applications");
+	if (!fs.existsSync(productsPath)) return;
+	const appFile = fs.readdirSync(productsPath).find((file) => file.endsWith(".app"));
+	if (appFile) return path.join(productsPath, appFile);
+	p.log.warn("Failed to extract .app from xcarchive");
+};
+
 //#endregion
 //#region src/runner/deviceRunner.ts
 const installAndLaunchOnDevice = async ({ device, appPath, options }) => {
@@ -737,10 +891,9 @@ const Device = {
 
 //#endregion
 //#region src/runIos.ts
-const runIos = async ({ schemeConfig: _schemeConfig, runOption }) => {
+const runIos = async ({ schemeConfig, runOption }) => {
 	const { interactive, device: deviceOption } = runOption;
 	const iosProjectPath = path.join(getCwd(), "ios");
-	const schemeConfig = await enrichNativeBuildIosScheme(_schemeConfig);
 	const device = await Device.selectTargetDevice({
 		platform: "ios",
 		deviceOption,
@@ -758,12 +911,13 @@ const runIos = async ({ schemeConfig: _schemeConfig, runOption }) => {
 		const result$1 = await buildXcodeProject({
 			sourceDir: iosProjectPath,
 			platform: schemeConfig.platform,
-			scheme: schemeConfig.scheme,
+			xcodeScheme: schemeConfig.scheme,
 			configuration: schemeConfig.configuration,
 			deviceType: selectedDevice.type,
-			udid: selectedDevice.udid,
+			destination: [{ id: selectedDevice.udid }],
 			installPods: schemeConfig.installPods,
-			extraParams: schemeConfig.extraParams
+			extraParams: schemeConfig.extraParams,
+			logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-run`
 		});
 		const runnerOptions$1 = {
 			bundleIdentifier: schemeConfig.bundleIdentifier,
@@ -783,12 +937,13 @@ const runIos = async ({ schemeConfig: _schemeConfig, runOption }) => {
 	const result = await buildXcodeProject({
 		sourceDir: iosProjectPath,
 		platform: schemeConfig.platform,
-		scheme: schemeConfig.scheme,
+		xcodeScheme: schemeConfig.scheme,
 		configuration: schemeConfig.configuration,
 		deviceType: device.type,
-		udid: device.udid,
+		destination: [{ id: device.udid }],
 		installPods: schemeConfig.installPods,
-		extraParams: schemeConfig.extraParams
+		extraParams: schemeConfig.extraParams,
+		logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-run`
 	});
 	const runnerOptions = {
 		bundleIdentifier: schemeConfig.bundleIdentifier,
@@ -813,4 +968,27 @@ const runIos = async ({ schemeConfig: _schemeConfig, runOption }) => {
 };
 
 //#endregion
-export { buildIos, runIos };
+//#region src/utils/enrichNativeBuildIosScheme.ts
+const resolveExportOptionsPlist = (exportOptionsPlist) => {
+	const resolvedExportOptionsPlist = exportOptionsPlist ? path.isAbsolute(exportOptionsPlist) ? exportOptionsPlist : path.resolve(getCwd(), exportOptionsPlist) : void 0;
+	if (resolvedExportOptionsPlist && !fs.existsSync(resolvedExportOptionsPlist)) {
+		p.log.error(`exportOptionsPlist doesn't exist in ${resolvedExportOptionsPlist}`);
+		process.exit(1);
+	}
+	return resolvedExportOptionsPlist;
+};
+const enrichNativeBuildIosScheme = async ({ scheme, hotUpdaterSchemeName }) => {
+	return {
+		platform: "ios",
+		installPods: false,
+		configuration: "Release",
+		destination: [],
+		simulator: false,
+		...scheme,
+		exportOptionsPlist: resolveExportOptionsPlist(scheme.exportOptionsPlist),
+		hotUpdaterSchemeName
+	};
+};
+
+//#endregion
+export { buildIos, enrichNativeBuildIosScheme, runIos };