Bloqueos de activación parciales excesivos (beta)

Los bloqueos de activación parciales son un mecanismo en la API de PowerManager que les permite a los desarrolladores mantener la CPU en ejecución después de que se apaga la pantalla de un dispositivo (ya sea debido al tiempo de espera del sistema o a que el usuario haya presionado el botón de encendido). Para adquirir un bloqueo de activación parcial, tu app debe llamar a acquire() con la marca PARTIAL_WAKE_LOCK o usar otras APIs que adquieran bloqueos de activación. El uso excesivo de bloqueos de activación parciales agota la batería del dispositivo, ya que impide que ingrese en estados de bajo consumo. Debes usar el bloqueo de activación parcial solo cuando sea necesario y liberarlo cuando ya no lo necesites.

Si tu app usa bloqueos de activación parcial de forma excesiva, puedes seguir las indicaciones que se incluyen en esta página para diagnosticar el problema y corregirlo.

Tus comentarios son fundamentales para mejorar nuestra documentación. Envíanos tus comentarios mediante el siguiente vínculo:

Enviar comentarios

Cómo detectar el problema

Android vitals puede ayudarte a descubrir cuándo el uso de bloqueos de activación parciales de tu app es excesivo.

Android vitals

Android vitals puede ayudarte a mejorar el rendimiento de tu app. Para ello, te envía alertas a través de Play Console cuando el uso de bloqueos de activación parciales de tu app es excesivo.

Android vitals informa que el uso de bloqueos de activación parcial es excesivo cuando todos los bloqueos de activación parcial, sumados, se ejecutan durante 3 o más horas en un período de 24 horas.

Android vitals realiza un seguimiento del tiempo solo si el bloqueo de activación se mantiene cuando la app está en segundo plano y no tiene un servicio en primer plano.

Android vitals otorga algunas exenciones al uso de bloqueos de activación parcial en situaciones en las que el bloqueo de activación parcial ofrece un beneficio claro para el usuario y no hay una mejor manera de lograr ese resultado sin él. En esos casos, es posible que Android vitals no registre el tiempo de bloqueo de activación parcial en el límite de 3 horas. Por ejemplo, si una app reproduce audio para el usuario, hay un beneficio claro en mantener el dispositivo activo y no hay forma de reproducir el audio sin mantenerlo activo. En ese caso, el tiempo de bloqueo de activación parcial no se registra en Android vitals.

Si se producen bloqueos de activación parciales excesivos en más del 5% de las sesiones de la app en todos los dispositivos durante un período de 28 días, es posible que se vea afectada la visibilidad de tu app en Play una vez que la métrica salga de la versión beta.

Una vez que se te informa que tu app presenta demasiados bloqueos de activación parciales, el siguiente paso es abordar el problema.

Cómo corregir el problema

Debido a que los bloqueos de activación pueden agotar la batería del dispositivo, no debes usarlos si hay una alternativa. La documentación Elige la API correcta para mantener el dispositivo activo puede ayudarte a encontrar la mejor solución para tu app.

Si necesitas usar un bloqueo de activación, sigue las prácticas recomendadas de bloqueo de activación para asegurarte de que no afecten la eficiencia del dispositivo. En particular, asegúrate de que todos los dispositivos que adquieras estén liberados y libera el bloqueo lo antes posible.

Una vez que hayas corregido el problema en el código, puedes verificar tus correcciones con las herramientas de depuración de bloqueos de activación locales.

Consulta también