Android 13 (poziom API 33) i nowsze wersje obsługują uprawnienie w czasie działania umożliwiające wysyłanie niezwolnionych powiadomień (w tym z usług działających na pierwszym planie) z aplikacji:
POST_NOTIFICATIONS.
Ta zmiana pomaga użytkownikom skupić się na powiadomieniach, które są dla nich najważniejsze.
Zalecamy jak najszybsze przejście na Androida 13 lub nowszego, aby zyskać dodatkową kontrolę i elastyczność tej funkcji. Jeśli nadal kierujesz aplikację na Androida 12L (poziom interfejsu API 32) lub starszego, tracisz pewną elastyczność w sposobie wyrażania zgody na uprawnienia w kontekście funkcjonalności aplikacji.
Zadeklaruj uprawnienie
Aby poprosić o nowe uprawnienie do wysyłania powiadomień, zaktualizuj aplikację, aby kierowała się na Androida 13, i wykonaj podobny proces, co w przypadku udzielania innych uprawnień w czasie wykonywania, jak pokazano w następnych sekcjach.
Uprawnienie, które musisz zadeklarować w pliku manifestu aplikacji, jest widoczne w tym fragmencie kodu:
<manifest ...> <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/> <application ...> ... </application> </manifest>
Funkcje aplikacji zależą od wyboru użytkownika w oknie uprawnień
W tym oknie użytkownicy mogą wykonać te czynności:
- Wybierz Zezwól.
- Wybierz Nie zezwalaj
- Przesuń palcem w stronę poza okno, nie naciskając żadnego przycisku.
W sekcjach poniżej opisujemy, jak aplikacja ma się zachowywać w zależności od działania użytkownika.
Użytkownik klika „Zezwól”
Jeśli użytkownik wybierze opcję Zezwól, aplikacja może:
- wysyłać powiadomienia; Dozwolone są wszystkie kanały powiadomień.
- publikować powiadomienia związane z usługami na pierwszym planie, Te powiadomienia wyświetlają się w panelu powiadomień.
Użytkownik klika „Nie zezwalaj”.
Jeśli użytkownik wybierze opcję Nie zezwalaj, aplikacja nie będzie mogła wysyłać powiadomień, chyba że kwalifikuje się do wyjątku. Wszystkie kanały powiadomień są zablokowane z wyjątkiem tych, które są przypisane do kilku konkretnych ról. Jest to podobne do tego, co dzieje się, gdy użytkownik ręcznie wyłączy wszystkie powiadomienia z aplikacji w ustawieniach systemu.
Uwaga: jeśli Twoja aplikacja jest przeznaczona na Androida w wersji 12L lub niższej, a użytkownik kliknie Nie zezwalaj, nawet tylko raz, nie wyświetli się ponownie żadna prośba, dopóki nie nastąpi jedno z tych zdarzeń:
- Użytkownik odinstaluje i ponownie zainstaluje aplikację.
- Zaktualizuj aplikację, aby była kierowana na Androida 13 lub nowszego.
Użytkownik odsuwa okno dialogowe
Jeśli użytkownik przesunie palcem w bok, aby zamknąć okno, to znaczy, że nie wybierze Zezwalaj ani Nie zezwalaj. W takim przypadku stan uprawnień do powiadomień się nie zmieni.
Wpływ na nowo zainstalowane aplikacje
Jeśli użytkownik zainstaluje Twoją aplikację na urządzeniu z Androidem 13 lub nowszym, powiadomienia będą domyślnie wyłączone. Aplikacja musi zaczekać z wysyłaniem powiadomień do momentu, gdy poprosisz o nowe uprawnienia i użytkownik przyzna je aplikacji.
Czas wyświetlenia okna z uprawnieniami zależy od wersji docelowej pakietu SDK aplikacji:
- Jeśli Twoja aplikacja jest kierowana na Androida 13 lub nowszego, ma pełną kontrolę nad tym, kiedy wyświetla się okno z prośbą o uprawnienia. Wykorzystaj tę okazję, aby wyjaśnić użytkownikom, dlaczego aplikacja potrzebuje tych uprawnień, i zachęcić ich do ich przyznania.
- Jeśli Twoja aplikacja jest kierowana na Androida 12L (poziom interfejsu API 32) lub starszego, system wyświetla okno z prośbą o uprawnienia za każdym razem, gdy aplikacja uruchamia aktywność po utworzeniu kanału powiadomień lub gdy uruchamia aktywność, a następnie tworzy pierwszy kanał powiadomień. Zwykle jest to uruchomienie aplikacji.
Wpływ na aktualizacje dotychczasowych aplikacji
Aby zminimalizować zakłócenia związane z uprawnieniami do wyświetlania powiadomień, system automatycznie przyznaje te uprawnienia wszystkim kwalifikującym się aplikacjom, gdy użytkownik przejdzie na Androida 13 lub nowszego. Oznacza to, że te aplikacje mogą nadal wysyłać powiadomienia do użytkowników, a użytkownicy nie widzą prośby o uprawnienia w czasie działania.
Kryteria kwalifikacji do wstępnego przyznania uprawnień
Aby aplikacja kwalifikowała się do automatycznego przyznania wstępnego, musi mieć istniejący kanał powiadomień i nie może mieć wyraźnie wyłączonych powiadomień przez użytkownika na urządzeniu z rozmiarem 12 L lub niższym.
Jeśli użytkownik wyłączył powiadomienia z Twojej aplikacji na urządzeniu z Androidem 12L lub starszym, odmowa będzie obowiązywać po uaktualnieniu urządzenia do Androida 13 lub nowszego.
Zwolnienia
Ta sekcja zawiera zestaw powiadomień i aplikacji, które nie są objęte zmianą zachowania uprawnień powiadomień. Na Androidzie 13 (API na poziomie 33) lub nowszym, jeśli użytkownik odmówi udzielenia uprawnień do wysyłania powiadomień, nadal będzie widzieć powiadomienia związane z usługami na pierwszym planie w Menedżerze zadań, ale nie będzie ich widzieć w schowku powiadomień.
Sesje multimediów
Powiadomienia związane z sesjami multimedialnymi są wyłączone z tej zmiany zachowania.
aplikacje skonfigurowane do samodzielnego zarządzania połączeniami telefonicznymi;
Jeśli aplikacja sama zarządza połączeniami telefonicznymi, nie musisz przyznać jej uprawnienia POST_NOTIFICATIONS, aby wysyłała powiadomienia w stylu Notification.CallStyle.
System uznaje, że Twoja aplikacja jest skonfigurowana do samodzielnego zarządzania połączeniami telefonicznymi, jeśli spełnia wszystkie te warunki:
- Deklaruje uprawnienie
MANAGE_OWN_CALLS. - Implementuje interfejs
ConnectionService. - Rejestruje się u dostawcy usług telekomunikacyjnych urządzenia, dzwoniąc na numer
registerPhoneAccount().
Testowanie aplikacji
Możesz ocenić, jak uprawnienie do wyświetlania powiadomień wpływa na Twoją aplikację przy pierwszym użyciu na urządzeniu z Androidem 13 lub nowszym. Te zestawy poleceń Android Debug Bridge (ADB) umożliwiają symulowanie najczęstszych sekwencji wyborów użytkownika i uaktualnień urządzenia bez konieczności resetowania urządzenia testowego:
Aplikacja została niedawno zainstalowana na urządzeniu z Androidem w wersji 13 lub nowszej:
adb shell pm revoke PACKAGE_NAME android.permission.POST_NOTIFICATIONSadb shell pm clear-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-setadb shell pm clear-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-fixedUżytkownik włącza powiadomienia, gdy aplikacja jest zainstalowana na urządzeniu z Androidem 12L lub starszym, a następnie urządzenie zostaje zaktualizowane do Androida 13 lub nowszego:
adb shell pm grant PACKAGE_NAME android.permission.POST_NOTIFICATIONSadb shell pm set-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-setadb shell pm clear-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-fixedUżytkownik ręcznie wyłącza powiadomienia, gdy aplikacja jest zainstalowana na urządzeniu z Androidem 12L lub starszym, a następnie urządzenie zostanie zaktualizowane do Androida 13 lub nowszego:
adb shell pm revoke PACKAGE_NAME android.permission.POST_NOTIFICATIONSadb shell pm set-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-setadb shell pm clear-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-fixed
Sprawdzone metody
W tej sekcji opisujemy kilka sposobów na najefektywniejsze korzystanie z nowych uprawnień do powiadomień w aplikacji.
Aktualizowanie docelowej wersji pakietu SDK aplikacji
Aby zapewnić swojej aplikacji większą elastyczność w zakresie czasu, w którym wyświetla się okno uprawnień, zaktualizuj aplikację, tak aby była kierowana na Androida 13 lub nowszego.
Poczekaj na wyświetlenie prośby o zgodę na wyświetlanie powiadomień
Zanim poprosisz użytkowników o przyznanie uprawnień, pozwól im zapoznać się z aplikacją.
Nowi użytkownicy mogą chcieć zapoznać się z aplikacją i sprawdzić, jakie korzyści daje każda prośba o powiadomienie. Możesz wyświetlić prośbę o przyznanie uprawnień w reakcji na działanie użytkownika. Na poniższej liście znajdziesz kilka przykładów sytuacji, w których warto wyświetlić prośbę o zgodę na wyświetlanie powiadomień:
- Użytkownik klika przycisk „dzwonka alertu”.
- Użytkownik decyduje się na obserwowanie czyjegoś konta w mediach społecznościowych.
- Użytkownik przesyła zamówienie z dostawą jedzenia.
Rysunek 1 przedstawia zalecany proces żądania uprawnień do wysyłania powiadomień. Jeśli funkcja shouldShowRequestPermissionRationale() nie zwraca wartości true, aplikacja nie musi wyświetlać środkowego ekranu, czyli ekranu z tytułem „Otrzymuj powiadomienia”.
Możesz też ustawić prośbę tak, aby pojawiała się po tym, jak umożliwisz użytkownikom zapoznanie się z Twoją aplikacją, np. 3 lub 4 razy jej uruchomienie przez użytkownika.
shouldShowRequestPermissionRationale() zwraca wartość true.
Prośba o uprawnienia w kontekście
Gdy prosisz o zgodę na wyświetlanie powiadomień w aplikacji, rób to w odpowiednim kontekście, by jasno określić, do czego będą służyć powiadomienia i dlaczego użytkownik powinien wyrazić na to zgodę. Aplikacja do poczty e-mail może na przykład zawierać opcje wysyłania powiadomień o każdym nowym e-mailu lub tylko w przypadku tych e-maili, których użytkownik jest jedynym adresatem.
Wykorzystaj tę okazję, aby poinformować użytkowników o swoich intencjach. Dzięki temu łatwiej będzie im zezwolić na wysyłanie powiadomień przez Twoją aplikację.
Sprawdzanie, czy aplikacja może wysyłać powiadomienia
Zanim Twoja aplikacja wyśle powiadomienie, sprawdź, czy użytkownik włączył w niej powiadomienia. Aby to zrobić, wywołaj areNotificationsEnabled().
Odpowiedzialne korzystanie z uprawnień
Po otrzymaniu zgody na wysyłanie powiadomień pamiętaj, aby korzystać z tego uprawnienia w odpowiedzialny sposób. Użytkownicy mogą zobaczyć liczbę powiadomień wysyłanych codziennie przez Twoją aplikację oraz w każdej chwili mogą cofnąć uprawnienia.