MENU
  1. ホーム
  2. PowerShell
  3. PowerShellでADBを操作してAndroidエミュレーターを自動化する方法

PowerShellでADBを操作してAndroidエミュレーターを自動化する方法

PowerShell

PowerShellを使用してAndroid Debug Bridge（ADB）を操作し、Androidエミュレーターを自動化する方法について解説します。

Androidアプリ開発やテストでは、エミュレーターや実機デバイスをADB（Android Debug Bridge）を介して操作することが一般的です。通常、ADBはコマンドプロンプトやターミナルから手動でコマンドを入力して実行しますが、繰り返し作業を行う際には手間がかかります。そこで、PowerShellを活用することでADBコマンドをスクリプト化し、エミュレーターの操作を自動化できます。

本記事では、PowerShellを用いてADBを制御し、エミュレーターの起動・接続、アプリのインストール、自動テスト、スクリーンキャプチャの取得などを効率的に行う方法を詳しく解説します。さらに、エラー処理やデバッグ方法についても触れ、より実用的なスクリプトの作成を目指します。

PowerShellとADBを組み合わせることで、開発やテストの効率を大幅に向上させることが可能です。これから、基本的な使い方から実践的なスクリプトまで、順を追って説明していきます。

目次
  1. PowerShellとADBの概要
    1. PowerShellとは
    2. ADB（Android Debug Bridge）とは
    3. PowerShellとADBの連携のメリット
  2. ADBのインストールと設定
    1. ADBのダウンロードとインストール
    2. PowerShellでADBを使用するための準備
  3. PowerShellからADBを実行する方法
    1. PowerShellでADBコマンドを実行する基本
    2. ADBコマンドをPowerShellスクリプトで実行する
    3. PowerShellスクリプトを作成して実行
    4. PowerShellでADBコマンドのエラーを処理する
    5. まとめ
  4. エミュレーターの起動と接続
    1. Androidエミュレーターの準備
    2. PowerShellからエミュレーターを起動する
    3. ADBでエミュレーターに接続
    4. エミュレーターの自動起動スクリプト
    5. エミュレーターが認識されない場合の対処
    6. まとめ
  5. ADBを使用したエミュレーター操作の自動化
    1. PowerShellでADBを活用した自動化の概要
    2. アプリのインストールとアンインストール
    3. スクリーンキャプチャの取得
    4. ログの取得（Logcat）
    5. キーボード入力の自動化
    6. タップとスワイプの自動化
    7. 音量や電源の制御
    8. まとめ
  6. PowerShellスクリプトによる高度な自動化
    1. 高度な自動化の概要
    2. 条件分岐を使ったADBコマンド実行
    3. デバイスの接続を確認して処理を分岐する
    4. ループを使用した繰り返し処理
    5. 一定間隔でスクリーンショットを自動取得
    6. 複数のデバイスを同時に操作
    7. 接続されている全デバイスにアプリをインストール
    8. ログを監視して特定のイベントを検出
    9. エラーログを検出して通知
    10. エラーハンドリングと例外処理
    11. ADBの実行時エラーをキャッチする
    12. 応用：アプリの自動テストスクリプト
    13. まとめ
  7. エラー処理とデバッグ方法
    1. エラー処理の重要性
    2. PowerShellのTry-Catchを活用したエラーハンドリング
    3. ADBコマンド実行時のエラー処理
    4. ADBのエラーログを確認する
    5. エラーログを取得する
    6. デバイスの接続状態を確認する
    7. 接続デバイスの確認
    8. 特定のADBエラーを処理する
    9. エミュレーターが起動しない場合
    10. エラー時にスクリプトを自動停止する
    11. エラー発生時にスクリプトを強制終了
    12. スクリプトのデバッグ方法
    13. デバッグ情報を出力
    14. リトライ機能を実装する
    15. 3回リトライするADBコマンド
    16. まとめ
  8. 実践例：アプリのテスト自動化
    1. テスト自動化の概要
    2. テスト自動化の手順
    3. サンプルスクリプト：アプリの起動とボタン操作
    4. スクリプトの動作解説
    5. スクリプトの改良ポイント
    6. 複数回タップを繰り返す
    7. テスト結果をログファイルに記録
    8. 実用例：フォーム入力を自動化
    9. エミュレーターの起動からテスト完了までを自動化
    10. まとめ
  9. まとめ
    1. 学んだポイント
    2. PowerShellとADBを活用するメリット
    3. 次に挑戦すべきこと
    4. まとめ

PowerShellとADBの概要

PowerShellとは


PowerShellは、Windowsに標準搭載されているスクリプト言語およびコマンドラインシェルです。従来のコマンドプロンプト（cmd）よりも強力で、オブジェクト指向の処理が可能なため、システム管理やタスクの自動化によく利用されます。

PowerShellの特徴として、以下が挙げられます。

  • 豊富なコマンドレット（Cmdlet）：PowerShell独自のコマンドが多数用意されており、さまざまなタスクを簡単に実行可能。
  • スクリプト作成が容易：PowerShellスクリプト（.ps1ファイル）を作成し、繰り返し実行ができる。
  • 外部プログラムとの連携：PowerShellは外部のコマンドやツール（例えば、ADB）を呼び出すことができる。

ADB（Android Debug Bridge）とは


ADB（Android Debug Bridge）は、Androidデバイスと通信するためのコマンドラインツールです。Googleが提供する開発ツールの一部であり、Android SDKに含まれています。

ADBを利用すると、以下のような操作が可能です。

  • デバイスの接続・制御：エミュレーターや実機デバイスと接続し、コマンドを送信できる。
  • アプリのインストール・アンインストール：開発中のアプリを素早くデバイスにインストールしてテストが可能。
  • スクリーンキャプチャ・ログ取得：デバイスの画面をキャプチャしたり、ログを取得してデバッグできる。

PowerShellとADBの連携のメリット


PowerShellとADBを組み合わせることで、以下のようなメリットがあります。

  • 反復作業の自動化：ADBコマンドをPowerShellスクリプトにまとめることで、手作業を減らせる。
  • バッチ処理の効率化：複数のADBコマンドを連続で実行できるため、アプリのテストやデバイス管理がスムーズになる。
  • エラー処理の組み込み：PowerShellの条件分岐や例外処理を活用し、ADB実行時のエラーを適切に処理できる。

本記事では、PowerShellを用いてADBをスクリプトで制御し、Androidエミュレーターを効率的に管理する方法を詳しく解説します。

ADBのインストールと設定

ADBのダウンロードとインストール


ADBは、Android SDKの一部として提供されていますが、単体でダウンロードすることも可能です。以下の手順でWindows環境にADBをインストールします。

  1. ADBツールのダウンロード
  • Google公式サイト から “SDK Platform Tools” をダウンロードします。
  • Windows版のZIPファイルを取得してください。
  1. ZIPファイルの展開
  • ダウンロードしたZIPファイルを任意のフォルダに解凍します（例：C:\adb）。
  1. 環境変数の設定（推奨）
    ADBをどこからでも実行できるように、adb.exe のパスを環境変数に追加します。
  • Win + R キーを押し、sysdm.cpl を入力し [OK] をクリック。
  • [詳細設定] タブの [環境変数] を開く。
  • “Path” を選択し [編集] をクリック。
  • C:\adb （解凍したフォルダのパス）を追加し、[OK] を押して保存。
  1. インストール確認
  • Win + R → cmd と入力しコマンドプロンプトを開く。
  • 以下のコマンドを実行：
    powershell adb version
  • ADBのバージョン情報が表示されれば、インストールは成功です。

PowerShellでADBを使用するための準備


PowerShellからADBを実行する前に、Windowsでの実行ポリシー設定を確認しておきましょう。

  1. PowerShellを管理者モードで開く
  • Win + X → [Windows PowerShell (管理者)] を選択。
  1. スクリプト実行ポリシーの変更（必要に応じて）
  • PowerShellでスクリプトを実行するには、適切な権限が必要です。
  • 以下のコマンドを実行して、スクリプトの実行を許可します。
    powershell Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  • [Y]（Yes）を入力して確定。
  1. ADBがPowerShellで動作するか確認
  • PowerShellで以下のコマンドを実行：
    powershell adb devices
  • 接続中のデバイスまたはエミュレーターのリストが表示されれば、PowerShellでADBを使用する準備が完了です。

次のステップでは、PowerShellスクリプトを使ってADBコマンドを実行する方法を紹介します。

PowerShellからADBを実行する方法

PowerShellでADBコマンドを実行する基本


PowerShellからADBを操作するには、adb コマンドをPowerShellスクリプト内で呼び出します。基本的な実行方法は以下の通りです。

  1. PowerShellで直接ADBコマンドを実行
    PowerShellのターミナル上で次のように入力すると、接続されているデバイスまたはエミュレーターを一覧表示できます。
   adb devices


正しく動作すると、次のような出力が表示されます。

   List of devices attached
   emulator-5554   device
  1. PowerShellスクリプト内でADBを実行
    ADBコマンドをPowerShellスクリプトに組み込むことも可能です。以下のスクリプトは、接続されたデバイスを一覧表示するものです。
   $output = adb devices
   Write-Output $output


Write-Output を使って、ADBの実行結果をPowerShellのコンソールに表示できます。

ADBコマンドをPowerShellスクリプトで実行する


PowerShellスクリプトを作成して、ADBの操作を自動化することができます。例えば、エミュレーターを起動し、スクリーンショットを取得するスクリプトを作成してみましょう。

  1. エミュレーターの起動
    AVD（Android Virtual Device）を起動するには、次のコマンドを実行します。
   Start-Process -FilePath "C:\Users\<USERNAME>\AppData\Local\Android\Sdk\emulator\emulator.exe" -ArgumentList "-avd Pixel_3a_API_30"


※ <USERNAME> の部分は、ご自身のユーザー名に置き換えてください。

  1. デバイスの接続を確認する
   adb wait-for-device
   adb devices


adb wait-for-device は、デバイスが接続されるまで待機するコマンドです。

  1. スクリーンショットを取得する
    Androidエミュレーターの画面をキャプチャし、PCに保存するには以下のスクリプトを実行します。
   adb shell screencap -p /sdcard/screenshot.png
   adb pull /sdcard/screenshot.png C:\Users\<USERNAME>\Desktop\screenshot.png


これにより、Androidデバイス内にキャプチャされた画像がPCのデスクトップに保存されます。

PowerShellスクリプトを作成して実行


上記のコマンドをPowerShellスクリプト (.ps1 ファイル) にまとめることで、繰り返し実行可能な自動化スクリプトを作成できます。以下の手順でスクリプトを作成・実行してみましょう。

  1. PowerShellスクリプトファイルを作成
  • adb_script.ps1 というファイルを作成し、次のコードを記述します。
    powershell # ADBを用いてAndroidエミュレーターを制御するスクリプト adb wait-for-device adb shell screencap -p /sdcard/screenshot.png adb pull /sdcard/screenshot.png C:\Users\<USERNAME>\Desktop\screenshot.png Write-Output "スクリーンショットを取得し、デスクトップに保存しました。"
  1. PowerShellスクリプトを実行
    PowerShellを開き、スクリプトのあるフォルダへ移動した後、次のコマンドを実行します。
   .\adb_script.ps1


実行すると、スクリーンショットがデスクトップに保存されます。

PowerShellでADBコマンドのエラーを処理する


ADBコマンドの実行時にエラーが発生することがあります。その場合、PowerShellのTry-Catch 構文を使用すると、エラー処理を組み込むことができます。

try {
    adb devices
    Write-Output "ADBデバイスが正常にリストされました。"
} catch {
    Write-Output "エラーが発生しました: $_"
}

まとめ

  • PowerShellから直接ADBコマンドを実行できる。
  • ADBのコマンドをPowerShellスクリプトに組み込むことで、Androidエミュレーターの操作を自動化できる。
  • スクリプトの作成・実行により、繰り返し作業を効率化できる。
  • Try-Catch を使って、ADB実行時のエラー処理を適切に管理できる。

次のステップでは、エミュレーターの起動や接続に関する詳細な手順を解説します。

エミュレーターの起動と接続

Androidエミュレーターの準備


PowerShellからADBを使用してエミュレーターを制御する前に、Androidエミュレーター（AVD: Android Virtual Device）をセットアップする必要があります。エミュレーターを利用するための準備手順は以下の通りです。

  1. Android Studioのインストール
  • Android Studioの公式サイト からダウンロードし、インストールします。
  • インストール時に Android SDK と AVD Manager もセットアップされます。
  1. AVD（Android Virtual Device）の作成
  • Android Studio を起動し、AVD Manager を開く。
  • 新しいエミュレーターを作成し、適切なデバイスとAPIレベルを選択。
  • 設定が完了したら、保存してAVDを作成。

PowerShellからエミュレーターを起動する


エミュレーターをPowerShellスクリプトから起動するには、emulator.exe を使用します。通常、この実行ファイルはAndroid SDKの emulator フォルダにあります。

Start-Process -FilePath "C:\Users\<USERNAME>\AppData\Local\Android\Sdk\emulator\emulator.exe" -ArgumentList "-avd Pixel_3a_API_30"
  • -avd Pixel_3a_API_30 の部分は、作成したエミュレーターの名前に変更してください。
  • <USERNAME> の部分は、ご自身のWindowsユーザー名に置き換えてください。

ADBでエミュレーターに接続


エミュレーターを起動した後、PowerShellからADBを使用して接続を確認します。

  1. エミュレーターの起動を待機
   adb wait-for-device

このコマンドを実行すると、エミュレーターが完全に起動するまで処理がブロックされます。

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

実行結果が次のように表示される場合、エミュレーターが正しく接続されています。

   List of devices attached
   emulator-5554   device
  1. デバイスの詳細情報を取得
    エミュレーターの詳細情報を取得するには、次のコマンドを実行します。
   adb shell getprop ro.product.model

これにより、エミュレーターのデバイスモデル名が表示されます。

エミュレーターの自動起動スクリプト


エミュレーターの起動からADB接続確認までを自動化するPowerShellスクリプトを作成できます。

# Androidエミュレーターを起動
Write-Output "エミュレーターを起動します..."
Start-Process -FilePath "C:\Users\<USERNAME>\AppData\Local\Android\Sdk\emulator\emulator.exe" -ArgumentList "-avd Pixel_3a_API_30"

# エミュレーターの起動を待機
Write-Output "エミュレーターの起動を待機しています..."
adb wait-for-device

# 接続確認
Write-Output "接続中のデバイス一覧:"
adb devices

# デバイス情報を取得
Write-Output "エミュレーターのモデル情報:"
adb shell getprop ro.product.model

エミュレーターが認識されない場合の対処


エミュレーターが adb devices で表示されない場合、以下の方法を試してください。

  1. ADBの再起動
   adb kill-server
   adb start-server

これでADBサーバーを再起動できます。

  1. エミュレーターの手動起動
    Android Studio の AVD Manager からエミュレーターを直接起動し、再度 adb devices を実行してください。
  2. USBデバッグの有効化（実機の場合）
  • 設定 → 開発者向けオプション → USBデバッグ を有効にする。
  • adb devices を実行し、デバイスに表示される「USBデバッグを許可しますか？」のダイアログで「許可」を選択する。

まとめ

  • PowerShellを使ってAndroidエミュレーターを起動できる。
  • adb wait-for-device を使用して接続の完了を待機できる。
  • adb devices で接続確認し、詳細情報を取得できる。
  • 問題発生時には、ADBの再起動やエミュレーターの手動起動を試す。

次のステップでは、ADBを使用してエミュレーターの操作を自動化する方法を解説します。

ADBを使用したエミュレーター操作の自動化

PowerShellでADBを活用した自動化の概要


PowerShellを用いることで、ADBコマンドをスクリプト化し、エミュレーターの操作を自動化できます。これにより、アプリのインストール、ログの取得、スクリーンキャプチャの撮影、端末の制御などを簡単に行えます。

アプリのインストールとアンインストール


エミュレーターや実機デバイスにアプリをインストール・アンインストールするには、以下のADBコマンドを使用します。

  1. アプリのインストール
   adb install "C:\path\to\app.apk"

成功すると Success と表示されます。

  1. アプリのアンインストール
   adb uninstall com.example.app

パッケージ名（com.example.app）を指定してアプリを削除します。

  1. PowerShellスクリプトで自動化
    以下のスクリプトを作成すれば、アプリのインストールを自動化できます。
   $apkPath = "C:\path\to\app.apk"
   if (Test-Path $apkPath) {
       adb install $apkPath
       Write-Output "アプリをインストールしました。"
   } else {
       Write-Output "指定されたAPKファイルが見つかりません。"
   }

スクリーンキャプチャの取得


エミュレーターの画面をキャプチャし、PCへ転送するには以下のコマンドを使用します。

  1. スクリーンショットを取得し、端末に保存
   adb shell screencap -p /sdcard/screenshot.png
  1. スクリーンショットをPCへ転送
   adb pull /sdcard/screenshot.png C:\Users\<USERNAME>\Desktop\screenshot.png
  1. PowerShellスクリプトで自動化
   $screenshotPath = "/sdcard/screenshot.png"
   $savePath = "C:\Users\<USERNAME>\Desktop\screenshot.png"

   adb shell screencap -p $screenshotPath
   adb pull $screenshotPath $savePath
   Write-Output "スクリーンショットを取得し、デスクトップに保存しました。"

ログの取得（Logcat）


Androidの logcat を利用すれば、アプリの動作ログを取得し、デバッグに活用できます。

  1. リアルタイムでログを表示
   adb logcat
  1. ログをファイルに保存
   adb logcat -d > C:\Users\<USERNAME>\Desktop\logcat.txt

-d オプションを付けることで、一度だけログを取得し、logcat.txt に保存できます。

  1. PowerShellスクリプトでログを取得
   $logPath = "C:\Users\<USERNAME>\Desktop\logcat.txt"
   adb logcat -d > $logPath
   Write-Output "ログを取得しました。ファイル: $logPath"

キーボード入力の自動化


PowerShellとADBを組み合わせることで、キーボード入力をエミュレーター上で自動化できます。

  1. 特定のキーを送信
   adb shell input keyevent 66  # Enterキー
   adb shell input keyevent 3   # ホームボタン
  1. 文字入力
   adb shell input text "Hello%sworld"

Androidの input text コマンドは、%s をスペースとして解釈するため、スペースを含む文字列を入力する際に注意が必要です。

  1. PowerShellスクリプトで自動入力
   $text = "Hello%sworld"
   adb shell input text $text
   Write-Output "文字 '$text' を入力しました。"

タップとスワイプの自動化


画面のタップやスワイプをシミュレーションすることも可能です。

  1. 特定の座標をタップ
   adb shell input tap 500 1000
  1. スワイプ（ドラッグ）
   adb shell input swipe 100 100 500 500
  1. PowerShellスクリプトでタップを自動化
   $x = 500
   $y = 1000
   adb shell input tap $x $y
   Write-Output "座標 ($x, $y) をタップしました。"

音量や電源の制御


エミュレーターの音量調整や電源ボタンの操作もADBコマンドで行えます。

  1. 音量の操作
   adb shell input keyevent 24  # 音量アップ
   adb shell input keyevent 25  # 音量ダウン
  1. 電源ボタンを押す
   adb shell input keyevent 26

まとめ

  • PowerShellとADBを組み合わせて、エミュレーターの操作を自動化できる。
  • アプリのインストール、スクリーンキャプチャ、ログ取得などをPowerShellスクリプトで実行可能。
  • キーボード入力、タップ、スワイプ、音量調整などの端末操作もスクリプト化できる。

次のステップでは、PowerShellスクリプトによる高度な自動化について解説します。

PowerShellスクリプトによる高度な自動化

高度な自動化の概要


PowerShellとADBを活用すると、より複雑な操作を自動化できます。例えば、特定の条件に応じた処理の実行、複数のデバイスの同時制御、エラーハンドリング、ログの監視などが可能です。本章では、実践的なPowerShellスクリプトの作成方法を解説します。

条件分岐を使ったADBコマンド実行


PowerShellのif-else を活用して、特定の条件に基づいた処理を実行できます。

デバイスの接続を確認して処理を分岐する

$devices = adb devices | Select-String "device$"

if ($devices) {
    Write-Output "デバイスが接続されています。アプリをインストールします。"
    adb install "C:\path\to\app.apk"
} else {
    Write-Output "デバイスが接続されていません。処理を中止します。"
}

このスクリプトでは、adb devices の結果を確認し、デバイスが接続されている場合にアプリのインストールを実行します。

ループを使用した繰り返し処理


特定のタスクを一定時間ごとに繰り返し実行するには、while や for ループを活用します。

一定間隔でスクリーンショットを自動取得

$savePath = "C:\Users\<USERNAME>\Desktop\screenshots"
$counter = 1

while ($counter -le 5) {
    $timestamp = Get-Date -Format "yyyyMMdd_HHmmss"
    $filePath = "$savePath\screenshot_$timestamp.png"

    adb shell screencap -p /sdcard/screenshot.png
    adb pull /sdcard/screenshot.png $filePath

    Write-Output "スクリーンショットを保存しました: $filePath"

    Start-Sleep -Seconds 10  # 10秒待機
    $counter++
}

このスクリプトは、10秒ごとにスクリーンショットを取得し、デスクトップに保存します。

複数のデバイスを同時に操作


複数のエミュレーターや実機を同時に制御する場合、ADBの -s オプションを使用します。

接続されている全デバイスにアプリをインストール

$devices = adb devices | Select-String "device$"

if ($devices) {
    foreach ($device in $devices) {
        $deviceID = $device -split '\s+' | Select-Object -First 1
        Write-Output "デバイス $deviceID にアプリをインストール中..."
        adb -s $deviceID install "C:\path\to\app.apk"
    }
} else {
    Write-Output "デバイスが接続されていません。"
}

このスクリプトは、複数のデバイスに対してアプリを同時にインストールします。

ログを監視して特定のイベントを検出


adb logcat を監視し、特定のメッセージが出力されたら処理を実行することも可能です。

エラーログを検出して通知

$logFile = "C:\Users\<USERNAME>\Desktop\logcat_monitor.txt"

adb logcat -d > $logFile
$errors = Get-Content $logFile | Select-String "E/"

if ($errors) {
    Write-Output "エラーが検出されました！内容: $errors"
} else {
    Write-Output "エラーログは検出されませんでした。"
}

このスクリプトは、ログを取得して「E/」（エラー）を含む行を抽出し、エラーがあれば通知します。

エラーハンドリングと例外処理


PowerShellの Try-Catch を活用すると、エラーが発生しても適切に処理できます。

ADBの実行時エラーをキャッチする

try {
    adb devices
    Write-Output "ADBが正常に実行されました。"
} catch {
    Write-Output "エラーが発生しました: $_"
}

このスクリプトでは、ADB実行時にエラーが発生した場合に例外をキャッチし、適切なエラーメッセージを出力します。

応用：アプリの自動テストスクリプト


以下のスクリプトは、アプリをインストールし、起動し、指定のボタンをタップするまでの一連の流れを自動化するものです。

$apkPath = "C:\path\to\app.apk"
$packageName = "com.example.app"
$launchActivity = "com.example.app.MainActivity"

# 1. デバイス確認
$devices = adb devices | Select-String "device$"

if ($devices) {
    # 2. アプリをインストール
    adb install $apkPath
    Write-Output "アプリをインストールしました。"

    # 3. アプリを起動
    adb shell am start -n "$packageName/$launchActivity"
    Write-Output "アプリを起動しました。"

    # 4. ボタンをタップ（座標指定）
    Start-Sleep -Seconds 5  # アプリ起動を待機
    adb shell input tap 300 600
    Write-Output "ボタンをタップしました。"

} else {
    Write-Output "デバイスが接続されていません。"
}

このスクリプトを実行すると、アプリをインストールし、起動し、5秒待ってボタンをタップします。

まとめ

  • 条件分岐 (if-else) を活用 してADBの実行を制御できる。
  • ループ (while, foreach) を使用 して繰り返し処理を自動化できる。
  • 複数のデバイスを同時に操作 するスクリプトを作成可能。
  • ログを監視 して特定のエラーが発生した場合に通知できる。
  • エラーハンドリング (Try-Catch) を導入 し、スクリプトの安定性を向上させる。
  • アプリのインストールからボタン操作まで自動化 することで、UIテストなどにも応用可能。

次のステップでは、エラー処理とデバッグ方法について詳しく解説します。

エラー処理とデバッグ方法

エラー処理の重要性


PowerShellでADBを利用する際、デバイスの接続不良やコマンドの失敗など、さまざまなエラーが発生する可能性があります。適切なエラー処理を実装することで、スクリプトの安定性を向上させ、予期しないトラブルを防ぐことができます。本章では、PowerShellを活用したエラーハンドリングとデバッグの方法を解説します。

PowerShellのTry-Catchを活用したエラーハンドリング


PowerShellでは Try-Catch 構文を使うことで、エラー発生時の処理を制御できます。

ADBコマンド実行時のエラー処理

try {
    adb devices
    Write-Output "ADBが正常に実行されました。"
} catch {
    Write-Output "エラーが発生しました: $_"
}

このスクリプトでは、adb devices の実行に失敗した場合、エラーをキャッチしてメッセージを出力します。

ADBのエラーログを確認する


ADBの実行時に発生したエラーを確認するには、adb logcat を活用します。

エラーログを取得する

adb logcat -d > C:\Users\<USERNAME>\Desktop\adb_error_log.txt
Write-Output "エラーログを取得しました。"

このコマンドを実行すると、エラーログが adb_error_log.txt に保存されます。エミュレーターやアプリのクラッシュが発生した際に原因を特定するのに役立ちます。

デバイスの接続状態を確認する


ADBのコマンドが正しく動作しない場合、デバイスの接続状態を確認することが重要です。

接続デバイスの確認

$devices = adb devices | Select-String "device$"

if ($devices) {
    Write-Output "デバイスが接続されています。"
} else {
    Write-Output "デバイスが接続されていません。USB接続やエミュレーターの起動を確認してください。"
}

デバイスが認識されていない場合、USBケーブルの確認や adb kill-server → adb start-server を試してください。

特定のADBエラーを処理する


ADBのコマンド実行時に発生する代表的なエラーの対処方法を紹介します。

エミュレーターが起動しない場合

  • エミュレーターが動作しているか確認
  adb devices

エミュレーターがリストに表示されない場合、Android Studio の AVD Manager で手動起動を試す。

  • ADBサーバーを再起動
  adb kill-server
  adb start-server

これにより、ADBプロセスが正常に動作するか確認できます。

エラー時にスクリプトを自動停止する


PowerShellの $ErrorActionPreference を Stop に設定すると、エラー発生時にスクリプトの実行を停止できます。

エラー発生時にスクリプトを強制終了

$ErrorActionPreference = "Stop"

try {
    adb install "C:\path\to\app.apk"
    Write-Output "アプリが正常にインストールされました。"
} catch {
    Write-Output "アプリのインストール中にエラーが発生しました: $_"
    exit 1
}

この設定をすると、エラー発生時にスクリプトが強制終了し、不完全な処理を防ぐことができます。

スクリプトのデバッグ方法


PowerShellのデバッグ機能を活用すると、スクリプトの動作を詳細に確認できます。

デバッグ情報を出力

PowerShellでは $DebugPreference を Continue に設定すると、デバッグ用のメッセージを出力できます。

$DebugPreference = "Continue"

Write-Debug "ADBコマンドを実行します。"
adb devices
Write-Debug "デバイス一覧の取得が完了しました。"

このスクリプトを実行すると、デバッグメッセージが表示され、どこでエラーが発生したか特定しやすくなります。

リトライ機能を実装する


ADBコマンドの実行が失敗した場合に、一定回数リトライすることで安定性を向上させることができます。

3回リトライするADBコマンド

$maxAttempts = 3
$attempt = 0
$success = $false

while ($attempt -lt $maxAttempts -and -not $success) {
    try {
        adb devices
        Write-Output "ADBが正常に実行されました。"
        $success = $true
    } catch {
        $attempt++
        Write-Output "エラーが発生しました。再試行 ($attempt/$maxAttempts)..."
        Start-Sleep -Seconds 5
    }
}

if (-not $success) {
    Write-Output "最大試行回数に達しました。スクリプトを終了します。"
    exit 1
}

このスクリプトは、ADBコマンドの実行に失敗した場合、最大3回までリトライします。

まとめ

  • Try-Catch を活用してエラー発生時の処理を制御できる。
  • adb logcat を使用してエラーログを取得し、デバッグに役立てる。
  • デバイスの接続状態を確認し、ADBの再起動 (adb kill-server) を試すことで問題を解決できる。
  • $ErrorActionPreference = "Stop" を設定すると、スクリプト実行時のエラーを防げる。
  • $DebugPreference = "Continue" を使用すると、詳細なデバッグ情報を確認できる。
  • リトライ機能を実装することで、ADBの一時的なエラーに対応できる。

次のステップでは、実践例としてアプリのテスト自動化スクリプトを作成する方法を解説します。

実践例：アプリのテスト自動化

テスト自動化の概要


PowerShellとADBを組み合わせることで、アプリのインストール、起動、操作、スクリーンショットの取得、ログ取得などを自動化できます。本章では、実践的なテスト自動化スクリプトを紹介し、PowerShellを使ってAndroidアプリの動作確認を効率化する方法を解説します。

テスト自動化の手順

  1. エミュレーターまたはデバイスの準備
  2. アプリのインストール
  3. アプリの起動
  4. 特定の操作を実行（例：ログインボタンのタップ）
  5. スクリーンショットの取得
  6. ログの取得
  7. 結果をファイルに保存

サンプルスクリプト：アプリの起動とボタン操作


以下のPowerShellスクリプトは、エミュレーターを起動し、アプリをインストールして起動し、ボタンをタップするまでの一連の流れを自動化するものです。

# 設定値
$apkPath = "C:\path\to\app.apk"
$packageName = "com.example.app"
$launchActivity = "com.example.app.MainActivity"
$screenshotPath = "C:\Users\<USERNAME>\Desktop\screenshot.png"
$logPath = "C:\Users\<USERNAME>\Desktop\logcat.txt"

# 1. デバイス確認
$devices = adb devices | Select-String "device$"

if ($devices) {
    Write-Output "デバイスが接続されています。"

    # 2. アプリのインストール
    adb install $apkPath
    Write-Output "アプリをインストールしました。"

    # 3. アプリを起動
    adb shell am start -n "$packageName/$launchActivity"
    Write-Output "アプリを起動しました。"

    # 4. ボタンをタップ（座標指定）
    Start-Sleep -Seconds 5  # アプリ起動を待機
    adb shell input tap 300 600
    Write-Output "ボタンをタップしました。"

    # 5. スクリーンショットを取得
    adb shell screencap -p /sdcard/screenshot.png
    adb pull /sdcard/screenshot.png $screenshotPath
    Write-Output "スクリーンショットを取得し、デスクトップに保存しました。"

    # 6. ログを取得
    adb logcat -d > $logPath
    Write-Output "アプリのログを取得し、デスクトップに保存しました。"

} else {
    Write-Output "デバイスが接続されていません。"
}

スクリプトの動作解説

  1. デバイスが接続されているか確認
  • adb devices で接続中のデバイスを取得し、PowerShellの if 文で処理を分岐。
  1. アプリをインストール
  • adb install $apkPath で指定したAPKファイルをデバイスにインストール。
  1. アプリを起動
  • adb shell am start -n "$packageName/$launchActivity" でアプリを起動。
  1. ボタンをタップ
  • adb shell input tap 300 600 で特定の座標をタップ（アプリのボタンの位置を指定）。
  1. スクリーンショットを取得
  • adb shell screencap -p /sdcard/screenshot.png でスクリーンキャプチャを撮影し、
  • adb pull /sdcard/screenshot.png $screenshotPath でPCに転送。
  1. ログを取得
  • adb logcat -d > $logPath でアプリの動作ログをファイルに保存。

スクリプトの改良ポイント

複数回タップを繰り返す

特定のボタンを何回も押す場合、ループを使って自動化できます。

for ($i = 1; $i -le 5; $i++) {
    adb shell input tap 300 600
    Write-Output "ボタンを $i 回タップしました。"
    Start-Sleep -Seconds 2  # 2秒待機
}

テスト結果をログファイルに記録

スクリプトの実行結果をファイルに記録すると、後からテスト結果を確認しやすくなります。

$logFile = "C:\Users\<USERNAME>\Desktop\test_log.txt"
$date = Get-Date -Format "yyyy-MM-dd HH:mm:ss"

$logEntry = "$date - テスト実行完了: スクリーンショット取得、ログ取得"
Add-Content -Path $logFile -Value $logEntry

Write-Output "テスト結果をログファイルに記録しました。"

実用例：フォーム入力を自動化


アプリのテストでは、フォームに値を入力することがよくあります。以下のスクリプトは、テキストフィールドに値を入力し、送信ボタンを押す自動化スクリプトです。

# ユーザー名の入力
adb shell input text "test_user"

# タブキーで次のフィールドへ移動
adb shell input keyevent 61

# パスワードの入力
adb shell input text "password123"

# Enterキーでログイン
adb shell input keyevent 66

Write-Output "フォーム入力とログイン処理を実行しました。"

このスクリプトを使うと、ログインフォームのテストを自動化できます。

エミュレーターの起動からテスト完了までを自動化


最も実用的なスクリプトとして、エミュレーターの起動からアプリのテストまでをすべて自動化する方法を紹介します。

# エミュレーターを起動
Start-Process -FilePath "C:\Users\<USERNAME>\AppData\Local\Android\Sdk\emulator\emulator.exe" -ArgumentList "-avd Pixel_3a_API_30"

# デバイス接続待機
Write-Output "エミュレーターの起動を待機しています..."
adb wait-for-device

# アプリのインストールと起動
adb install "C:\path\to\app.apk"
adb shell am start -n "com.example.app/com.example.app.MainActivity"

# フォーム入力
adb shell input text "test_user"
adb shell input keyevent 61
adb shell input text "password123"
adb shell input keyevent 66

# スクリーンショット取得
adb shell screencap -p /sdcard/screenshot.png
adb pull /sdcard/screenshot.png "C:\Users\<USERNAME>\Desktop\screenshot.png"

Write-Output "アプリの起動・操作が完了しました。"

まとめ

  • アプリのインストールからUI操作まで自動化 できる。
  • スクリーンショットの取得やログ記録を活用 して、テスト結果を保存できる。
  • PowerShellスクリプトでテストを繰り返し実行 し、手動操作の手間を削減できる。
  • フォーム入力やボタン操作をスクリプト化 して、簡単なUIテストを自動実行可能。
  • エミュレーターの起動から終了まで全自動化 することで、開発効率を向上できる。

次のステップでは、本記事の内容を振り返り、まとめを行います。

まとめ

本記事では、PowerShellとADBを活用してAndroidエミュレーターの操作を自動化する方法について詳しく解説しました。基本的なADBコマンドの実行方法から、高度なスクリプトを用いたアプリのテスト自動化まで、幅広い内容をカバーしました。

学んだポイント

  1. PowerShellとADBの基本
  • PowerShellからADBを実行する方法を理解した。
  • ADBを使ってエミュレーターや実機を制御する基本コマンドを習得した。
  1. エミュレーターの起動と接続
  • adb devices を使用してデバイスの接続状況を確認する方法を学んだ。
  • adb wait-for-device を活用し、エミュレーターの起動を待機する手法を習得した。
  1. ADBコマンドの自動化
  • アプリのインストール、スクリーンショット取得、ログ取得をPowerShellで自動化できるようになった。
  • キーボード入力、タップ、スワイプなどのエミュレーター操作をスクリプト化する方法を学んだ。
  1. エラーハンドリングとデバッグ
  • Try-Catch を活用してスクリプト実行中のエラー処理を実装する方法を学んだ。
  • adb logcat を利用してアプリのエラーログを取得し、デバッグを行う方法を理解した。
  1. 実践的なテスト自動化
  • アプリの起動からUI操作（ボタンタップ、フォーム入力）までを自動化するスクリプトを作成した。
  • while や for を活用し、繰り返し操作を実行する方法を習得した。
  • テスト結果をログファイルに記録し、後から確認できるようにする手法を学んだ。

PowerShellとADBを活用するメリット

✅ 手作業を減らし、作業を自動化できる
✅ アプリのテストを繰り返し実行できるため、効率的なデバッグが可能
✅ デバイスやエミュレーターの管理を簡単に行える
✅ スクリプトを活用すれば、チーム内で同じ環境を再現しやすい

次に挑戦すべきこと

🔹 CI/CD環境への統合
PowerShellスクリプトをCI/CDパイプライン（Jenkins, GitHub Actions, Azure DevOpsなど）に組み込み、テストを自動化する。

🔹 より高度なUI操作の自動化
UI AutomatorやAppiumと組み合わせ、より高度なUIテストを実装する。

🔹 実機テストの自動化
USB接続した実機デバイスでも同じスクリプトを適用し、実際の端末での動作確認を行う。

まとめ


PowerShellとADBを活用することで、Androidエミュレーターの操作を効率化し、開発やテストを大幅に自動化できることがわかりました。基本的なADBコマンドの使い方から、スクリプトを活用した応用的な自動化まで、一通りの流れを習得したことで、実務にも活用できるスキルが身についたはずです。

PowerShellスクリプトのカスタマイズ次第で、さらに柔軟な自動化が可能になります。ぜひ、今回学んだ内容をベースに、より高度なテスト自動化に挑戦してみてください！

PowerShell
PowerShell 自動化 Android ADB エミュレーター

コメント

コメントする

目次
  1. PowerShellとADBの概要
    1. PowerShellとは
    2. ADB（Android Debug Bridge）とは
    3. PowerShellとADBの連携のメリット
  2. ADBのインストールと設定
    1. ADBのダウンロードとインストール
    2. PowerShellでADBを使用するための準備
  3. PowerShellからADBを実行する方法
    1. PowerShellでADBコマンドを実行する基本
    2. ADBコマンドをPowerShellスクリプトで実行する
    3. PowerShellスクリプトを作成して実行
    4. PowerShellでADBコマンドのエラーを処理する
    5. まとめ
  4. エミュレーターの起動と接続
    1. Androidエミュレーターの準備
    2. PowerShellからエミュレーターを起動する
    3. ADBでエミュレーターに接続
    4. エミュレーターの自動起動スクリプト
    5. エミュレーターが認識されない場合の対処
    6. まとめ
  5. ADBを使用したエミュレーター操作の自動化
    1. PowerShellでADBを活用した自動化の概要
    2. アプリのインストールとアンインストール
    3. スクリーンキャプチャの取得
    4. ログの取得（Logcat）
    5. キーボード入力の自動化
    6. タップとスワイプの自動化
    7. 音量や電源の制御
    8. まとめ
  6. PowerShellスクリプトによる高度な自動化
    1. 高度な自動化の概要
    2. 条件分岐を使ったADBコマンド実行
    3. デバイスの接続を確認して処理を分岐する
    4. ループを使用した繰り返し処理
    5. 一定間隔でスクリーンショットを自動取得
    6. 複数のデバイスを同時に操作
    7. 接続されている全デバイスにアプリをインストール
    8. ログを監視して特定のイベントを検出
    9. エラーログを検出して通知
    10. エラーハンドリングと例外処理
    11. ADBの実行時エラーをキャッチする
    12. 応用：アプリの自動テストスクリプト
    13. まとめ
  7. エラー処理とデバッグ方法
    1. エラー処理の重要性
    2. PowerShellのTry-Catchを活用したエラーハンドリング
    3. ADBコマンド実行時のエラー処理
    4. ADBのエラーログを確認する
    5. エラーログを取得する
    6. デバイスの接続状態を確認する
    7. 接続デバイスの確認
    8. 特定のADBエラーを処理する
    9. エミュレーターが起動しない場合
    10. エラー時にスクリプトを自動停止する
    11. エラー発生時にスクリプトを強制終了
    12. スクリプトのデバッグ方法
    13. デバッグ情報を出力
    14. リトライ機能を実装する
    15. 3回リトライするADBコマンド
    16. まとめ
  8. 実践例：アプリのテスト自動化
    1. テスト自動化の概要
    2. テスト自動化の手順
    3. サンプルスクリプト：アプリの起動とボタン操作
    4. スクリプトの動作解説
    5. スクリプトの改良ポイント
    6. 複数回タップを繰り返す
    7. テスト結果をログファイルに記録
    8. 実用例：フォーム入力を自動化
    9. エミュレーターの起動からテスト完了までを自動化
    10. まとめ
  9. まとめ
    1. 学んだポイント
    2. PowerShellとADBを活用するメリット
    3. 次に挑戦すべきこと
    4. まとめ