UiPath Documentation
activities
latest
false
UI Automation アクティビティ
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。

ローカル Android デバイス

Appium のローカル インスタンスを実行して、モバイル オートメーション用にローカル Android デバイスを設定する。

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

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

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

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

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

次のリストに、モバイル デバイス オートメーションのコンテキストで Appium を設定する場合に最もよく使用されるコマンドを示します。

  • appium driver list - インストールされているドライバーのリストを表示します (Appium 2.0 の場合に推奨)。
  • adb devices - 接続されているデバイスのリストを表示します。
  • adb start-server - デバッグ サーバーを開始します。
  • adb kill-server - デバッグ サーバーを停止します。
  • ctrl + c - Appium を強制終了します。
  • appium-doctor - Appium のデバッグに役立ちます。

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

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

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

ローカルの物理 Android デバイスを設定する​

前提条件​

以下の手順を実行して、ローカルの物理 Android デバイスを設定するための前提条件を満たす必要があります。

  1. Java をダウンロードしてインストールします。Java はこちらから zip ファイルでダウンロードできます。

  2. Node.js をダウンロードしてインストール します。Node.js の最新バージョンは こちらからダウンロードできます。

  3. Node.js のインストールが完了したら、コマンド プロンプトを開き、次のコマンドを使用して、正常にインストールされたかどうかを確認します。

    • node-v - マシンにインストールされている Node.js のバージョンを返します。返されるバージョンが 19 以上である必要があります。
    • npm-v - マシンにインストールされている npm のバージョンを返します。返されるバージョンが 8 以上である必要があります。

  4. Android Studio をダウンロードしてインストールします。Android Studio は こちらからダウンロードできます。

  5. Android Studio を使用して Android SDK Tools (Obsolete) をインストールします。

  6. Windows で [システムの詳細設定] > [詳細設定] > [環境変数] に移動します。

  7. [システム環境変数] の [新規...] をクリックして、次の変数を設定します。

    1. JAVA_HOME 変数。Java がインストールされているフォルダーを指します。 変数名: JAVA_HOME。 変数値: マシン上で JDK がある場所のパスです。例: C:\Program Files\Java\jdk8。

    2. ANDROID_HOME 変数です。Android SDK がインストールされていたフォルダーを指します。変数名: ANDROID_HOME 変数値: マシン上の Android SDK が配置されているパス。以下に例を示します。 C:\Users\Username\AppData\Local\Android\Sdk 注: 変数値のパス内にあるUsername部分は、マシンで操作しているユーザーの実際の名前に置き換える必要があります。

      重要:

      Java が自動的に更新される場合、この変数を更新されたパスに手動で設定する必要があります。

  1. Node.js のコマンド プロンプトを開き、Appium をインストールします。
    • Appium 1.0 の場合は、コマンド npm install -g appium を実行します。Appium 1.0 には既定ですべてのドライバーがインストールされています。
    • Appium 2.0 の場合は、コマンド npm install -g appium@next を実行します。

Appium 2.0 には既定ではドライバーがインストールされていません。したがって、必要なドライバーをインストールするために、コマンド appium driver install uiautomator2 も実行する必要があります。

Appium 1.0 の設定について詳しくは、「Quickstart Intro」をご覧ください。

注:

v22.10 以降の モバイル オートメーション アクティビティ パッケージには Appium 2.0 を使用することをお勧めします。

  1. コンピューターを再起動して変更を適用します。
  2. 物理モバイル デバイスを開き、[開発者向けオプション] を有効化します。
    • スマートフォンの [設定] > [開発者向けオプション] に移動します。
    • [ネットワーク] セクションの [デフォルトの USB 設定] を開き [充電のみ] に設定します。
  3. [USB デバッグ] を有効化します。
  4. スマートフォンの [設定] > [開発者向けオプション] に移動します。
  5. [ネットワーク] セクションの [デフォルトの USB 設定] を開き [充電のみ] に設定します。

