fix: add missing --device option (#2482)

Author: szymonrybczak

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

@@ -16,6 +16,8 @@ export type BuildFlags = {
 
 export const getBuildOptions = ({platformName}: BuilderCommand) => {
   const {readableName} = getPlatformInfo(platformName);
+  const isMac = platformName === 'macos';
+
   return [
     {
       name: '--mode <string>',
@@ -60,5 +62,11 @@ export const getBuildOptions = ({platformName}: BuilderCommand) => {
       name: '--force-pods',
       description: 'Force CocoaPods installation',
     },
+    !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:
+        'Explicitly set the device to use by name or by unique device identifier . If the value is not provided,' +
+        'the app will run on the first available physical device.',
+    },
   ];
 };

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

@@ -42,12 +42,6 @@ export const getRunOptions = ({platformName}: BuilderCommand) => {
         'between parentheses at the end to match an exact version: ' +
         '"iPhone 15 (17.0)"',
     },
-    !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:
-        'Explicitly set the device to use by name or by unique device identifier . If the value is not provided,' +
-        'the app will run on the first available physical device.',
-    },
     ...getBuildOptions({platformName}),
   ];
 };

packages/cli-platform-ios/README.md

@@ -148,6 +148,10 @@ Explicitly set Xcode scheme to use.
 
 Explicitly set Xcode target to use.
 
+#### `--device [string]`
+
+Explicitly set device to use by name. The value is not required if you have a single device connected.
+
 #### `--verbose`
 
 Do not use `xcbeautify` or `xcpretty` even if installed.