activities
latest
false
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。
UiPath logo, featuring letters U and I in white

UI Automation のアクティビティ

最終更新日時 2025年12月5日

ローカル iOS デバイス

ローカル iOS デバイスを設定する

ローカル デバイスをモバイル オートメーション アクティビティで動作するように設定するには、Appium のローカル インスタンスを実行し、iOS デバイスの操作の自動化に必要なツールを用意する必要があります。

自動化できるローカル iOS デバイスには、次の 2 種類があります。

  • 物理 - USB ケーブルでローカル マシンに接続できる iOS 物理デバイスです。
  • エミュレーター - ローカルに保存される iOS デバイス用のエミュレーターです。

使用頻度の高い Appium コマンド

以下のリストは、モバイル デバイス オートメーションのコンテキストで Appium を設定する場合に最もよく使用されるコマンドです (Appium 2.0 に推奨)。

  • xcrun simctl list - 利用可能なデバイス、デバイスの種類、ランタイム、デバイスのペアのリストを表示します。
  • xcrun simctl list devices - 使用可能なデバイスのリストを表示します。
  • xcrun simctl list devicetypes - デバイスの種類のリストを表示します。
  • xcrun simctl list runtimes - ランタイムのリストを表示します。
  • xcrun simctl list runtimes - デバイスのペアのリストを表示します。

アプリケーション ストレージ

モバイル アプリを Appium サーバーが動作中のマシンに保存するか、IPA ファイルを、Appium サーバーが匿名でアクセスできる URL (例: Blob ストレージ) にアップロードする必要があります。

Google Play ストアまたは Apple App Store からアプリケーションをインストールすることはできません。ただし、これらのアプリケーションを手動で自動化して、独自のアプリケーションをインストールする場合は別です。

重要:
アプリのアーティファクトが拡張子 APP を使用していて、そのアプリをパブリック URL にアップロードする場合、Payload という名前のフォルダーを作成し、そこに拡張子 APP 付きのアプリを配置してから Payload フォルダーをアーカイブし、その拡張子を ZIP ではなく IPA に変更する必要があります。

さらに、自動化しようとしているアプリケーションが、ターゲット アーキテクチャ (シミュレーターまたは物理デバイス) 用にコンパイルされていることも確認してください。

iOS 物理デバイスを設定する

アーキテクチャ

When working with iOS Physical Devices, you require the following infrastructure:

  1. WindowsOS Device
    • UiPath Studio (Hardware/Software) – installation guide
  2. macOS Device
    • Appium Server
      • Homebrew
      • NodeJS
    • Xcode
      • Required to install Appium Driver on iOS device
  3. iOS Device
    • Appium WebDriver
Figure 1. Architecture for IOS Local Physical Devices

前提条件

  1. macOS 13+ (Ventura or later)
  2. Apple ID (for Xcode and provisioning)
  3. Physical iOS device (iPhone/iPad)
  4. UiPath Studio 2023.10 (or higher)
  5. USB cable to connect the device

Configuring Local Physical iOS Device

  1. Install Homebrew.
    1. Open Terminal (select Command+Space).
    2. 次のコマンドを実行します。 
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
      Figure 2. Homebrew installation - command line

    3. If prompted, run the following command to add Homebrew to your PATH environment variable: 
      echo >> /Users/<username>/.zprofile
  echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/<username>/.zprofile
  eval "$(/opt/homebrew/bin/brew shellenv)"echo >> /Users/<username>/.zprofile
  echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/<username>/.zprofile
  eval "$(/opt/homebrew/bin/brew shellenv)"
    4. Verify. 
      brew -versionbrew -version
  2. Install Xcode and Command Line Tools.
    • Install Xcode via App Store and open it once.
    • From Terminal, run the following:
      1. xcode-select –installxcode-select –install
      2. sudo xcodebuild -license acceptsudo xcodebuild -license accept
      3. Verify: 
        xcodebuild -versionxcodebuild -version
  3. Enable Developer mode on iOS Device.
    1. On your iPhone or iPad, go to Settings > Privacy & Security > Developer Mode.
      Figure 3. Developer mode on IOS device

    2. Toggle on and restart.
    3. After restart, approve the popup.
    4. Connect via USB and trust the computer.
      Figure 4. Enable iOS device trust

  4. Install Node.js.
    1. 次のコマンドを実行します。 
      brew install nodebrew install node
      Figure 5. Node.js installation

    2. Verify. 
      node -vnode -v
      npm -vnpm -v
  5. Install Appium v3.
    1. 次のコマンドを実行します。 
      npm install -g appium@3npm install -g appium@3
      Figure 6. Appium installation

    2. Verify. 
      appium -vappium -v
      Figure 7. Appium verification

  6. Install Appium Drivers and Plugins.
    1. Install iOS driver. 
      appium driver install xcuitestappium driver install xcuitest
      Figure 8. Appium xcuitest

    2. (Optional) Configure Android option. 
      appium driver install uiautomator2appium driver install uiautomator2
    3. List drivers. 
      appium driver listappium driver list
      Figure 9. Appium drivers

  7. Set up WebDriverAgent.
    1. Install Carthage.
    2. Set up WebDriverAgent.
      1. Navigate to the appium-webdriveragent folder, using the following path: /Usetrs/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent, and open the xcodeproj file.
        Figure 10. WebDriverAgent folder

      2. Select WebDriverAgent, and, under the Targets section, open WebDriverAgentRunner.
        Figure 11. WebDriverAgent runner

      3. [Signing & Capabilities] タブに切り替えて [Automatically manage signing] を選択し、[Team] ドロップダウンからユーザー アカウントを選択します。
      4. [Bundle Identifier] を一意の値に変更します。
        Figure 12. WebDriverAgent Bundle Identifier

      5. Copy and save this Bundle Identifier, which you will use to add your Application inside Mobile Device Manager (Bundle Id).
      Trouble: A common issue that you may encounter is an Untrusted Developer Certificate. To fix the issue, follow the instructions oin the popup.
      Figure 13. WebDriverAgent troubleshooting

  8. Verify Physical Device access.
    1. Confirm that the IntegrationApp is installed on your physical device.
      Figure 14. IntegrationApp on physical device

    2. xcrun xctrace list devices を実行します。
    3. Ensure your iPhone appears in the list. If not, verify Developer Mode and Trust settings. You will need the UDID or information in the parenthesis after your device name.
      Figure 15. Physical device access

  9. Start the Appium Server.
    1. Open the terminal and enter appium.
      Figure 16. Appium Server start

    2. Copy the appium url (to be used in next step).
      Note: Do not use the 127 location.
  10. Connect UiPath to Appium.
    1. Open UiPath Studio and install Mobile Automation Activities.
    2. Open Mobile Device Manager, and select Add device.
Add the configurated local physical iOS device in Mobile Device Manager, using the Adding iOS Device in Mobile Device Manager procedure.

モバイル デバイス マネージャーにローカル iOS デバイスを追加する

  1. Studio からモバイル デバイス マネージャーを開きます。
  2. 左側のナビゲーション パネルの [デバイス] に移動します。
  3. デバイスを次のように設定します。
    • 名前 - [デバイス] タブでデバイスを識別するための名前を入力します。
    • Appium URL - 前述の手順でコピーした Appium URL を http://<ipaddress>:8001 という形式で入力します。
    • プラットフォーム - フィールドをクリックして、ドロップダウンから [iOS] を選択します。
    • デバイス名 - デバイスの名前を入力します。

    • 希望する追加機能 - 次の機能を追加します。

      名前

      値 (Value)

      automationName
      xcuitest (Appium iOS ドライバーをアクティブ化する機能)

      udid

      the Identifier of the connected physical iOS device

  4. (任意) [ログ] タブでログ記録とビデオ記録の詳細を設定します。
  5. (任意) [開発] タブで開発プロセスを設定します。
    • 類似タブを閉じる (既定で有効): 類似のデバイスやアプリケーションとの接続を実行しているタブを閉じます。
    • ページの更新を待機 (既定で有効): ページのソースが各アクションのスクリーンショットを取得するまで待機します。
  6. [保存して閉じる] をクリックしてデバイスを追加します。

    デバイスが [デバイス] リストに追加されます。ローカル デバイスを追加するには、「ローカル デバイス」をご覧ください。

    デバイスを起動できない場合は、「トラブルシューティング シナリオ: iOS 物理デバイスの起動に失敗する」をご覧ください。



iOS でのハイブリッドおよび Web の自動化

運用環境向けのアプリ構築の自動化を目的としていない場合、ハイブリッド自動化は既定で iOS デバイスで機能します。運用環境のアプリを自動化する場合、WKWebView でホストするコンテンツは自動化できませんが、SFSafariViewController でホストする Web コンテンツであれば、運用環境のアプリでも自動化できます。詳細については、「SFSafariViewController」をご覧ください。

このページは役に立ちましたか?

サポートとサービス
サポートを受ける
UiPath アカデミー
RPA について学ぶ - オートメーション コース
UiPath フォーラム
UiPath コミュニティ フォーラム
Uipath Logo
信頼とセキュリティ
利用規約
プライバシー ポリシー
Cookie ポリシー
© 2005-2025 UiPath. All rights reserved.