عمليات قفل التنشيط الجزئي الزائدة عن الحد (إصدار تجريبي)

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

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

ملاحظاتك هي جزء مهم من تحسين مستنداتنا. يُرجى إرسال ملاحظاتك باستخدام الرابط التالي:

تقديم ملاحظات

رصد المشكلة

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

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

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

تُبلغ "مؤشرات Android الحيوية" عن استخدام قفل تنشيط الجهاز الجزئي على أنّه مفرط عندما تعمل جميع أقفال تنشيط الجهاز الجزئية معًا لمدة 3 ساعات أو أكثر في فترة 24 ساعة.

لا تتتبّع "مؤشرات Android الحيوية" الوقت إلا إذا تم الاحتفاظ بقفل التنشيط عندما يكون التطبيق قيد التشغيل في الخلفية ولا يستخدم خدمة تعمل في المقدّمة.

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

إذا حدثت عمليات قفل استيقاظ جزئية مفرطة في أكثر من% 5 من جلسات التطبيق على جميع الأجهزة خلال فترة 28 يومًا، يمكن أن يؤثر ذلك في ظهور تطبيقك على Play بعد انتهاء مرحلة الإصدار العلني لقياس الأداء.

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

حل المشكلة

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

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

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

انظر أيضًا