اشکال زدایی wake lock به صورت محلی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
تعدادی ابزار وجود دارد که می توانید برای اشکال زدایی یک برنامه محلی که از wake lock استفاده می کند، استفاده کنید. این ابزارها می توانند به شما در شناسایی و رفع مشکلات عملکرد کمک کنند.
ابزارهای زیر می توانند به شما در رفع اشکال یا بهینه سازی wake lock کمک کنند:
- dumpsys اطلاعاتی در مورد وضعیت خدمات سیستم در یک دستگاه ارائه می دهد.
- ردیابی سیستم یک فایل ردیابی تولید می کند که می توانید از آن برای تولید گزارش سیستم استفاده کنید.
- بازرس وظایف پس‌زمینه Android Studio به شما کمک می‌کند تا wake lockها را کنترل کنید، از جمله wake lockهایی که ممکن است توسط کتابخانه‌هایی مانند WorkManager به دست آیند.
دامپسیس
dumpsys ابزاری است که بر روی دستگاه های اندرویدی اجرا می شود و اطلاعاتی در مورد خدمات سیستم دستگاه ارائه می دهد.
دستور زیر به ویژه برای رفع اشکال wake lock مفید است:
-
adb shell dumpsys batterystats تاریخچه دقیقی از wake lockهایی که توسط هر برنامه نگهداری می شود را ارائه می دهد. برای اطلاعات بیشتر، به مستندات dumpsys Inspect عیب‌یابی باتری مراجعه کنید.
ردیابی سیستم
ردیابی سیستم طیف وسیعی از فعالیت دستگاه را در مدت کوتاهی ثبت می کند. ردیابی سیستم یک فایل ردیابی تولید می کند که می توانید از آن برای تولید گزارش سیستم استفاده کنید. این گزارش به شما کمک می کند تا راه هایی را برای بهبود عملکرد برنامه خود شناسایی کنید.
برای کسب اطلاعات در مورد نحوه شروع، به این راهنمای شروع سریع ردیابی سیستم مراجعه کنید. همچنین می توانید این ویدیو را در مورد بهبود کارایی باتری اندروید مشاهده کنید.
بازرس وظیفه پس زمینه
می‌توانید از بازرس وظایف پس‌زمینه Android Studio برای نظارت بر wake lock، زنگ هشدار و مشاغل استفاده کنید.
به طور خاص، کتابخانه WorkManager از JobScheduler برای زمان‌بندی و اجرای کارها استفاده می‌کند. در حالی که این مشاغل در حال اجرا هستند، یک wake lock را نگه می دارند که به برنامه نسبت داده می شود. می‌توانید از Background Task Inspector برای نظارت بر کارگران و کارهایی که در پس‌زمینه اجرا می‌شوند استفاده کنید و جزئیات مربوط به کار آنها را ببینید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