ローカルの物理 Android デバイスを設定する​

  1. USB ケーブルを使用して物理デバイスをローカル マシンに接続します。

  2. コマンド プロンプトを開き、コマンド adb.exe start-server を使用してデバッグ サーバーを起動します。

  3. モバイル デバイスで [USB デバッグ] を許可します (許可するよう求められた場合)。

  4. Appium セッションを開始する前に、パラメーター the --base-path /wd/hub を手動で追加します。

  5. コマンド appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload を使用して Appium サーバーを起動します。

    注:

    • 自動ダウンロードが失敗する場合は、次のコマンドを追加することで、ダウンロード済みの chromedriver.exe を指定できます。

      --chromedriver-executable "path\_to\_chromedriver"

    • Appium サーバーとの間に、干渉のない接続を常時確保してください。たとえば、ターミナルでクリックすると通信が遮断され、モバイル デバイス マネージャーで通信エラーが発生する場合があります。

  6. 「モバイル デバイス マネージャーにローカル Android デバイスを追加する」の手順を使用して、設定したローカルの物理 Android デバイスをモバイル デバイス マネージャーに追加します。

エミュレートされたローカル Android デバイスを設定する​

前提条件​

  1. Java をダウンロードしてインストールします。Java はこちらから zip ファイルでダウンロードできます。

  2. Node.js をダウンロードしてインストール します。Node.js の最新バージョンは こちらからダウンロードできます。

  3. Node.js のインストールが完了したら、コマンド プロンプトを開き、次のコマンドを使用して、正常にインストールされたかどうかを確認します。

    • node-v - マシンにインストールされている Node.js のバージョンを返します。返されるバージョンが 19 以上である必要があります。
    • npm-v - マシンにインストールされている npm のバージョンを返します。返されるバージョンが 8 以上である必要があります。

  4. Android Studio をダウンロードしてインストールします。Android Studio は こちらからダウンロードできます。

  5. Windows で [システムの詳細設定] > [詳細設定] > [環境変数] に移動します。

  6. [システム環境変数] の [新規...] をクリックして、次の変数を設定します。

    1. JAVA_HOME 変数。Java がインストールされているフォルダーを指します。 変数名: JAVA_HOME。 変数値: マシン上で JDK がある場所のパスです。例: C:\Program Files\Java\jdk8。

    2. ANDROID_HOME 変数です。Android SDK がインストールされていたフォルダーを指します。

      • 変数名: ANDROID_HOME
      • 変数値: マシン上で Android SDK がある場所のパスです。例: C:\Users\Username\AppData\Local\Android\Sdk
      注:

      変数値のパス内のUsername部分は、マシンで操作しているユーザーの実際の名前に置き換える必要があります。

      1. Node.js のコマンド プロンプトを開き、Appium をインストールします。

        • Appium 1.0 の場合は、コマンド npm install -g appium を実行します。Appium 1.0 には既定ですべてのドライバーがインストールされています。
        • Appium 2.0 の場合は、コマンド npm install -g appium@next を実行します。

        Appium 2.0-beta には既定ではドライバーがインストールされていません。したがって、必要なドライバーをインストールするために、コマンド appium driver install uiautomator2 も実行する必要があります。

        Appium 2.0 の設定について詳しくは、「Quickstart Intro」をご覧ください。

        注:

        v22.10 以降の モバイル オートメーション アクティビティ パッケージには Appium 2.0 を使用することをお勧めします。

        1. コンピューターを再起動して変更を適用します。

Android エミュレーターを作成する​

Android Studio を使用して Android エミュレーターを作成します。

  1. Android Studio を開きます。

  2. [Configure] をクリックし、ドロップダウンから [SDK Manager] を選択します。

  3. [Hide Obsolete Packages] のチェックを外し、[Android SDK Tools (Obsolete)] が選択されていることを確認します。

  4. [Apply] をクリックしてから [OK] をクリックして閉じます。

  5. [Configure > AVD Manager] に移動して、仮想デバイスを設定します。詳細については、「 仮想デバイスを作成して管理する」をご覧ください。

  6. デバイスの Google アプリを更新します。

