WakeLock: какво е, видове и управление на блокировка на съня

Какво е WakeLock

WakeLock е системна блокировка, която забранява на Android да превключи устройството в режим на ниска консумация на енергия. Обикновено Android след няколко секунди бездействие на потребителя изключва екрана и превключва процесора в състояние на дълбок сън (deep sleep), при което фоновите нишки се спират. WakeLock предотвратява този преход, като поддържа CPU в активен режим.

Механизмът WakeLock се управлява чрез системната услуга PowerManager, до която се осъществява достъп чрез метода getSystemService(Context.POWER_SERVICE). Разработчикът създава обект WakeLock, като посочва типа на блокировката, и трябва гарантирано да го освободи след завършване на задачата, в противен случай батерията на устройството ще се разрежда бързо. Системата не освобождава WakeLock автоматично — това е отговорност на приложението.

С всяка основна версия на Android Google затяга контрола върху WakeLock. Започвайки от Android 9 (API 28), приложение на заден план не може да получи WakeLock без основателна причина, а системата проследява приложенията, които злоупотребяват с блокировките, и може принудително да ги освобождава. В Android 12+ бяха въведени допълнителни ограничения за достъп до PowerManager за фонови приложения.

Кога е необходим WakeLock

WakeLock е необходим в сценарии, където задачата не може да бъде прекъсната от преминаването на устройството в сън: изтегляне на голям файл чрез нестабилна връзка, запис на видео, извършване на дълги изчисления без участие на потребителя. Без блокировка на съня процесорът преминава в дълбок сън, всички нишки (threads) се замразяват и задачата остава незавършена.

Въпреки това, Google настоятелно препоръчва да се минимизира използването на WakeLock. В повечето случаи същата задача може да бъде решена с Foreground Service с известие, WorkManager или JobScheduler. Тези механизми вземат предвид състоянието на батерията и мрежата, което удължава времето за работа на устройството с батерия.

Как работи WakeLock

WakeLock работи чрез системната услуга PowerManager, която управлява състоянието на захранването на устройството. Когато приложението поиска блокировка чрез powerManager.newWakeLock(), системата повишава нивото на активност на CPU, предотвратявайки преминаването в дълбок сън. След извикване на wakeLock.release() системата се връща към нормалния режим на пестене на енергия.

Важно е да се разбере, че WakeLock не предотвратява всички режими на пестене на енергия. Doze Mode (режим на сън Android 6+) може да игнорира WakeLock в определени фази — приложение със задържан WakeLock няма да получи достъп до мрежата в прозорците за поддръжка на Doze. Това означава, че дори активен WakeLock не гарантира изпълнение на мрежови операции по време на втората фаза на Doze.

Всеки WakeLock е свързан с PowerManager.WakeLock от страна на framework. Системата води преброяване на активните блокировки на ниво процес: ако един процес задържа няколко WakeLock, те се сумират и освобождаването става само след извикване на release() за всяка блокировка. Android също поддържа wake lock timeouts — автоматично освобождаване след зададен интервал. Въпреки това, разчитането на timeout не се препоръчва: задачата може да приключи по-рано и допълнителното време на задържане ще намали живота на батерията.

WakeLock и системни събития

При преминаване на устройството в режим на сън (бутон за захранване), Android принудително освобождава всички SCREEN_DIM_WAKE_LOCK и SCREEN_BRIGHT_WAKE_LOCK, но запазва PARTIAL_WAKE_LOCK. Това означава, че блокировката на екрана не може да попречи на устройството да изключи дисплея — само PARTIAL_WAKE_LOCK може да продължи да работи след натискане на бутона за захранване.

Видове WakeLock в Android

В Android съществуват няколко вида WakeLock, всеки от които управлява конкретни компоненти на устройството. Изборът на вид определя кои хардуерни компоненти остават активни след блокировката. Неправилният избор на вид води до прекомерна консумация на енергия поради включване на ненужни модули.

PARTIAL_WAKE_LOCK — основният вид

PARTIAL_WAKE_LOCK е най-често използваният и препоръчван вид. Той поддържа CPU в активен режим, но позволява на екрана и подсветката на клавиатурата да се изключат. Това е оптималният избор за фонови задачи: изтегляне на данни, обработка на изображения, синхронизация. Екранът угасва след системния таймаут, което пести батерия по време на извършване на невидима за потребителя работа.

Остарели видове (deprecated)

SCREEN_DIM_WAKE_LOCK, SCREEN_BRIGHT_WAKE_LOCK и FULL_WAKE_LOCK са маркирани като остарели от Android 7 (API 24). Те поддържат екрана включен, което води до значителна консумация на батерия. Google препоръчва вместо тях да се използва FLAG_KEEP_SCREEN_ON чрез Activity.getWindow().addFlags() — този флаг работи само с активна Activity и не изисква разрешение WAKE_LOCK, а системата автоматично управлява времето на задържане на екрана.

WakeLock и консумация на енергия

WakeLock е един от основните „консуматори" на батерия в Android. Всяка секунда задържане на блокировката на съня консумира допълнителна енергия, тъй като процесорът не може да премине в енергийно ефективно състояние C-state. Изследване на Google Power Dashboard показва, че приложения с неправилно освободени WakeLock могат да увеличат консумацията на енергия на устройството с 30–50% в режим на готовност.

Системата проследява приложенията, които злоупотребяват с WakeLock, чрез компонента Battery Historian. Разработчикът може да анализира профила на консумация на енергия и да открие „изтичания" на блокировки — ситуации, при които WakeLock е създаден, но не е освободен. Google Play Console показва статистика за WakeLock за публикувани приложения и дългото време на задържане може да бъде причина за лоши отзиви.

Doze Mode и App Standby допълнително ограничават работата на WakeLock. В първата фаза на Doze (Light Doze) системата разрешава WakeLock в кратки прозорци за поддръжка. Във втората фаза (Deep Doze) WakeLock се обединява с други блокировки и се изпълнява в общ прозорец. Ако приложението задържа WakeLock повече от 10 минути без потребителско взаимодействие, системата може принудително да го освободи и да постави приложението в черния списък за оптимизация на батерията.

• Battery Historian — инструмент за анализ на консумацията на енергия и изтичания на WakeLock
• Doze Mode — ограничава WakeLock в прозорци за поддръжка, обединявайки блокировките
• Google Play Console — показва статистика за WakeLock за публикувани приложения
• Черен списък — приложението може да бъде маркирано от системата като енергоемко

Най-добри практики за използване

Правилното използване на WakeLock е баланс между необходимостта да се изпълни задача и грижата за батерията на устройството. Google препоръчва да се спазват няколко принципа: винаги освобождавайте WakeLock в finally или чрез acquire(timeout), използвайте минимално необходимия вид блокировка и избягвайте продължително задържане без крайна необходимост.

Правило за освобождаване

WakeLock трябва да бъде освободен в същия блок код, в който е създаден. За гарантирано освобождаване при изключения се използва конструкцията try-finally или use блок в Kotlin. На Android 10+ системата показва предупреждение в logcat, ако WakeLock се задържа повече от 60 секунди: "WakeLock held for more than 60 seconds" — това е сигнал за възможно изтичане.

Таймаут при придобиване

Методът acquire(long timeout) автоматично освобождава WakeLock след зададено време в милисекунди. Това е застраховка в случай, че кодът за освобождаване не се изпълни поради изключение или грешка. Препоръчва се винаги да задавате timeout, равен на максималното очаквано време за изпълнение на задачата плюс 10–20% резерв.

Проверка за наличие на блокировка

Преди извикване на release() трябва да проверите дали WakeLock в момента се задържа. Повторно извикване на release() без предварително acquire() предизвиква RuntimeException: WakeLock under-locked. Препоръчва се да съхранявате флаг за състояние (isHeld) и преди освобождаване да проверявате wakeLock.isHeld().

Използване на WakeLock в Kotlin

Нека разгледаме правилното създаване и освобождаване на WakeLock в Kotlin. Примерът демонстрира асинхронно изтегляне на данни със задържане на PARTIAL_WAKE_LOCK, гарантирано освобождаване в блок try-finally и задаване на timeout за защита от изтичания. Услугата използва CoroutineScope с IO диспечер за изпълнение на фоновата задача.

class DownloadService : Service() {

    private lateinit var wakeLock: PowerManager.WakeLock
    private val scope = CoroutineScope(Dispatchers.IO + SupervisorJob())

    override fun onCreate() {
        super.onCreate()
        val powerManager = getSystemService(Context.POWER_SERVICE) as PowerManager
        wakeLock = powerManager.newWakeLock(
            PowerManager.PARTIAL_WAKE_LOCK,
            "download:wakelock"
        )
    }

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        wakeLock.acquire(60000)
        scope.launch {
            try {
                downloadFile()
            } finally {
                if (wakeLock.isHeld()) {
                    wakeLock.release()
                }
            }
        }
        return START_NOT_STICKY
    }

    private suspend fun downloadFile() {
        // Симулация на изтегляне на файл
        delay(30000)
    }

    override fun onDestroy() {
        super.onDestroy()
        scope.cancel()
        if (wakeLock.isHeld()) {
            wakeLock.release()
        }
    }

    override fun onBind(intent: Intent): IBinder? = null
}

Деклариране на разрешение в манифеста

За използване на WakeLock трябва да добавите разрешение в AndroidManifest.xml. Разрешението WAKE_LOCK е нормално (normal) — не изисква runtime заявка от потребителя и се предоставя автоматично при инсталиране на приложението. Въпреки това, Google Play може да откаже публикуване, ако приложението няма очевиден сценарий за използване на WakeLock.

<uses-permission
    android:name="android.permission.WAKE_LOCK" />

<uses-permission
    android:name="android.permission.DEVICE_POWER" />

Алтернативи на WakeLock

WakeLock е ниско ниво механизъм и Google препоръчва, когато е възможно, да бъде заменен с по-модерни API. Основната алтернатива е Foreground Service с известие, който автоматично поддържа CPU блокировка по време на работа на услугата. Системата сама управлява WakeLock за Foreground Service, освобождавайки разработчика от необходимостта от изрично придобиване и освобождаване.

WorkManager е вторият по важност инструмент за фонови задачи. Той гарантира изпълнение на работата дори при преминаване на устройството в Doze и след рестарт. WorkManager поддържа задържане на блокировка (hold lock) вътрешно — разработчикът не трябва изрично да работи с PowerManager. Задачата се изпълнява в прозореца за поддръжка на Doze с автоматично управление на блокировката на съня.

За редовни задачи, изискващи точно време, се използва AlarmManager с setAndAllowWhileIdle(), който може да събуди устройството от Doze. Въпреки това, AlarmManager е подходящ само за кратки операции — не е предназначен за продължително задържане на WakeLock. Ако задачата продължава повече от 10 секунди, трябва да комбинирате AlarmManager с BroadcastReceiver, който стартира Foreground Service.

• Foreground Service — автоматично управление на WakeLock с известие
• WorkManager — гарантирано изпълнение, съобразено с Doze и рестарт
• JobScheduler — планиране, съобразено с мрежа, зареждане и бездействие
• AlarmManager — събуждане на устройството за кратки задачи по разписание