تصحيح أخطاء عمليات قفل التنشيط على الجهاز
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتوفّر عدة أدوات يمكنك استخدامها لتصحيح الأخطاء في تطبيق يعمل على جهازك ويستخدم عمليات قفل التنشيط. يمكن أن تساعدك هذه الأدوات في تحديد مشاكل الأداء وحلّها.
يمكن أن تساعدك الأدوات التالية في تصحيح أخطاء عمليات قفل التنشيط أو تحسينها:
- توفّر أداة dumpsys معلومات حول حالة خدمات النظام على الجهاز.
- تنتج عملية تتبُّع النظام ملف تتبُّع يمكنك استخدامه لإنشاء تقرير نظام.
- تساعدك أداة فحص المهام في الخلفية في "استوديو Android" على تتبُّع عمليات قفل التنشيط، بما في ذلك عمليات قفل التنشيط التي قد تستخدمها مكتبات مثل WorkManager.
dumpsys
dumpsys هي أداة تعمل على أجهزة Android وتوفّر معلومات حول خدمات النظام على الجهاز.
يكون الأمر التالي مفيدًا بشكل خاص لتصحيح أخطاء عمليات قفل التنشيط:
- تقدِّم
adb shell dumpsys batterystats سجلاً تفصيليًا لأقفال التنشيط التي يحتفظ بها كل تطبيق. لمزيد من المعلومات، راجِع مستندات فحص بيانات تشخيص البطارية في dumpsys.
تتبُّع النظام
تسجّل عمليات تتبُّع النظام مجموعة كبيرة من أنشطة الجهاز
خلال فترة قصيرة. تنتج عملية تتبُّع النظام ملف تتبُّع يمكنك استخدامه لإنشاء تقرير نظام. يساعدك هذا التقرير في تحديد طرق لتحسين أداء تطبيقك.
للحصول على معلومات حول كيفية البدء، اطّلِع على دليل البدء السريع لتتبُّع نشاط النظام. يمكنك أيضًا مشاهدة هذا الفيديو حول تحسين كفاءة البطارية في Android.
أداة فحص المهام في الخلفية
يمكنك استخدام أداة فحص المهام التي تعمل في الخلفية في Android Studio لمراقبة أقفال التنشيط والتنبيهات والمهام.
على وجه الخصوص، تستخدم مكتبة WorkManager واجهة JobScheduler لجدولة المهام وتنفيذها. أثناء تنفيذ هذه المهام، يتم الاحتفاظ بقفل تنبيه منسوب إلى التطبيق. ويمكنك استخدام "أداة فحص المهام في الخلفية" لمراقبة المهام وعمال الخلفية الذين يتم تنفيذهم في الخلفية والاطّلاع على تفاصيل حول عملهم.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java و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."]]
