عمليات قفل التنشيط الجزئي الزائدة عن الحد

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

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

تُعدّ ملاحظاتك جزءًا مهمًا من عملية تحسين مستنداتنا. يُرجى تقديم ملاحظاتك من خلال الرابط التالي:

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

رصد المشكلة

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

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

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

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

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

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

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

حل المشكلة

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

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

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

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

انظر أيضًا