アプリのインストールと更新をデバッグする

デバイスのポリシーが更新された後、デバイスが特定の条件を満たしている限り、必要なアプリアップデートは自動的に実行されます。managed Play からのアプリのアップデートやインストールに関連する問題をデバッグするには、デバイスから managed Play のログを取得して分析します。

managed Play ログを取得する

お客様は、バグレポートをデバイスから直接キャプチャするか、Android Debug Bridge（adb）を使用することで、managed Play ログを取得して分析のために送信できます。

バグレポートをキャプチャする

Android バージョン 4.2 以降では、バグレポートをキャプチャして保存できます。バグレポートには、アプリのインストールや更新に関連する問題のトラブルシューティングに役立つイベントログが含まれています。

デバイスでバグレポートを取得するには、開発者向けオプションを有効にする必要があります（インタラクティブレポートをおすすめします）。バグレポートは ZIP ファイルに保存されるため、お客様はこのファイルを送信して分析を受けることができます。Android は、バグレポートの読み取りに関する一般的な情報を提供しています。アプリのインストールと更新のトラブルシューティングに関する具体的なガイダンスについては、managed Play ログを分析するをご覧ください。

Android Debug Bridge を使用する

バグレポートをキャプチャする代わりに、USB 経由で接続されたデバイスで Android Debug Brige（adb）を使用するようにお客様にご案内できます。adb を使用する前に:

デバイスで開発者向けオプションを有効にする必要があります。
デバッグ機能も有効にする必要があります。DPC がユーザー制限 DISALLOW_DEBUGGING_FEATURES を適用しないことを確認してください。

デバイスを接続した後、logcat を使用して、デバイス上のすべてのアプリ（Play を含む）からのシステムメッセージのログを表示します。お客様はこのログを分析用に送信できます

managed Play のログを分析する

お客様がデバイスからバグレポートをキャプチャしたか、adb logcat を使用したかにかかわらず、イベントログの基本的な形式は次のとおりです。

timestamp PID TID log-level log-tag tag-values

Google Play からのすべてのログには、ログタグ Finsky が含まれます。次に例を示します。

02-11 08:42:08.600 10031 14335 14335 I Finsky logged-message

Google Play に関する問題をデバッグするには、システムメッセージと他のアプリからのメッセージを除外することをおすすめします。たとえば、adb では次のようになります。

adb logcat | grep Finsky

managed Play は、最新のアプリポリシーをリクエストする前に、次のメッセージをログに書き込みます。

Start enterprise client policy sync: account=...

ポリシーが正常に同期されると、次のようなメッセージが書き込まれます。

Received enterprise client policy: account=...

同期に失敗した場合、ポリシーは以下を書き込みます。

Error while getting the Enterprise client policy: ... for the account.

例: ポリシー同期エラー

次のログの例は、インターネットに接続していないため、最新の managed Play ポリシーと同期できなかったデバイスを示しています。そのため、アプリが必要に応じてインストールまたは更新されません。

02-11 07:52:01.083 10030 22896 22896 W Finsky  : [2] jur.a(13):
Error while getting the Enterprise client policy:
accountID@android-for-work.gserviceaccount.com for the account.
com.android.volley.NoConnectionError:
org.chromium.net.impl.NetworkExceptionImpl:
Exception in CronetUrlRequest:
net::ERR_INTERNET_DISCONNECTED, ErrorCode=2, InternalErrorCode=-106, Retryable=false

アプリのインストールとアップデートを確認する

デバイスが managed Play ポリシーと正常に同期されると、必要なアプリのインストールまたはアップデートが直ちにスケジュールされます。managed Play は受け取ったポリシー全体をログに記録しませんが、managed Play のログを見ることで、インストールがスケジュールされているアプリがあるかどうかをチェックし、インストールの進行状況を追跡できます。

managed Play は、APK のダウンロード、APK の検証、実際の APK のインストールなど、いくつかの手順を踏んでアプリのインストールと更新を行います。アプリのインストールやアップデートの進行状況を確認するには、grep で Finsky とアプリのパッケージ ID を検索します。アプリのパッケージ ID は、Google Play ストアページの URL で確認できます。たとえば、Google Chrome のパッケージ ID は com.android.chrome です。

adb を使用して、デバイスでの Google Chrome のインストールまたは更新の進行状況に関するログを表示するには:

adb logcat | grep Finsky | grep com.android.chrome

アプリのインストールや更新に失敗した場合、これらのログにエラーと、インストールまたは更新に失敗したステージが返されます。アプリが正常にインストールまたは更新されると、ログに次のようなメッセージが記録されます。

02-11 08:42:30.187 10031 14335 14335 I Finsky  : [2] mqd.c(4): IT:
Successful install of com.android.chrome (isid: ...)