WebDriver による Web およびハイブリッドの自動化を有効化する​

ローカル デバイスで WebView のデバッグを有効化し、モバイル デバイス マネージャーでアプリケーション内の大半の UI 要素を認識できるようにします。

Appium が Android 上の Chrome または WebView のバージョンを自動検出しない場合は、以下のいずれかのオプションを選択します。

  1. --allow-insecure chromedriver_autodownload コマンドを使用します。これにより、お使いの環境に対応する ChromeDriver バージョンを Appium で自動的に検出してダウンロードできます。
  2. WebDriver for Chrome を手動で指定してダウンロードします。
    1. Android Studio でデバイスを開きます。
    2. [Settings] > [Apps & notifications] に移動します。 3. [See all apps] をクリックします。
    3. 縦三点リーダー ボタンをクリックして、ドロップダウンから [Show system] を選択します。
    4. 検索機能を使用して Android System WebView を探します。
    5. アプリを開いて [Advanced] に移動します。
    6. 画面下部のバージョン番号をコピーします。
    7. WebDriver for Chrome をダウンロードします。以下のことを考慮してください。
      • 上記のステップで見つかった Android System WebView のバージョンに対応するバージョンを選択し、フォルダーに抽出すること。
      • 完全に一致するバージョンを探すこと (メジャー.マイナー.パッチ.レビジョン)。
      • 完全に一致するバージョンを入手できない場合は、Android System WebView のメジャー バージョンに一致する最新メジャー バージョンの ChromeDriver を使用します。
      • Chrome アプリを自動化するには、上記とまったく同じ手順を実行します。その場合は、Chrome のバージョンをメモしてください。
  3. 「モバイル デバイス マネージャーにローカル Android デバイスを追加する」の手順を使用して、設定したローカルのエミュレートされたデバイスをモバイル デバイス マネージャーに追加します。

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

  1. Studio から MDM を開きます。

  2. 左側のナビゲーション パネルの [デバイス] に移動します。

  3. デバイスを次のように設定します。

    • 名前 - [デバイス] タブでデバイスを識別するための名前を入力します。

    • Appium URL - ローカルホストを入力します。例: http://localhost:10001/wd/hub。

    • プラットフォーム - フィールドをクリックして、ドロップダウンから [Android] を選択します。

    • デバイス名 - デバイスの名前を入力します。デバイス名を確認するには、Android Studio で [Configure] > [AVD Manager] に移動し、さらに [More Actions] > [View Details] を選択するという方法もあります。

    • プラットフォーム バージョン - Android OS のバージョン番号を入力します。

    • 希望する追加機能 (任意) - オートメーション セッションをカスタマイズするための固有の機能を追加します。

      重要:

      インストール済みの Appium ドライバーをアクティブ化するには、[希望する追加機能] セクションに次の機能を追加します。

      名前値 (Value)
      appium:automationNameUiAutomator2

      詳細については、「Appium Desired Capabilities」をご覧ください。

  4. (任意) - [場所] タブのデバイスの場所を、位置情報サービスを使用して位置情報データを生成するテスト アプリケーションに設定します。

  5. (任意) [ログ] タブでログ記録とビデオ記録の詳細を設定します。

  6. (任意) [開発] タブで開発プロセスを設定します。

    • 類似タブを閉じる (既定で有効): 類似のデバイスやアプリケーションとの接続を実行しているタブを閉じます。
    • ページの更新を待機 (既定で有効): ページのソースが各アクションのスクリーンショットを取得するまで待機します。

  7. [保存して閉じる] をクリックしてデバイスを追加します。

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

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

接続

ヘルプ リソース サポート

学習する UiPath アカデミー

質問する UiPath フォーラム

最新情報を取得