Zwalnianie blokady uśpienia
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie dowiesz się, jak zwolnić blokadę wybudzania utrzymywaną przez aplikację.
Aby uniknąć wyczerpania baterii, ważne jest, aby zwolnić blokadę wybudzania, gdy aplikacja przestanie jej używać.
Zwalnianie aktywnej blokady uśpienia
Aby zwolnić aktywną blokadę wybudzania, wywołaj jej metodę release(). W ten sposób zwalniasz roszczenie do procesora.
Na przykład ten kod uzyskuje blokadę wybudzania, wykonuje pewne działania, a następnie zwalnia blokadę:
Kotlin
@Throws(MyException::class)
fun doSomethingAndRelease() {
wakeLock.apply {
try {
acquire(WAKELOCK_TIMEOUT)
doTheWork()
} finally {
release()
}
}
}
Java
void doSomethingAndRelease() throws MyException {
try {
wakeLock.acquire(WAKELOCK_TIMEOUT);
doTheWork();
} finally {
wakeLock.release();
}
}
Pamiętaj, aby zwalniać blokady wybudzania, gdy nie są już potrzebne. Jeśli na przykład używasz blokady uśpienia, aby umożliwić dokończenie zadania w tle, pamiętaj, aby zwolnić blokadę, gdy tylko zadanie zostanie wykonane.
Najważniejsze informacje o tym kodzie
W tym przykładzie metoda doTheWork() może zwrócić wyjątek. Dlatego kod zwalnia blokadę wybudzania w bloku finally, aby mieć pewność, że blokada wybudzania zostanie zwolniona niezależnie od tego, czy zostanie zgłoszony wyjątek. Bardzo ważne jest, aby każdy ustawiony blokadę wybudzania został zwolniony. Dlatego musisz sprawdzić wszystkie możliwe ścieżki kodu, aby upewnić się, że blokada wybudzania nie pozostanie aktywna na żadnej z nich.
Najlepiej jest uzyskać blokadę wybudzania za pomocą metody
WakeLock.acquire(long timeout), która automatycznie zwalnia blokadę wybudzania po upływie określonego czasu oczekiwania.
Nadal jednak musisz wyraźnie zwalniać blokadę, gdy nie jest już potrzebna, aby nie była utrzymywana dłużej niż to konieczne.
Zobacz również
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-09-06 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-06 UTC."],[],[],null,["This page describes how to release a wake lock held by your app.\nIt's important to release a wake lock as soon as your app is\nfinished using it to avoid draining the battery.\n\nRelease an active wake lock\n\nTo release an active wake lock, call its [`release()`](/reference/android/os/PowerManager.WakeLock#release()) method. Doing so\nreleases your claim to the CPU.\n\nFor example, the following code [acquires a wake lock](/develop/background-work/background-tasks/awake/wakelock/set),\ndoes some work, then releases the wake lock:\n\n\nKotlin \n\n```kotlin\n@Throws(MyException::class)\nfun doSomethingAndRelease() {\n wakeLock.apply {\n try {\n acquire()\n doTheWork()\n } finally {\n release()\n }\n }\n}https://github.com/android/snippets/blob/3d5181b4813a17a1c236b134cc207dfee625885c/misc/src/main/java/com/example/snippets/backgroundwork/WakeLockSnippetsKotlin.kt#L43-L53\n```\n\nJava \n\n```java\nvoid doSomethingAndRelease() throws MyException {\n try {\n wakeLock.acquire();\n doTheWork();\n } finally {\n wakeLock.release();\n }\n}https://github.com/android/snippets/blob/3d5181b4813a17a1c236b134cc207dfee625885c/misc/src/main/java/com/example/snippets/backgroundwork/WakeLockSnippetsJava.java#L29-L36\n```\n\n\u003cbr /\u003e\n\nMake sure to release wake locks as soon as they are no longer needed. For\nexample, if you use a wake lock to allow a background task to finish, make sure\nto release the lock as soon as the task finishes.\n\nKey points about this code\n\nIn this example, the method `doTheWork()` might throw an exception. For this\nreason, the code releases the wake lock in the `finally` block, to make sure\nthe wake lock is released whether or not an exception is thrown. It's very\nimportant to make sure every wake lock you set is released, so you need to\ncheck every possible code path to make sure the wake lock isn't left active\non any of them.\n\nSee also\n\n- [Set a wake lock](/develop/background-work/background-tasks/awake/wakelock/set)"]]
