AppiumでAndroidアプリの画面を操作・検証する - ローソンデジタルイノベーション　テックブログ

ども。LDI品質管理部の仙波です。
スマホアプリの自動テストを担当しています。

前回は IntelliJ IDEA+Appiumでスマホアプリのテスト環境をつくりました。
今回はAndroidの設定画面を例にテストコードの作成方法を紹介したいと思います。

作成するテストのイメージ
Appium Desktopのインスペクターで画面情報を調べる
画面操作を実行するテストコードを作成する
解説
課題
関連記事

作成するテストのイメージ

Androidの設定アプリを起動し、ネットワークとインターネット画面でWi-FiのスイッチがONになっていることを確認するテストを作成します。

Appium Desktopのインスペクターで画面情報を調べる

Appiumでアプリの画面を操作するには、まず画面へアクセスする方法を調査して決定する必要があります。
インスペクターを使用すると画面をキャプチャして要素の情報を確認することができます。

インスペクターを起動します。（前回の記事をご参照ください）
画面情報を調べたい画面（ここでは設定アプリのトップ画面）を表示し、インスペクターのRefresh Source & Screenshotをクリックします。
キャプチャされた画面上でアクセスしたい要素をクリックします。

クリックした要素のtext属性の値が"ネットワークとインターネット"であることがわかります。

次に、「ネットワークとインターネット」画面においてWi-Fiのスイッチを調べます。

Wi-Fiのスイッチをユニークに指定する方法はいくつかありますが、content-descが設定されているのでこれを利用します。※content-descはアクセシビリティのために用意されている属性です。
スイッチのトグルの状態は一般にはchecked属性に設定されるので、これを利用します。このアプリではtext属性にON/OFFが設定されるのでこれを利用することもできます。

画面操作を実行するテストコードを作成する

以下の手順を実行するテストコードを作成してみます。

text属性が"ネットワークとインターネット"である要素を取得する
取得した要素をタップ（クリック）する
画面のスクリーンショットを取得する
Wi-FiのスイッチがONであることを検証する

前回作成したHelloAppiumクラスに以下のコードを追加します。

    @Test
    fun clickAndScreenshot() {

        val d = getAppiumDriver()

        // ①「ネットワークとインターネット」を取得する
        val e = d.findElementByXPath("//*[@text='ネットワークとインターネット']")

        // ②取得した要素をクリックする
        e.click()

        // ③スクリーンショットを取得してダウンロードフォルダへ格納する
        Thread.sleep(500)
        val screenshot = d.getScreenshotAs(OutputType.FILE)
        val downloads = Path.of(System.getProperty("user.home")).resolve("Downloads")
        screenshot.copyTo(File("$downloads/screenshot1.png"), overwrite = true)

        // ④Wi-FiのスイッチがONであることを検証する
        val wifiSwitch = d.findElementByXPath("//*[@content-desc='Wi-Fi']")
        assertThat(wifiSwitch.getAttribute("checked")).isEqualTo("true")    // checked属性の値で検証
        assertThat(wifiSwitch.getAttribute("text")).isEqualTo("ON")         // text属性の値で検証
    }