スマホの接続問題:ステップ2で接続に失敗する
この記事の内容
- 根本原因:
- 原因1:スマホ自動化ソフトウェアがインストールされていない
- 原因2:スマホ自動化ソフトウェアのインストールに失敗する
- 原因3:スマホの最適化の問題
- 原因4:Android 14以降の問題
- 原因5:provideプロセスのポートが占有されている問題
- 原因6:パソコン側の音声・映像の問題
- 原因7:環境変数の競合の問題
- 原因8:ユーザーがcmd.exeにコードページを設定している
- 原因9:「スマホに接続」コマンドで「UIAに接続できません」というエラーが発生する
- 原因:adbに表示されるデバイスがすべてUnauthorized状態になっている
- Uiautomator2モードでの接続に失敗する
- 原因1:atx-agentのバージョンが一致していない
- 原因2:atx-agentのダウンロードに失敗する
根本原因:
スマホの各種権限(ソフトウェアの最適化項目、スタートアップ設定など)、またはDr.Roboがラップしたadbutilsコマンドの実行エラーによって、接続に失敗しています。Dr.Roboのログとadbコマンドの実行結果を照らし合わせて調査する必要があります。スマホ自動化ツールを使用して分析することもできます。
原因1:スマホ自動化ソフトウェアがインストールされていない
スマホ自動化は、次の3つのアプリに依存しています。io.appium.settings io.appium.uiautomator2.server io.appium.uiautomator2.server.test
現象:スマホに3つのアプリがありません。さまざまな原因で3つのアプリがスマホにインストールされなかった場合は、スマホ検出ツールで再度インストールできます。参照先→スマホ自動化ツール
原因2:スマホ自動化ソフトウェアのインストールに失敗する
現象:スマホに3つのアプリがありません。
一部のスマホでは、USB経由のインストール権限を有効にする必要があります。「USB」で検索してインストール関連の権限があるか確認し、ある場合は有効にしてから再度インストールしてください。ない場合は、スマホ検出ツールで再度インストールできます。参照先→スマホ自動化ツール
原因3:スマホの最適化の問題
現象:3つのアプリはインストール済みですが、接続できません。
一部のスマホでは、設定によってバックグラウンドで動作する自動化プログラムが終了されます。そのため、3つのアプリをスマホの許可リストに追加する必要があります(いくつかの設定を行います)。
一部のスマホでは、パフォーマンス最適化/省電力ポリシーによってアプリのバックグラウンド動作が制限され、応答が遅くなります。その結果、スマホに接続した後、要素のキャプチャが非常に重くなる、「ホーム」コマンドをクリックしたときの応答が非常に遅くなる、または実行中にスマホの接続が頻繁に自動で切断されることがあります。
設定で「最適化」「省電力」「バッテリー」などのキーワードを検索してください。バックグラウンドの制限に関する権限の一部は、アプリ管理にあります。アプリ管理で【アプリの詳細】——【すべての権限】を開くと確認できます。近道はありません。お客様の「権限はすべて有効にしました」という言葉をうのみにせず、もう一度すべて確認してください。
具体的な設定は、スマホの接続手順を参照してください。
原因4:Android 14以降の問題
APP_DIR\log\xxxxxxmobileserver.logのログに次の内容が表示されます(APP_DIRは実際の製品ディレクトリに置き換えるプレースホルダーであり、そのまま使用するパスではありません)。
support_xxx\mobile内のファイルが、対応するバージョンのファイルか確認します。
ファイル一覧とバージョンが一致しない場合は、参照先→スマホの接続手順の【画面ミラーリングツールの差し替え・アップグレード】に従って差し替えてください。
原因5:provideプロセスのポートが占有されている問題
現象:スマホ診断ツールでは正常に接続できます。
調査方法:Dr.Roboのインストールディレクトリ内にある、該当バージョンの/support_xxx/mobileフォルダーを開き、cmdを起動します。【adb devices】を実行すると正常に接続でき、【PROCESS_NAME】を実行すると正常に画面をミラーリングできますが、タスクマネージャーを確認するとMobileprovideプロセスがありません(PROCESS_NAMEは実際の画面ミラーリング用実行ファイル名に置き換えるプレースホルダーであり、そのまま実行するコマンドではありません)。
ディレクトリ【APP_DIR\log】を開き、mobileserverログに次のエラーがあるか確認します(APP_DIRは実際の製品ディレクトリに置き換えてください)。ポートがすでに使用されているため、Android自動化サービスを起動できません。4723ポートを使用しているプログラムを終了してください。
原因:すでに他のプロセスが4723ポートを使用しており、adbが4723ポートで接続しようとしても、ポートが占有されているため接続できません。
解決策:Dr.Robo 6.0以降で修正済みです。同様の問題が引き続き発生する場合は、Dr.Robo公式サポートに報告してください。
原因6:パソコン側の音声・映像の問題
現象:スマホ診断ツールでは正常に接続できます。調査方法:Dr.Roboのインストールディレクトリ内にある、該当バージョンの/support_xxx/mobileフォルダーを開き、cmdを起動します。【adb devices】を実行すると正常に接続でき、【PROCESS_NAME】を実行すると正常に画面をミラーリングできますが、実行ログにerror情報があります(PROCESS_NAMEは実際の画面ミラーリング用実行ファイル名に置き換えてください)。
WARN: Demuxer [server] ERROR: スレッドThread[audio-encoder,5,main]で例外が発生しました。
'java.lang.SecurityException: 指定された呼び出し元パッケージandroidが、呼び出し元のuid 2000と一致しません。
または、画面をミラーリングできても突然終了します。ログ内のaudioフィールドに注目してください。これは音声に問題があることを示します。このような問題が発生した場合は、お客様のバージョン情報をDr.Robo公式サポートに送信し、パッチを入手できます。
原因7:環境変数の競合の問題
ご自身がAndroid開発者である場合や、同僚が誤操作した場合など、パソコンに一部の環境変数が誤って設定されている可能性があります。これにより、自動化コンポーネントの実行エラーが発生します。これらの環境変数を修正してから、Dr.Roboを再起動する必要があります(必ず再起動してください)。
Android 14、15用の画面ミラーリングツールを手動で差し替えたことがあり、Dr.Roboのバージョン更新後、新バージョンのディレクトリ内の/support_xxx/mobileフォルダーでファイルを手動で差し替えたものの、環境変数を更新していません。
調査方法:
a. Dr.Roboのインストールディレクトリ内にある、該当バージョンの/support_xxx/mobileフォルダーを開き、cmdコマンドウィンドウを起動します。
b. 【PROCESS_NAME】を実行すると、次のエラーが発生します(PROCESS_NAMEは実際の画面ミラーリング用実行ファイル名に置き換えてください)。
お客様が別のバージョンのDr.Roboをインストールしたことがある、またはDr.Roboのインストール先を変更したため、環境変数に問題が発生しています。調査方法:Dr.Roboのインストールディレクトリ内にある、該当バージョンの/support_xxx/mobileフォルダーを開き、cmdを起動します。【adb devices】を実行すると正常に接続できますが、【PROCESS_NAME】を実行するとエラーが発生します(PROCESS_NAMEは実際の画面ミラーリング用実行ファイル名に置き換えてください)。
対処方法:環境変数【SCRCPY_SERVER_PATH】を削除し、環境変数を削除した後、パソコンを再起動します。パソコンを再起動しても接続できない場合は、パソコン側のスマホ自動化環境を再インストールしてみてください。
原因8:ユーザーがcmd.exeにコードページを設定している
現象:ログに「アクティブなコードページ:xxxx」と表示されます。
原因:ユーザーがcmd.exeにコードページを設定しています。
解決策:コードページをデフォルト値に戻してください。
原因9:「スマホに接続」コマンドで「UIAに接続できません」というエラーが発生する
原因:ユーザーがマルチユーザー環境でスマホ自動化を使用しています。現在は対応していません。
解決方法:パソコンを再起動します(あれこれ試すより、まず再起動です)。
原因:adbに表示されるデバイスがすべてUnauthorized状態になっている
Uiautomator2モードでの接続に失敗する
原因1:atx-agentのバージョンが一致していない
現象:
.log内のログ情報を確認すると、atx-agentの問題による接続失敗であることが明確に示されています。
Dr.Roboのバージョンディレクトリ内のsupport_xxx\mobileでcmdを起動し、atx-agentを手動で起動します。
adb shell /data/local/tmp/atx-agent server --nouia -d --addr 127.0.0.1:7912
エラー情報は次のとおりです:/data/local/tmp/atx-agent: 実行できません:32ビットELFファイルです。
32ビットのファイルatx-agentを実行できません。
解決策:
スマホ内のagentを64ビットのファイルに差し替えてください。
64ビットの端末アーキテクチャに対応する atx-agent ファイルを用意します。
手順:スマホ内のatx-agentファイルを削除します。
adb [-s スマホID] shell rm -rf /data/local/tmp/atx-agent
atx-agentファイルをスマホにpushします。
adb [-s スマホID] push ローカルのatx-agentのパス /data/local/tmp/atx-agent
ファイルの権限を実行可能に変更します。
adb [-s スマホID] shell chmod 755 /data/local/tmp/atx-agent
atx-agentの起動を試します。
adb [-s スマホID] shell /data/local/tmp/atx-agent server --nouia -d --addr 127.0.0.1:7912
起動に成功したら、Dr.Roboに戻ってスマホに接続してください。
原因2:atx-agentのダウンロードに失敗する
logに次のようなエラー情報があります(以下のAPP_DIRは実際の製品ディレクトリを表すプレースホルダーであり、そのまま使用するパスではありません)。
トレースバック(最後の呼び出しが末尾):
File "APP_DIR\users\842277781359132672\apps\2cc50fe7-5b92-4de3-9006-2d6213df6c9e\venv\lib\site-packages\requests\adapters.py", line 497, in send
chunked=chunked,
File "APP_DIR\users\842277781359132672\apps\2cc50fe7-5b92-4de3-9006-2d6213df6c9e\venv\lib\site-packages\urllib3\connectionpool.py", line 846, in urlopen
method, url, error=new_e, pool=self, stacktrace=sys.exc_info()[2]
File "APP_DIR\users\842277781359132672\apps\2cc50fe7-5b92-4de3-9006-2d6213df6c9e\venv\lib\site-packages\urllib3\util\retry.py", line 515, in increment
raise MaxRetryError(_pool, url, reason) from reason # type: ignore[arg-type]
urllib3.exceptions.MaxRetryError: HTTPSConnectionPool(host='github.com', port=443): 次のURLへの再試行回数が上限を超えました:/openatx/atx-agent/releases/download/0.10.0/atx-agent_0.10.0_linux_armv7.tar.gz(原因:NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x000001DB42185B08>: 新しい接続の確立に失敗しました:[WinError 10060] 接続先が一定時間内に適切に応答しなかったか、接続先のホストが応答しなかったため、接続の試行に失敗しました。'))
解決策:atxプラグインを手動でインストールします。