feat: add --only-pods option to run/build-ios commands

Author: szymonrybczak

__e2e__/__snapshots__/config.test.ts.snap

@@ -4,7 +4,7 @@ exports[`shows up current config without unnecessary output 1`] = `
 {
   "root": "<<REPLACED_ROOT>>/TestProject",
   "reactNativePath": "<<REPLACED_ROOT>>/TestProject/node_modules/react-native",
-  "reactNativeVersion": "0.77",
+  "reactNativeVersion": "0.78",
   "dependencies": {},
   "commands": [
     {

packages/cli-platform-apple/src/commands/buildCommand/buildOptions.ts

@@ -12,6 +12,7 @@ export type BuildFlags = {
   destination?: string;
   extraParams?: string[];
   forcePods?: boolean;
+  onlyPods?: boolean;
 };
 
 export const getBuildOptions = ({platformName}: BuilderCommand) => {
@@ -62,6 +63,10 @@ export const getBuildOptions = ({platformName}: BuilderCommand) => {
       name: '--force-pods',
       description: 'Force CocoaPods installation',
     },
+    {
+      name: '--only-pods',
+      description: 'Only install Cocoapods, do not build the app',
+    },
     !isMac && {
       name: '--device [string]', // here we're intentionally using [] over <> to make passed value optional to allow users to run only on physical devices
       description:

packages/cli-platform-apple/src/commands/buildCommand/createBuild.ts

@@ -24,7 +24,11 @@ const createBuild =
     }
 
     let installedPods = false;
-    if (platformConfig.automaticPodsInstallation || args.forcePods) {
+    if (
+      platformConfig.automaticPodsInstallation ||
+      args.forcePods ||
+      args.onlyPods
+    ) {
       const isAppRunningNewArchitecture = platformConfig.sourceDir
         ? await getArchitecture(platformConfig.sourceDir)
         : undefined;
@@ -43,6 +47,10 @@ const createBuild =
       installedPods = true;
     }
 
+    if (args.onlyPods) {
+      return;
+    }
+
     let {xcodeProject, sourceDir} = getXcodeProjectAndDir(
       platformConfig,
       platformName,

packages/cli-platform-apple/src/commands/runCommand/createRun.ts

@@ -79,7 +79,11 @@ const createRun =
     let {packager, port} = args;
     let installedPods = false;
     // check if pods need to be installed
-    if (platformConfig.automaticPodsInstallation || args.forcePods) {
+    if (
+      platformConfig.automaticPodsInstallation ||
+      args.forcePods ||
+      args.onlyPods
+    ) {
       const isAppRunningNewArchitecture = platformConfig.sourceDir
         ? await getArchitecture(platformConfig.sourceDir)
         : undefined;
@@ -98,6 +102,10 @@ const createRun =
       installedPods = true;
     }
 
+    if (args.onlyPods) {
+      return;
+    }
+
     if (packager) {
       const {port: newPort, startPackager} = await findDevServerPort(
         port,

packages/cli-platform-ios/README.md

@@ -118,6 +118,10 @@ List all available iOS devices and simulators and let you choose one to run the
 
 Force running `pod install` before running an app
 
+#### `--only-pods`,
+
+Only install Cocoapods, do not build the app.
+
 ### `build-ios`
 
 Usage:
@@ -177,6 +181,10 @@ npx react-native build-ios --extra-params "-jobs 4"
 
 Force running `pod install` before building an app
 
+#### `--only-pods`,
+
+Only install Cocoapods, do not build the app.
+
 ### `log-ios`
 
 Usage: