擷取 Android 裝置的錯誤報告和錄影

為協助支援團隊解決 Android 裝置上的訊息應用程式問題，請產生錯誤報告和錄影檔。

如要直接從 Android 裝置擷取錯誤報告，請按照下列步驟操作。

啟用開發人員選項和 USB 偵錯功能

如要瞭解開發人員選項的相關資訊，以及如何設定系統行為，以便分析應用程式效能並進行偵錯，請參閱「設定裝置端開發人員選項」。

啟用訊息的詳細記錄功能

使用已解鎖裝置

在已解鎖的裝置上，使用下列指令啟用詳細記錄功能：

adb shell setprop log.tag.Bugle VERBOSE
adb shell setprop log.tag.BugleDataModel VERBOSE
adb shell setprop log.tag.RcsProvisioning VERBOSE
adb shell setprop log.tag.CarrierServices VERBOSE
adb shell setprop log.tag.BugleAction VERBOSE:
adb shell setprop log.tag.BugleRcsEngine VERBOSE;
adb shell setprop log.tag.BugleTransport VERBOSE;
adb shell setprop log.tag.BugleRcsProvisioning VERBOSE;
adb shell setprop log.tag.RcsClientLib VERBOSE;
adb shell setprop log.tag.BugleRcs VERBOSE;

只為測試裝置啟用詳細記錄功能。以下記錄包含個人識別資訊 (PII)。

adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_log_level VERBOSE
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_enable_debug_mode true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e bugle_rcs_allow_overrides true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e bugle_debugging true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_enable_sensitive_logging true

未解鎖的裝置

在未解鎖的裝置上，使用下列指令啟用詳細記錄功能：

adb shell am broadcast -a 'com.google.android.gms.phenotype.FLAG_OVERRIDE' --es package "com.google.android.apps.messaging#com.google.android.apps.messaging" --es user "\*" --esa flags "bugle_phenotype__enable_verbose_bug_reports" --esa values "true" --esa types "boolean" com.google.android.gms

重現問題

  1. 在「設定」>「系統」>「開發人員選項」>「記錄器緩衝區空間」中，將記錄器緩衝區空間設為最大值。使用裝置的最大大小 (例如，高階裝置的 16 MB)。
  2. 強制停止訊息應用程式。
  3. 如果錯誤與進階通訊解決方案 (RCS) 佈建相關，請完成下列步驟：
    1. 啟用飛航模式。
    2. 在「設定」中清除「訊息」和「電信業者服務」的儲存空間。
    3. 停用飛航模式。
    4. 在「設定」中啟用 RCS 即時通訊功能。
    5. 請至少等候五分鐘，再開始製作錯誤報告。

  4. 針對每個新錯誤，請清除 logcat 訊息：

    adb logcat -c

  5. 開始錄影：

    • 只記錄已回報的錯誤。
    • 請盡可能縮短錄影時間。舉例來說，如果發生錯誤是在單一呼叫後，請只記錄該部分的呼叫。
    • 請勿記錄重複的步驟。

  6. 啟動「訊息」應用程式並重現錯誤。

  7. 停止錄影。

收集錯誤報告

  1. 在報告中記錄下列資訊：
    1. 發生錯誤的時間戳記。
    2. 觸發錯誤的步驟。
    3. 錯誤本身 (例如錯誤訊息)。
    4. 重現錯誤時的螢幕錄製畫面。

  2. 在「Developer options」中，輕觸「Take bug report」。

  3. 選取錯誤報告類型，然後輕觸「回報」。系統會在錯誤報告準備就緒時發出通知。

  4. 在提交的錯誤中附上錯誤報告。

如果錯誤與一或多則郵件相關 (例如無法傳送郵件)，請提供受影響郵件的郵件 ID。

  1. 啟用「訊息」偵錯選單：
    1. 開啟「訊息」應用程式。
    2. 輕觸搜尋列。
    3. 搜尋 *xyzzy*。Debug Utils 選單會隨即開啟，或會顯示含有 Debug menu option enabled 訊息的 Toast。
  2. 按住訊息。
  3. 依序輕觸「選單」圖示 和「查看詳細資料」。