feat: add --only-pods option to run/build-ios commands (#2624)

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

* feat: force install pods when installing only pods

Author: szymonrybczak

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;
@@ -36,14 +40,18 @@ const createBuild =
         platformName,
         ctx.reactNativePath,
         {
-          forceInstall: args.forcePods,
+          forceInstall: args.forcePods || args.onlyPods,
           newArchEnabled: isAppRunningNewArchitecture,
         },
       );
 
       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;
@@ -91,14 +95,18 @@ const createRun =
         platformName,
         ctx.reactNativePath,
         {
-          forceInstall: args.forcePods,
+          forceInstall: args.forcePods || args.onlyPods,
           newArchEnabled: isAppRunningNewArchitecture,
         },
       );
 
       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: