Androidのワイヤレスデバッグとは？設定・接続手順とADBコマンド活用法

ワイヤレスデバッグはAndroid端末とPCをWi-Fi経由で接続し、アプリの動作確認やログ取得などを行う機能です。Android 11以降のスマートフォンでは初回のペアリングからUSBケーブルを使わずにADB接続できます。

この記事ではペアリングコードを使った接続手順と、接続できないときの確認方法を解説します。接続後に使える画面録画、ログの絞り込み、APKの一括インストールもまとめています。

ケーブル不要になる！ワイヤレスデバッグの設定手順

対応Androidバージョンを確認する

Android 10以前もWiFiでデバッグすることはできますが、初回はUSB接続してadbコマンドで接続する必要がありました（adb tcpip方式）。Android 11（APIレベル30）以降の標準機能であるワイヤレスデバッグでは一度もPCにUSB接続することなく利用開始することができます。

APIレベルと端末OSの対応についてはこちらもあわせて参考にしてください。

あわせて読みたい

Android APIレベル・OSバージョン・コードネーム一覧表 AndroidのAPIレベルとOSバージョン、コードネームの対応をまとめました。各バージョンのリリース日や主な変更点を折りたたみで確認できます。開発時に使うSDK設定の違いも整理しています。

Android 17端末で実機検証する場合はOS側の変更点もあわせて確認しておくと安心です。

あわせて読みたい

Android 17で何が変わった？16との違いとユーザー・開発者向け変更点 Android 16から何が変わったのかを比較表で整理しました。普段使いで気になる新機能と、アプリ開発で確認したいメモリ制限・権限・動作変更を分けて紹介します。

ワイヤレスデバッグの設定手順

PCにはAndroid SDK Platform-Toolsを用意し、使用するターミナルでadb versionを実行できることを確認してください。Android Studioを使っている場合は、SDK ManagerでPlatform-Toolsを更新できます。

以下のコマンド例はadbにPATHが通っている前提です。PATHを設定せずWindows PowerShellでplatform-toolsフォルダーから実行する場合はadbを.\adb.exeに読み替えてください。

Android端末とPCを同じWi-Fiネットワークに接続してから設定を進めます。設定項目の名称や場所は機種によって異なります。

adb pair 【IPアドレス】:【ポート番号】

Enter pairing code: 123456

adb connect 【IPアドレス】:【接続用ポート番号】

connected to 192.168.1.10:43210

adb devices

List of devices attached
192.168.1.10:43210  device

接続先のIPアドレスやポート番号は端末の再起動やWi-Fiの再接続などで変わる場合があります。自動接続されないときは現在の接続先を確認してadb connectを実行してください。接続先が変わっただけでペアリングをやり直す必要はありません。

作業を終えるときはAndroid端末の「ワイヤレスデバッグ」をオフにします。そのPCとのペアリングも解除したい場合は、同じ画面のペアリング済みデバイスから対象PCを選んで登録を削除してください。

うまく接続できない時の対処法

ワイヤレスデバッグで接続できない場合は以下を確認してみてください。

Android端末とPCが同じWi-Fiに接続されているか確認する

Android端末とPCを同じWi-Fiネットワークに接続して確認してください。同じSSIDでもゲスト用ネットワークや端末間通信を制限する設定では接続できない場合があります。

PCでVPNを利用している場合は、ローカルネットワークへの通信が制限されていないか確認してください。VPNへ接続していることだけで必ずワイヤレスデバッグが使えなくなるわけではありません。

Windows PCのWi-Fiが頻繁に切れワイヤレスデバッグ以外の通信も不安定な場合は、ルーターの接続台数やWindows側の設定を確認してみてください。

あわせて読みたい

WindowsのWi-Fiが頻繁に切れるときは？ルーターの接続台数を確認 ルーターを再起動しても数日後にWi-Fiが切れる。筆者の環境では、使っていない端末の接続を整理して改善しました。接続台数の確認方法と、Windowsだけつながらない場合の対処法をまとめています。

ADBサーバーを再起動する

ADBの内部状態が不安定になっていて接続できないことがあります。以下のコマンドでADBサーバーを再起動後、ワイヤレスデバッグを試してください。

adb kill-server
adb start-server

ペアリング済みでも接続し直す

ペアリング済みなのに接続されない場合は、まず現在の接続用IPアドレスとポート番号でadb connectを試してください。ペアリング用ポートを指定していないかも確認します。

接続先を確認しても認証に失敗する場合は、端末の「ワイヤレスデバッグ」でペアリング済みデバイスから対象PCの登録を削除しStep 3からペアリングをやり直してください。

PCのファイアウォール設定を確認する

Windows Defender Firewall やセキュリティソフトがADB通信をブロックする場合があります。以下のような場合は一時的に確認してみてください。

• 初回接続時だけ失敗する
• ペアリングはできるのに接続できない
• adbコマンドがタイムアウトする

セキュリティソフトを利用している場合はADB通信がブロックされていないか確認してください。

Android Studioを再起動する

Android Studio側のデバイス一覧が更新されず、接続済みなのに認識されないことがあります。この場合はAndroid Studioを再起動すると改善することがあります。ADBサーバー再起動だけで改善しない場合に試してください。

実務の時短に直結するADBコマンド応用5選

基本的なadb installやadb rebootは使いこなせている前提で、もう一段階上のコマンドを紹介します。

ADBで端末の電源を切る操作は次の記事で確認できます。電源ボタンの長押しでアシスタントが起動してしまう場合の設定変更もまとめています。

あわせて読みたい

Androidの電源が切れない！電源ボタン長押しでアシスタントが起動する時の直し方 電源を切りたいのにアシスタントが起動してしまうときは、長押しの設定を確認しましょう。Pixel・Galaxyで電源メニューに戻す手順と、設定を変えずに電源を切る方法をまとめました。エミュレーター向けのADB操作も扱います。

バグ報告に即使える：スクリーンショットと画面録画

バグ発見時にスマホで画面録画してSlackに貼る……という手順、地味に手間ですよね。ADBを使えばPC側に直接保存できます。

スクリーンショット

adb shell screencap /sdcard/screenshot.png
adb pull /sdcard/screenshot.png .

2行で完了です。最初の行で端末内に保存し、次の行でPCのカレントディレクトリに引き出します。

画面録画（動画）

adb shell screenrecord /sdcard/record.mp4

録画中はCtrl+Cで停止できます。その後adb pullでPCに取り出してください。

adb pull /sdcard/record.mp4 .

デフォルトでは最長3分の制限があります。--time-limitオプションで秒数を指定することも可能です。

adb shell screenrecord --time-limit 60 /sdcard/record.mp4

複数端末を持つ現場で便利：一括APKインストール

接続中の全端末に最新APKをまとめて入れたい場面があります。adb devicesで端末一覧を取得し、ループを回すのが定番のやり方です。

以下はmacOS・LinuxなどのBash環境向けです。Windows PowerShellへ直接貼り付けて実行することはできません。APK_PATHを実際のAPKファイルへ変更してください。対象にはADB接続中のエミュレーターも含まれます。

#!/bin/bash
set -euo pipefail

APK_PATH="/path/to/app-debug.apk"

if [ ! -f "$APK_PATH" ]; then
  echo "APK not found: $APK_PATH" >&2
  exit 1
fi

DEVICE_LIST=$(adb devices | awk '$2 == "device" {print $1}')

if [ -z "$DEVICE_LIST" ]; then
  echo "No connected devices." >&2
  exit 1
fi

while IFS= read -r DEVICE; do
  echo "Installing to $DEVICE..."
  adb -s "$DEVICE" install -r "$APK_PATH"
done <<< "$DEVICE_LIST"

echo "Done."

adb devicesで状態がdeviceの端末だけにインストールします。-rは既存アプリのデータを保持して再インストールする指定です。

テスト前のリセットに：アプリデータ消去とアンインストール

毎回設定画面を開いてアプリを探してデータ消去……という操作はコマンドで一発です。

アプリデータの消去（アンインストールなし）

pm clearは対象アプリの保存データや設定、ログイン状態を削除します。アプリ本体は残りますが、必要なデータがある場合は実行前に退避してください。以下のadb uninstallはアプリ本体も削除する操作です。

adb shell pm clear 【パッケージ名】

初回起動の挙動を繰り返しテストしたい場合に重宝します。

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

adb uninstall 【パッケージ名】

パッケージ名はadb shell pm list packagesで確認できます。以下はパッケージ名にexampleを含むものを探す例です。exampleを探したい文字列へ置き換えてください。ホーム画面などに表示されるアプリ名を検索するコマンドではありません。

# Linux / macOS
adb shell pm list packages | grep -F "example"

# Windows PowerShell
adb shell pm list packages | Select-String -SimpleMatch "example"

ログを追う：特定キーワードのみをリアルタイム監視

adb logcatをそのまま流すとログが多すぎて見づらいですよね。タグやキーワードで絞り込むのが実務では基本です。

タグ指定でフィルタ

adb logcat -s 【タグ名】

キーワードで絞り込む（grep）

adb logcat | grep "【検索キーワード】"

adb logcat | Select-String "【検索キーワード】"

Select-Stringで大文字・小文字の区別や複数条件、正規表現を指定する方法は、次の記事で詳しく解説しています。

あわせて読みたい

PowerShellでgrepする方法｜Select-Stringの使い方と実践例 PowerShellでgrepのように文字列検索するならSelect-Stringを使います。基本構文、正規表現による複数条件、複数ファイル検索、ログ監視との組み合わせを実践例付きでまとめています。

ログレベルを絞る

ログの優先度にはV（Verbose）、D（Debug）、I（Info）、W（Warning）、E（Error）、F（Fatal）があります。S（Silent）は出力を抑止する指定です。エラー以上のログを表示するには、次のように指定します。

adb logcat '*:E'

ログが溜まりすぎていると流れが追いにくくなります。事前にバッファをクリアしておくのも有効です。

adb logcat -c

端末情報を確認する

複数端末でテストしていると「この端末のAPIレベルは何番だっけ」という場面が出てきます。設定画面を開かずに確認できます。

adb shell getprop ro.build.version.release

adb shell getprop ro.build.version.sdk

adb shell getprop ro.product.manufacturer
adb shell getprop ro.product.model

複数端末が接続されている場合は-sで端末を指定します。

adb -s 【デバイスID】 shell getprop ro.build.version.sdk

【Tips】シェルスクリプトで「いつもの操作」を自動化する

以下はGradleでデバッグ用APKをビルドし、接続中の端末へ順番にインストールするBashスクリプトです。gradlewがあるプロジェクトのルートで実行してください。例ではappモジュールを対象にしています。

ビルドまたはインストールに失敗した時点で処理を終了します。途中の端末で失敗した場合、それ以前の端末へのインストールは取り消されません。

#!/bin/bash
set -euo pipefail

./gradlew assembleDebug

APK_PATH="app/build/outputs/apk/debug/app-debug.apk"

if [ ! -f "$APK_PATH" ]; then
  echo "APK not found: $APK_PATH" >&2
  exit 1
fi

DEVICE_LIST=$(adb devices | awk '$2 == "device" {print $1}')

if [ -z "$DEVICE_LIST" ]; then
  echo "No connected devices." >&2
  exit 1
fi

while IFS= read -r DEVICE; do
  echo "Installing to $DEVICE..."
  adb -s "$DEVICE" install -r "$APK_PATH"
done <<< "$DEVICE_LIST"

echo "Deploy complete."

コマンドをスクリプトにまとめると実行する手順をそろえられます。端末の状態やアプリの保存データによって結果は変わるためテスト条件も別途そろえてください。

迷いやすいポイント

ワイヤレスデバッグで接続できるのはWi-Fi環境のみ？

はい、PCと端末が同じWi-Fiネットワークに接続されている必要があります。異なるネットワーク間での接続は標準機能では対応していません。

ペアリングコードがすぐ消えてしまいます。

ペアリング画面を閉じたり別の画面へ切り替えたりすると、ペアリングの待ち受けが終了する場合があります。PC側のターミナルを先に開き端末にコードを表示したまま操作してください。画面が消えた場合は開き直し、現在表示されているコードとポート番号を使います。

adb devicesでunauthorizedと表示されます。

adb devicesに表示されたどの接続がunauthorizedなのか確認してください。USB接続の場合は端末のロックを解除してUSBデバッグの許可画面を確認します。ワイヤレス接続の認証に失敗している場合は対象PCのペアリング登録を確認し、必要に応じて再ペアリングしてください。

screenrecordの動画がPCで再生できません。

screenrecordはMP4形式で保存されますが、コーデックの都合で一部のプレーヤーでは再生できないことがあります。VLCなど汎用性の高いプレーヤーで試してみてください。

スクリプトを実行したらPermission deniedになります。

スクリプトファイルに実行権限が付いていない可能性があります。以下のコマンドで権限を付与してください。

コマンド

chmod +x 【スクリプトファイル名】.sh

まとめ

• ワイヤレスデバッグはAndroid 11以降で使えて、ペアリングは初回だけで済むよ。
• 自動接続されないときは現在のIPアドレスと接続用ポート番号を確認してね。
• screencapやscreenrecordでバグ報告の証拠をPCに直接残せるよ。
• logcatはタグやキーワードで絞り込むと実務でぐっと使いやすくなるよ。
• 繰り返し操作はシェルスクリプトにまとめると、ミスが減ってテストの再現性も上がるよ。

Android Studio・ADB・Gradleを使った開発記事やAndroidのバージョン情報はAndroidまとめから目的別に確認できます。

あわせて読みたい

Androidまとめ｜設定・トラブル解決・Android Studio・ADB・開発記事一覧 Androidのバージョンやスマホ設定、Android Studio・Gradle・ADBを使った開発情報を目的別に探せるまとめページです。