モバイルアプリのテスト自動化を行うために必要な環境を整えよう（Mac環境）

はじめに

T-DASHではモバイルアプリのテストを実行することができますが、T-DASH以外に複数のソフトウェアが必要となります。
本ページでは、モバイルアプリのテストを実施するにあたり必要なソフトウェアのセットアップを行います。

ゴール

モバイルアプリのテスト実行に必要な準備がすべて完了する。

前提

モバイルアプリを所持している
実機でテストを行う場合は端末とUSBケーブルを所持している
iOS環境において実機でテストを行う場合、Apple Developer Programの有料メンバーシップであること
（無料メンバーシップの場合の動作については当社サポート範囲外となります。）

https://nodejs.org/en/にアクセスする。
「Download Node.js(LTS)」ボタンをクリックする。
ダウンロードしたファイルを実行する。
インストーラーの画面指示に従って、node.jsをインストールする。
ターミナルで下記コマンドを実行し、nodeのバージョンが表示されていることを確認する。
node -v

appiumとdriverのインストール

推奨バージョン：2以上

ターミナルを開く
「npm install –location=global appium」と入力し実行。
「appium –version」と入力し実行。下図のようにバージョンが表示されていることを確認。
Androidをテスト対象とする場合は、下記コマンドを実行しドライバをインストールする。
appium driver install uiautomator2
iOSをテスト対象とする場合、下記コマンドを実行しドライバをインストールする。
appium driver install xcuitest
インストール対象のドライバが「installed」表示となっているか、下記コマンドで確認する。
appium driver list

Java(JDK)のインストール

推奨バージョン：JDK 9以上

https://www.oracle.com/technetwork/java/javase/downloads/index.htmlにアクセスする。
推奨バージョン以上のタブをクリックし、使用PCに適したリンクをクリックしてJDKをダウンロードする。
ダウンロードしたファイルを実行する。
インストーラーの画面指示に従って、JDKをインストールする。

Android Studioのインストールと環境設定

推奨バージョン：指定なし

https://developer.android.com/studio/?hl=jaにアクセスする。
「Android Studio Koalaをダウンロード」ボタンをクリックし、利用規約が表示されるので同意のチェックを入れ、ご利用のPC環境に合わせたボタンをクリックする。
ダウンロードしたファイルをApplicationに移動して実行し、インストーラーの画面指示に従って、Android Studioをインストールする。
Android Studioを起動し、アプリメニューで「Android Studio」→「Settings」の順にクリック
「Settings」ダイアログの「Languages & Frameworks > Android SDK」の項目に記載されているAndroid　SDK　Locationのパスをテキストとしてコピーしておく
ターミナルを開いてシェルの設定ファイルを編集する（.zshrcもしくは.bashrc）
nano ~/.zshrc
nano ~/.bashrc
シェルの設定ファイルに下記のパスを追加し保存する
export ANDROID_HOME=(前の手順でコピーしたAndroid SDK Locationのパス) export PATH=$ANDROID_HOME/platform-tools:$PATH
設定を反映させる
source ~/.zshrc source ~/. bashrc
下記コマンドを実行し、下図のようにバージョンが表示されていることを確認

Android端末の準備（実機を使用してテストを行う場合）

実機でテスト自動化を行う場合、端末のUSBデバッグを有効にする必要があります。
有効化手順はお使いの端末によって異なるため、詳細は製造元のマニュアルなどご確認ください。

Androidの設定画面を開き、デバイス情報をタップして開く
表示されている「ビルド番号」を複数回続けてタップする。
開発者モードが有効になるとトースト通知が表示されるので、前の画面に戻ってシステムをタップ
詳細設定をタップして、開発オプションをタップ。開発者向けオプションがONになっていることを確認し、USBデバッグをONにする。

Androidエミュレーターの準備（仮想端末を使用してテストを行う場合）

エミュレーターを利用するにはAndroidStudioに付属するDeviceManagerで端末のセットアップを行う必要があります。

AndroidStudioを起動する
左上ハンバーガーメニューをクリックし、「Tools」→「Device Manager」をクリックする。
ウィンドウ右側にDeviceManagerが表示されるため、「+」ボタン→「Create Virtual Device」の順にクリックする。
「Select Hardware」内のCategoryで「Phone」をクリックし、任意の端末をクリック。「Next」ボタンをクリックする。
「System Image」内の任意のOSバージョンをクリックし、「Next」ボタンをクリックする。
※未ダウンロードのOSバージョンの場合には、「Download」ボタンをクリックして、ダウンロードしてください。
「Android Virtual Device (AVD)」内の「AVD Name」テキストボックスに、任意の文字列を入力し、「Finish」ボタンをクリックする。
※入力済みの内容で問題なければ、そのまま進めてください。
「Device Maneger」内に作成したエミュレーターが追加されたことを確認する。

Xcodeのインストール

推奨バージョン：指定なし

App Storeで「Xcode」を検索し、インストールする。
XCodeを起動すると初回起動時のみXcodeとiOSのライセンス承諾のダイアログが表示されるので「Agree」をクリック。
PCのユーザ名とパスワードを入力し「OK」をクリック。
プラットフォームの選択ダイアログが表示されるので、iOSを選択して「Downdload & Install」をクリックし、インストールを開始する。
※別のバージョンのシミュレーターを利用したい場合は「iOSシミュレーターの準備」の手順を参照してください。
What’s New in Xcode と表示されるので「Continue」をクリック。
下記のダイアログが表示され、セットアップとしてはここまでで完了です。

ios-deployのインストール

ターミナルを開いて下記コマンドを実行する。
npm install -g ios-deploy
下記コマンドでインストールが完了したか確認する。
ios-deploy --version

iOS端末の準備（実機端末を使用してテストを行う場合）

実機でテスト自動化を行う場合、端末のデベロッパーモードまたはUI自動化を有効にする必要があります。

iOS 16以降

設定アプリを開き「プライバシーとセキュリティ」をタップ。
「デベロッパーモード」をタップし、「デベロッパーモード」をONに変更すると再起動を求められるため、再起動します。
再起動完了後、パスコードを入力するとデベロッパーモードがONとなります。
※デベロッパーモードが表示されていない場合、XCodeを開いた状態で端末を接続する必要があります。
Enabling Developer Mode on a device | Apple Developer Documentation

iOS15 以前

設定アプリを開き「デベロッパ」をタップ。
「Enable UI Automation」をONに変更する。
※デベロッパーモードが表示されていない場合、XCodeを開いた状態で端末を接続する必要があります。

iOSシミュレーターの準備（仮想端末を使用してテストを行う場合）

アプリメニューで「Xcode」→「Settings」の順にクリック。
Platformsのダイアログが開くので、ダイアログ左下の「+」ボタンをクリックして「iOS」を選択。
iOSのバージョン一覧が表示されるので、任意のバージョンを選択して「Download & Install」をクリック。指定したバージョンのシミュレーターのダウンロードが開始される。
ダウンロード完了後、アプリメニューで「Xcode」→「Open Developer Tool」→「Simulator」の順にクリックして「Simulator」を起動する。
起動した「Simulator」のアプリメニューで「File」→「Open Simulator」とクリックすると、指定したバージョン（今回の例だとiOS17.4）が追加されているので、そちらを選択して使用する端末をクリックする。　
指定したバージョン・端末のシミュレーターが起動する。