Aby skonfigurować klienta FCM w Flutterze, wykonaj te czynności.
Konfiguracja i wymagania związane z platformą
Niektóre z wymaganych czynności zależą od platformy, na której chcesz wyświetlać reklamy.
iOS+
Włączanie funkcji aplikacji w Xcode
Zanim aplikacja zacznie otrzymywać wiadomości, musisz włączyć powiadomienia push i tryb w tle w projekcie Xcode.
- Otwórz obszar roboczy projektu Xcode (
ios/Runner.xcworkspace
). - Włącz powiadomienia push.
- Włącz pobieranie w tle i powiadomienia zdalne w trybie działania w tle.
Przesyłanie klucza uwierzytelniania APNs
Zanim użyjesz FCM, prześlij certyfikat APNs do Firebase. Jeśli nie masz jeszcze certyfikatu APN, utwórz go w Apple Developer Member Center.
- W konsoli Firebase w projekcie kliknij ikonę koła zębatego, wybierz Ustawienia projektu, a potem kartę Cloud Messaging.
- Kliknij przycisk Prześlij certyfikat, aby przesłać certyfikat dewelopera, certyfikat produkcyjny lub oba. Wymagane jest zaznaczenie co najmniej 1 z tych pól.
- W przypadku każdego certyfikatu wybierz plik .p12 i podaj hasło (jeśli jest wymagane). Upewnij się, że identyfikator pakietu dla tego certyfikatu jest zgodny z identyfikatorem pakietu Twojej aplikacji. Kliknij Zapisz.
Podmiana metody
Aby używać wtyczki FCM Flutter na urządzeniach Apple, nie można wyłączyć metody mieszania. Swizlowanie jest wymagane, ponieważ bez niego kluczowe funkcje Firebase, takie jak obsługa tokena FCMS, nie działają prawidłowo.
Android
Usługi Google Play
Klienci FCM wymagają urządzeń z Androidem��4.4 lub nowszym, na których są też zainstalowane usługi Google Play, lub emulatora z Androidem 4.4 z interfejsami API Google. Pamiętaj, że nie musisz wdrażać aplikacji na Androida w Sklepie Google Play.
Aplikacje korzystające z usługi Play Services SDK powinny zawsze sprawdzać na urządzeniu, czy jest dostępny zgodny pakiet APK Usług Google Play, zanim uzyskają dostęp do funkcji Usług Google Play. Zalecamy wykonanie tego w 2 miejscach: w metodzie onCreate()
głównej aktywności oraz w metodzie onResume()
tej aktywności. Sprawdzanie w onCreate()
zapewnia, że aplikacji nie można użyć bez pomyślnego sprawdzenia. Kontrola w onResume()
zapewnia, że jeśli użytkownik wróci do uruchomionej aplikacji za pomocą innych środków, np. przycisku Wstecz, kontrola zostanie przeprowadzona.
Jeśli na urządzeniu nie ma zgodnej wersji Usług Google Play, aplikacja może wywołać GoogleApiAvailability.makeGooglePlayServicesAvailable()
, aby umożliwić użytkownikom pobranie Usług Google Play ze Sklepu Play.
Sieć
Konfigurowanie danych logowania do interfejsu internetowego w FCM
Interfejs internetowy FCM używa danych logowania do sieci, zwanych „identyfikatorami serwera aplikacji” lub kluczami „VAPID”, do autoryzowania wysyłania żądań do obsługiwanych usług przesyłania danych po sieci. Aby subskrybować powiadomienia push w aplikacji, musisz powiązać z projektem Firebase parę kluczy. Możesz wygenerować nową parę kluczy lub zaimportować istniejącą parę kluczy w konsoli Firebase.
Generowanie nowej pary kluczy
Otwórz kartę Cloud Messaging w panelu Ustawienia konsoli Firebase i przewiń do sekcji Konfiguracja internetowa.
Na karcie Certyfikaty Web Push kliknij Wygeneruj parę kluczy. Konsola wyświetli powiadomienie o wygenerowaniu pary kluczy oraz ciąg znaków klucza publicznego i dodaną datę.
Importowanie istniejącej pary kluczy
Jeśli masz parę kluczy, której używasz już w przypadku aplikacji internetowej, możesz ją zaimportować do FCM, aby uzyskać dostęp do istniejących instancji aplikacji internetowej za pomocą interfejsów FCM. Aby zaimportować klucze, musisz mieć dostęp na poziomie właściciela do projektu Firebase. Zaimportuj istniejący klucz publiczny i prywatny w formacie zakodowanym w standardzie base64 do bezpiecznego adresu URL:
Otwórz kartę Cloud Messaging w panelu Ustawienia konsoli Firebase i przewiń do sekcji Konfiguracja internetowa.
Na karcie Certyfikaty Web Push odszukaj i kliknij tekst linku „Importuj istniejący klucz publiczny i prywatny”.
W oknie Importuj parę kluczy podaj klucze publiczny i prywatny w odpowiednich polach i kliknij Importuj. W konsoli wyświetlany jest ciąg znaków klucza publicznego i data dodania.
Więcej informacji o formacie kluczy i sposobie ich generowania znajdziesz w artykule Klucze serwera aplikacji.
Instalowanie wtyczki FCM
Zainstaluj i inicjuj wtyczki Firebase dla Fluttera (jeśli nie zostało to jeszcze zrobione).
Aby zainstalować w katalogu głównym projektu Flutter wtyczkę, uruchom to polecenie:
flutter pub add firebase_messaging
Po zakończeniu ponownie skompiluj aplikację Flutter:
flutter run
Dostęp do tokena rejestracji
Aby wysłać wiadomość na konkretne urządzenie, musisz znać jego token rejestracji. Aby ukończyć ten samouczek, musisz wpisać token w polu w konsoli powiadomień. Po pobraniu tokena skopiuj go lub zapisz w bezpiecznym miejscu.
Aby pobrać bieżący token rejestracji dla instancji aplikacji, wywołaj funkcję getToken()
. Jeśli użytkownik nie przyznał uprawnień do wyświetlania powiadomień, ta metoda poprosi go o takie uprawnienia. W przeciwnym razie zwraca token lub odrzuca przyszłość z powodu błędu.
// You may set the permission requests to "provisional" which allows the user to choose what type
// of notifications they would like to receive once the user receives a notification.
final notificationSettings = await FirebaseMessaging.instance.requestPermission(provisional: true);
// For apple platforms, ensure the APNS token is available before making any FCM plugin API calls
final apnsToken = await FirebaseMessaging.instance.getAPNSToken();
if (apnsToken != null) {
// APNS token is available, make FCM plugin API requests...
}
Na platformach internetowych prześlij klucz publiczny VAPID do:getToken()
final fcmToken = await FirebaseMessaging.instance.getToken(vapidKey: "BKagOny0KF_2pCJQ3m....moL0ewzQ8rZu");
Aby otrzymywać powiadomienia o aktualizacjach tokena, zasubskrybuj strumień onTokenRefresh
:
FirebaseMessaging.instance.onTokenRefresh
.listen((fcmToken) {
// TODO: If necessary send token to application server.
// Note: This callback is fired at each app startup and whenever a new
// token is generated.
})
.onError((err) {
// Error getting token.
});
Zapobieganie automatycznej inicjalizacji
Gdy wygenerowany zostanie token rejestracji FCM, biblioteka prześle identyfikator i dane konfiguracji do Firebase. Jeśli chcesz zapobiec automatycznemu generowaniu tokenów, wyłącz automatyczną inicjalizację w czasie kompilacji.
iOS
Na urządzeniu z iOS dodaj wartość metadanych do Info.plist
:
FirebaseMessagingAutoInitEnabled = NO
Android
Na Androidzie wyłącz zbieranie danych w Analytics i automatyczną inicjalizację FCM (musisz wyłączyć obie te opcje), dodając te wartości metadanych do pliku AndroidManifest.xml
:
<meta-data
android:name="firebase_messaging_auto_init_enabled"
android:value="false" />
<meta-data
android:name="firebase_analytics_collection_enabled"
android:value="false" />
Ponownie włącz automatyczne inicjowanie FCM w środowisku wykonawczym
Aby włączyć automatyczne inicjowanie w przypadku konkretnego wystąpienia aplikacji, wywołaj funkcję setAutoInitEnabled()
:
await FirebaseMessaging.instance.setAutoInitEnabled(true);
Po ustawieniu ta wartość jest zachowywana po ponownym uruchomieniu aplikacji.
Dalsze kroki
Po skonfigurowaniu aplikacji klienckiej możesz zacząć wysyłać wiadomości do użytkowników za pomocą edytora powiadomień. Zobacz Wysyłanie wiadomości testowej do aplikacji działającej w tle.
Aby dodać do aplikacji inne, bardziej zaawansowane funkcje, musisz użyć implementacji na serwerze.
Następnie w kliencie aplikacji: