コンテンツにスキップ

UiAutomator2 ドライバーのインストール

Appium を活用するには、特定のプラットフォームを自動化するインターフェースであるドライバーが必要です。

情報

このクイックスタートガイドでは、Android プラットフォームでアプリを自動化します。これは、Appium を介した Android オートメーションのシステム要件が Appium 自体と同じであるためです（一方、iOS ドライバーは macOS を使用する必要があります）。

使用するドライバーはUiAutomator2 ドライバーと呼ばれます。 このドライバーのドキュメントにアクセスしてブックマークすることをお勧めします。これは、今後の貴重な参考資料となるためです。

Android オートメーションの要件を設定する

ドライバーによると、動作する Appium サーバーに加えて、以下を設定する必要があります。

Android SDK

  • Android SDK の要件を設定する最も簡単な方法は、Android Studioをダウンロードすることです。 SDK マネージャー（ *設定 -> 外観と動作 -> システム設定 -> Android SDK* ）を使用して、以下のアイテムをダウンロードする必要があります。
    • Android SDK プラットフォーム（自動化する Android プラットフォームを選択します。例：API レベル 30）
    • Android SDK Platform-Tools
  • 必要であれば、Android Studio なしでこれらのアイテムをダウンロードすることもできます。
  • `ANDROID_HOME` 環境変数を、Android SDK がインストールされているディレクトリを指すように設定します。 通常、このディレクトリへのパスは Android Studio SDK マネージャーにあります。 `platform-tools` などのディレクトリが含まれています。

Java JDK

  • Java JDK をインストールします（最新の Android API レベルでは JDK 9 が必要です。それ以外の場合は JDK 8 が必要です）。 Oracle または Adoptium からダウンロードできます。JRE ではなく JDK を入手してください。
  • `JAVA_HOME` 環境変数を JDK ホームディレクトリを指すように設定します。 `bin`、`include` などのディレクトリが含まれています。

デバイスの準備

  • エミュレーターを使用する場合は、Android Studio を使用して Android Virtual Device（AVD）を作成して起動します。 作成するエミュレーターの API レベルのシステムイメージをダウンロードする必要がある場合があります。 Android Studio の AVD 作成ウィザードを使用するのが、これらすべてを実行する最も簡単な方法です。
  • 実機を使用する場合は、開発用に設定し、USB デバッグを有効にする必要があります。
  • エミュレーターまたはデバイスが接続されている状態で、 `adb devices` （ `$ANDROID_HOME/platform-tools/adb` にあるバイナリ経由）を実行して、デバイスが接続済みとして表示されることを確認できます。

デバイスが `adb` に接続済みとして表示され、環境変数が正しく設定されていることを確認したら、準備完了です。 これらの手順のいずれかで問題が発生した場合は、ドライバーのドキュメント、または必要に応じてさまざまな Android または Java のドキュメントサイトを参照してください。

また、おめでとうございます。意図したかどうかにかかわらず、システムに Android 開発ツールチェーンが設定されたので、必要であれば Android アプリの作成に取り掛かることができます。

ドライバー自体のインストール

UiAutomator2 ドライバーはコア Appium チームによって保守されているため、Appium 拡張 CLIを介して簡単にインストールできる「公式」ドライバー名があります。

appium driver install uiautomator2

次のような出力が生成されます。

Attempting to find and install driver 'uiautomator2'
✔ Installing 'uiautomator2' using NPM install spec 'appium-uiautomator2-driver'
Driver [email protected] successfully installed
- automationName: UiAutomator2
- platformNames: ["Android"]

このコマンドを実行すると、UiAutomator2 ドライバーの最新バージョンが検索されてインストールされ、自動化に使用できるようになります。 インストールされると、有効なプラットフォーム（この場合は `Android`）と、Appium セッション中にこのドライバーを使用するために使用される必要がある自動化名（ `appium:automationName` ケーパビリティ）（この場合は `UiAutomator2`）が表示されます。

注意

このクイックスタートでは、拡張 CLIを使用して UiAutomator2 ドライバーをインストールしましたが、Appium を Node.js プロジェクトに組み込む場合は、 `npm` を使用して Appium とそれに接続されたドライバーを管理することをお勧めします。 この手法の詳細については、Appium 拡張機能の管理に関するガイドをご覧ください。

Appium サーバーを再起動します（ `appium` を実行します）。新しくインストールされたドライバーが利用可能としてリストされます。

[Appium] Available drivers:
[Appium]   - [email protected] (automationName 'UiAutomator2')

Android のセットアップが完了し、UiAutomator2 ドライバーがインストールされたので、最初のテストを作成する準備ができました。希望の言語を選択して試してみてください。