Appiumモバイルテスト自動化入門(1) 〜環境構築と初めてのテスト〜

# Appium本体のインストール
npm install -g appium

# インストールの確認
appium -v

3.1.1

# Android用UiAutomator2ドライバのインストール
appium driver install uiautomator2

# インストール済みドライバの確認
appium driver list --installed

✔ Listing installed drivers
- uiautomator2@6.3.0 [installed (npm)]

# 環境変数の確認
echo $JAVA_HOME
echo $ANDROID_HOME
echo $PATH

# Java
export JAVA_HOME=$(/usr/libexec/java_home -v 8)

# Android SDK
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$ANDROID_HOME/platform-tools:$PATH
export PATH=$ANDROID_HOME/cmdline-tools/latest/bin:$PATH
export PATH=$ANDROID_HOME/emulator:$PATH

# 設定を反映
source ~/.zshrc  # または source ~/.bash_profile

# Appium Doctorのインストール
npm install -g appium-doctor

# Android環境のチェック
appium-doctor --android

info AppiumDoctor Appium Doctor v.1.16.2
info AppiumDoctor ### Diagnostic for necessary dependencies starting ###
…
info AppiumDoctor ### Diagnostic for optional dependencies starting ###
…

# 接続されているデバイスを確認
adb devices

List of devices attached
emulator-5554   device

# Appium Pythonクライアントのインストール
pip install Appium-Python-Client

# Seleniumライブラリ（依存関係）
pip install selenium

# pytest（テストフレームワーク）
pip install pytest

from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.common.appiumby import AppiumBy
import time

def test_android_settings():
    # Desired Capabilitiesの設定
    options = UiAutomator2Options()
    options.platform_name = 'Android'
    options.automation_name = 'UiAutomator2'
    options.device_name = 'emulator-5554'  # adb devicesで確認したデバイス名

    # 設定アプリを起動（アプリのインストール不要）
    options.app_package = 'com.android.settings'
    options.app_activity = '.Settings'

    # セッション開始までのタイムアウト設定
    options.new_command_timeout = 300

    # Appium Serverに接続
    driver = webdriver.Remote('http://localhost:4723', options=options)

    try:
        print("✓ 設定アプリが起動しました")

        # アプリが起動するまで少し待機
        time.sleep(2)

        # 現在のアクティビティを取得
        current_activity = driver.current_activity
        print(f"✓ 現在のアクティビティ: {current_activity}")

        # 画面上の要素を検索（検索ボックスを探す）
        search_elements = driver.find_elements(AppiumBy.CLASS_NAME, 'android.widget.TextView')
        print(f"✓ 画面上に {len(search_elements)} 個のTextView要素が見つかりました")

        # 最初のいくつかの要素のテキストを表示
        print("\n--- 画面上の要素 ---")
        for i, element in enumerate(search_elements[:5]):
            text = element.text
            if text:
                print(f"{i+1}. {text}")

        # スクリーンショットを保存
        driver.save_screenshot('settings_app.png')
        print("✓ スクリーンショットを保存しました: settings_app.png")

        print("\n✓ テスト成功！")

    except Exception as e:
        print(f"✗ エラーが発生しました: {e}")
        driver.save_screenshot('error_screenshot.png')

    finally:
        # セッションを終了
        driver.quit()
        print("✓ セッションを終了しました")

if __name__ == '__main__':
    test_android_settings()

# デフォルトポート（4723）で起動
appium

# または、ログレベルを指定して起動
appium --log-level info

[Appium] Welcome to Appium v3.1.1
[Appium] The autodetected Appium home path: /Users/testkit/.appium
[Appium] Attempting to load driver xcuitest...
[Appium] Attempting to load driver uiautomator2...
[Appium] Requiring driver at /Users/testkit/.appium/node_modules/appium-uiautomator2-driver/build/index.js
[Appium] Requiring driver at /Users/testkit/.appium/node_modules/appium-xcuitest-driver/build/index.js
[Appium] AndroidUiautomator2Driver has been successfully loaded in 1.403s
[Appium] XCUITestDriver has been successfully loaded in 3.417s
[Appium] Appium REST http interface listener started on http://0.0.0.0:4723
[Appium] You can provide the following URLs in your client code to connect to this server:
    http://127.0.0.1:4723/ (only accessible from the same host)
    http://192.168.3.13:4723/
    http://192.168.64.1:4723/
    http://172.32.1.15:4723/
    http://172.32.1.34:4723/
    http://172.32.1.26:4723/
[Appium] Available drivers:
[Appium]   - xcuitest@10.8.0 (automationName 'XCUITest')
[Appium]   - uiautomator2@6.3.0 (automationName 'UiAutomator2')
[Appium] No plugins have been installed. Use the "appium plugin" command to install the one(s) you want to use.

# スクリプトを実行
python test_android_settings.py

✓ 設定アプリが起動しました
✓ 現在のアクティビティ: .Settings
✓ 画面上に 42 個のTextView要素が見つかりました

--- 画面上の要素 ---
1. Settings
2. Network & internet
3. Connected devices
4. Apps
5. Notifications

✓ スクリーンショットを保存しました: settings_app.png
✓ テスト成功！
✓ セッションを終了しました