عمليات قفل تفعيل جزئية متوقفة

عمليات قفل التنشيط الجزئي هي آلية في واجهة برمجة التطبيقات PowerManager تتيح للمطوّرين إبقاء وحدة المعالجة المركزية (CPU) قيد التشغيل بعد إيقاف شاشة الجهاز (سواء بسبب انتهاء مهلة النظام أو ضغط المستخدم على زر التشغيل). يحصل تطبيقك على قفل تنبيه جزئي من خلال استدعاء acquire() باستخدام العلامة PARTIAL_WAKE_LOCK، أو باستخدام واجهات برمجة التطبيقات الأخرى التي تحصل على أقفال التنبيه. يحدث تعطُّل لقفل التنشيط الجزئي إذا تم الاحتفاظ به لفترة طويلة أثناء تشغيل تطبيقك في الخلفية (لا يظهر أي جزء من تطبيقك للمستخدم). تؤدي هذه الحالة إلى استنزاف بطارية الجهاز لأنّها تمنعه من الانتقال إلى حالات استهلاك أقل للطاقة. يجب استخدام أقفال التنشيط الجزئية عند الضرورة فقط وإيقافها فورًا عند عدم الحاجة إليها.

إذا كان تطبيقك يتضمّن قفل تنبيه جزئيًا عالقًا، يمكنك اتّباع الإرشادات الواردة في هذه الصفحة لتشخيص المشكلة وحلّها.

رصد المشكلة

قد لا تعرف دائمًا أنّ عمليات قفل التنشيط الجزئية في تطبيقك متوقفة. إذا سبق لك نشر تطبيقك، يمكن أن تساعدك "مؤشرات Android الحيوية" في التعرّف على المشكلة.

مؤشرات Android الحيوية

يمكن أن تساعد "مؤشرات Android الحيوية" في تحسين أداء تطبيقك من خلال تنبيهك عبر Play Console عندما يعرض تطبيقك عمليات قفل تنبيه جزئية عالقة. تسجِّل "مؤشرات Android الحيوية" عمليات قفل التنشيط الجزئية المتوقفة عندما يحدث قفل تنشيط جزئي واحد على الأقل لمدة ساعة واحدة في الخلفية خلال فترة 24 ساعة.

عدد جلسات البطارية المعروضة هو إجمالي عدد المستخدمين الذين تم قياس بياناتهم في التطبيق. وللحصول على معلومات حول طريقة جمع Google Play لبيانات "مؤشرات Android الحيوية"، يمكنك الاطّلاع على مستندات Play Console.

بعد أن تتأكّد من أنّ تطبيقك يتضمّن عمليات قفل تنبيه جزئي عالقة، تتمثّل خطوتك التالية في معالجة المشكلة.

حل المشكلة

بما أنّ أقفال التنشيط يمكن أن تستنزف بطارية الجهاز، لا ننصح باستخدامها إذا كان هناك بديل. يمكن أن تساعدك مستندات اختيار واجهة برمجة التطبيقات المناسبة لإبقاء الجهاز نشطًا في العثور على أفضل حل لتطبيقك.

إذا كنت بحاجة إلى استخدام قفل التنشيط، اتّبِع أفضل ممارسات قفل التنشيط للتأكّد من أنّ أقفال التنشيط لا تؤثّر سلبًا في كفاءة الجهاز. على وجه الخصوص، احرص على إيقاف قفل كل جهاز تحصل عليه، وإيقاف القفل في أسرع وقت ممكن.

بعد إصلاح المشكلة في الرمز، يمكنك التأكّد من أنّك حللتها باستخدام أدوات تصحيح الأخطاء في قفل التنشيط المحلي.

انظر أيضًا

السابق
أعطال "إغلاق التطبيقات بسبب نقص الذاكرة"
التالي
عمليات الاستيقاظ المفرطة