ローカルでウェイクロックをデバッグする
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ウェイクロックを使用するローカルで実行中のアプリをデバッグするために使用できるツールは数多くあります。これらのツールは、パフォーマンスの問題を特定して解決するのに役立ちます。
次のツールは、ウェイクロックのデバッグや最適化に役立ちます。
- dumpsys は、デバイス上のシステム サービスのステータスに関する情報を提供します。
- システム トレースは、システム レポートの生成に使用できるトレース ファイルを生成します。
- Android Studio の Background Task Inspector を使用すると、WorkManager などのライブラリによって取得される可能性のあるウェイクロックを含め、ウェイクロックをモニタリングできます。
dumpsys
dumpsys は、Android デバイス上で稼働し、デバイスのシステム サービスに関する情報を提供するツールです。
次のコマンドは、ウェイクロックのデバッグに特に役立ちます。
adb shell dumpsys batterystats
は、各アプリが保持しているウェイクロックの詳細な履歴を提供します。詳しくは、dumpsys の バッテリー診断を検査するドキュメントをご覧ください。
システム トレース
システム トレースは、短期間のデバイス アクティビティを幅広く記録します。システム トレースは、システム レポートの生成に使用できるトレース ファイルを生成します。このレポートを活用することで、アプリのパフォーマンスを改善する方法を見つけることができます。
使用を開始する方法については、システム トレースのクイックスタート ガイドをご覧ください。Android のバッテリー効率を改善する方法についてのこちらの動画もご覧ください。
Background Task Inspector
Android Studio の Background Task Inspector を使用して、ウェイクロック、アラーム、ジョブをモニタリングできます。
特に、WorkManager ライブラリは JobScheduler を使用してジョブのスケジュールを設定し、実行します。これらのジョブの実行中は、アプリに割り当てられたウェイクロックが保持されます。Background Task Inspector を使用すると、バックグラウンドで実行されるワーカーとジョブをモニタリングし、その作業の詳細を確認できます。
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-08-27 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-08-27 UTC。"],[],[],null,["There are a number of tools you can use to debug a locally-running app that uses\nwake locks. These tools can help you identify and fix performance issues.\n| **Note:** [Some APIs acquire wake locks that are attributed to your app](/develop/background-work/background-tasks/awake#actions-keep). This means your app might be using wake locks even though you aren't writing that code explicitly. If your app has mysterious performance issues, it can be helpful to check if there are misbehaving wake locks. If your app is holding wake locks and you don't recognize the names, [Identify wake locks created by other APIs](/develop/background-work/background-tasks/awake/wakelock/identify-wls) can help you identify the API that might have created them.\n\nThe following tools can help you debug or optimize your wake locks:\n\n- [dumpsys](#dumpsys) provides information about the status of system services on a device.\n- [System tracing](#system-tracing) produces a trace file that you can use to generate a system report.\n- The Android Studio [Background Task Inspector](#bg-task) helps you to monitor wake locks, including wake locks that might be acquired by libraries like WorkManager.\n\ndumpsys\n\n[dumpsys](/tools/dumpsys) is a tool that runs on Android devices and provides\ninformation about the device's system services.\n\nThe following command is particularly useful for debugging wake locks:\n\n- `adb shell dumpsys batterystats` provides a detailed history of wake locks held by each app. For more information, see the dumpsys [Inspect battery\n diagnostics](/tools/dumpsys#battery) documentation.\n\nSystem tracing\n\n[System tracing](/topic/performance/tracing) records a wide range of device activity\nover a short period. System tracing produces a *trace file* that you can use to\ngenerate a system report. This report helps you identify ways to improve your\napp's performance.\n\nFor information on how to get started, see this [system tracing quickstart\nguide](https://perfetto.dev/docs/quickstart/android-tracing). You can also watch [this video on improving\nAndroid battery efficiency](https://youtu.be/jS46zP8kQ3k?si=BCteWawO-rK7EAGl).\n\nBackground Task Inspector\n\nYou can use Android Studio's\n[Background Task Inspector](/studio/inspect/task) to monitor [wake locks,\nalarms and jobs](/studio/inspect/task#inspect-jobs-alarms-wakelocks).\n\nIn particular, the WorkManager library uses JobScheduler to schedule and execute\njobs. While these jobs are running, they hold a wake lock that is attributed\nto the app. You can use Background Task Inspector to monitor workers and jobs\nthat execute in the background and see details about their work."]]