Wybudzenia to mechanizm w interfejsie API AlarmManager, który umożliwia deweloperom ustawienie alarmu, który wybudzi urządzenie o określonej godzinie. Aplikacja ustawia alarm wybudzający, wywołując jedną z metod set w AlarmManager z flagą RTC_WAKEUP lub ELAPSED_REALTIME_WAKEUP. Gdy zostanie wywołany alarm wybudzający, urządzenie wychodzi z trybu oszczędzania baterii i utrzymuje częściową blokadę uśpienia podczas wykonywania metody onReceive lub onAlarm alarmu. Jeśli alarmy wybudzające są wywoływane zbyt często, mogą rozładowywać baterię urządzenia.
Jeśli aplikacja zbyt często wybudza urządzenie, możesz skorzystać z informacji na tej stronie, aby zdiagnozować i rozwiązać problem.
Rozwiązanie problemu
Komponent AlarmManager został wprowadzony we wczesnych wersjach platformy Android, ale z czasem wiele przypadków użycia, które wcześniej wymagały komponentu AlarmManager, jest teraz lepiej obsługiwanych przez nowsze funkcje, takie jak WorkManager. Ta sekcja zawiera wskazówki dotyczące ograniczania alarmów wybudzających, ale w dłuższej perspektywie warto rozważyć dostosowanie aplikacji do zaleceń dotyczących alarmów wybudzających.
Zidentyfikuj miejsca w aplikacji, w których planujesz alarmy wybudzające, i zmniejsz częstotliwość ich uruchamiania. Oto kilka porad:
Poszukaj wywołań różnych metod
setwAlarmManager, które zawierają flagęRTC_WAKEUPlubELAPSED_REALTIME_WAKEUP.Zalecamy uwzględnienie nazwy pakietu, klasy lub metody w nazwie tagu alarmu, aby można było łatwo zidentyfikować lokalizację w źródle, w której ustawiono alarm. Oto kilka dodatkowych wskazówek:
- Nie podawaj w nazwie żadnych informacji umożliwiających identyfikację, takich jak adres e-mail. W przeciwnym razie urządzenie zarejestruje
_UNKNOWNzamiast nazwy alarmu. - Nie pobieraj nazwy klasy ani metody automatycznie, np. przez wywołanie
getName(), ponieważ może ona zostać zaciemniona przez Proguard. Zamiast tego użyj ciągu znaków zakodowanego na stałe. - Nie dodawaj do tagów alarmu licznika ani unikalnych identyfikatorów. System nie będzie mógł agregować alarmów ustawionych w ten sposób, ponieważ wszystkie mają unikalne identyfikatory.
- Nie podawaj w nazwie żadnych informacji umożliwiających identyfikację, takich jak adres e-mail. W przeciwnym razie urządzenie zarejestruje
Po rozwiązaniu problemu sprawdź, czy alarmy wybudzające działają zgodnie z oczekiwaniami, uruchamiając to polecenie ADB:
adb shell dumpsys alarm
To polecenie dostarcza informacji o stanie usługi systemu alarmowego na urządzeniu. Więcej informacji znajdziesz w sekcji dumpsys.
Zalecenia dotyczące alarmów pobudki
Używaj alarmów wybudzających tylko wtedy, gdy aplikacja musi wykonać operację widoczną dla użytkownika (np. opublikować powiadomienie lub wysłać alert). Listę sprawdzonych metod dotyczących AlarmManager znajdziesz w artykule Planowanie alarmów.
Nie używaj AlarmManager do planowania zadań w tle, zwłaszcza powtarzających się lub sieciowych. Do planowania zadań w tle używaj biblioteki WorkManager, ponieważ zapewnia ona te korzyści:
- grupowanie – zadania są łączone, aby zmniejszyć zużycie baterii;
- trwałość – jeśli urządzenie zostanie uruchomione ponownie, zaplanowane zadania WorkManagera zostaną uruchomione po zakończeniu ponownego uruchamiania;
- kryteria – zadania mogą być uruchamiane na podstawie warunków, takich jak to, czy urządzenie się ładuje lub czy jest dostępne Wi-Fi;
Więcej informacji znajdziesz w przewodniku po przetwarzaniu w tle.
Nie używaj AlarmManager do planowania operacji czasowych, które są prawidłowe tylko wtedy, gdy aplikacja jest uruchomiona (innymi słowy, operacja czasowa powinna zostać anulowana, gdy użytkownik zamknie aplikację). W takich sytuacjach używaj klasy Handler, ponieważ jest łatwiejsza w użyciu i znacznie wydajniejsza.
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy język JavaScript jest wyłączony.
- Ciągłe częściowe blokady uśpienia
- Błędy ANR