Outline
Native APPのテスト自動化をおこなうにあたり、inspector を使って各パーツのlocation(XPath) を知る必要がある。
テスト自動化では、このlocationをもとに、touchなどの操作を行うからである。
ここでは、そのinspectorを使い、xpathをとるまでの手順を整理したものである。
environment
| Item | Version | Note |
|---|---|---|
| Windows | 10 | |
| Java | 11 | |
| Android Studio | 2021.2.1 Patch 1 | |
| Appium Server Desktop | 1.18 |
install JAVA
Javaが全般的に必要になるため、installする
Environment Variablesの設定をする
Ex. (installした環境、versionによって異なります)
| Name | Value |
|---|---|
| JAVA_HOME | C:\Program Files\Java\jdk-11.0.15 |
install Android Studio
主にadbを使用するためにinstallする
一通りinstallする。
Tool -> SDK Manager -> Android SDK
こちらにて、SDK Platform Tools がinstallされていることを確認する
Environment Variablesの設定をする
ANDROID_HOMEのpathは "Tool -> SDK Manager -> Android SDK "で確認ができる
Ex. (installした環境、versionによって異なります)
| Name | Value |
|---|---|
| ANDROID_HOME | C:\Users\xxxxx\AppData\Local\Android\Sdk |
install Appium Server Desktop
今回、最新ではなく1.18をもちいた。
1.20あたりから、inspectorはserverと分離された。
今時点、ver 1.21でinspectorをtryしてみたが、1.18と同じ結果がでず、うまくいかなかった。
そのため、1.18を用いた
installする
setup
1. get device udid
android端末の設定で、"開発者向けオプション" -> "USBデバッグ" を onにする
android端末をUSB接続する
以下コマンド
adb devices
すると、接続しているandroid端末のudidが取得できる。
2. set app apk
対象androidにapp (apk) をinstallする
apkをwindowsのlocalに配置する
今回、My Documentに配置した
3. start appium
appiumをdefaultで起動する
Inspectorを起動する
inspectorにて、JSON Representationにcapabilitiesを記載する
capabilities は環境、アプリによってことなります
とりあえず、最低限の設定項目は以下になります
| Name | Value |
|---|---|
| platformName | Android |
| deviceName | Androidの端末名 (ex. Pixel) |
| udid | 端末ID 先ほどadbで取得した値 |
| platformVersion | Android version (ex. 11) |
| app | windowsに配置したapkのpath ※1 |
| appPackage | appの名前 ※2 |
| autoGrantPermissions | true : 承認系のpopupをskipできる |
※1 app
windowsのappのpathの取り方がよくわからなかった。
C:\xxxx ではだめだった
以下のようにMy Documentsに置いた場合
C:\Users\xxxxx\Documents\xxxx.apk
appは以下のようになる
/Users/xxxxx/Documents/xxxx.apk
※2 appPackageの取り方
androidにInstallされているappPackage listが取得できる
ここから対象の探す
adb shell pm list packages
最終的に、以下のように設定する
そして、セッションを開始する をクリック
すると、windows上でappのUIが表示される。
そして、各パーツをクリックすると、xpathを取得できる