Warunki wstępne
Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.
Upewnij się, że Twój projekt spełnia te wymagania:
- Targets API level 19 (KitKat) lub wyższy
- Używa Androida 4.4 lub nowszego
- Używa Jetpack (AndroidX) , który obejmuje spełnienie następujących wymagań wersji:
-
com.android.tools.build:gradle
v3.2.1 lub nowszy -
compileSdkVersion
28 lub nowszą
-
Skonfiguruj urządzenie fizyczne lub użyj emulatora , aby uruchomić aplikację.
Pamiętaj, że pakiety SDK Firebase zależne od usług Google Play wymagają, aby na urządzeniu lub emulatorze były zainstalowane usługi Google Play.Zaloguj się do Firebase przy użyciu swojego konta Google.
Jeśli nie masz jeszcze projektu na Androida, a chcesz tylko wypróbować produkt Firebase, możesz pobrać jeden z naszych krótkich przykładów .
Możesz połączyć swoją aplikację na Androida z Firebase, korzystając z jednej z następujących opcji:
- Opcja 1 : (zalecane) Użyj procedury konfiguracji konsoli Firebase.
- Opcja 2 : użyj Asystenta Firebase Android Studio (może wymagać dodatkowej konfiguracji).
Opcja 1 : Dodaj Firebase za pomocą konsoli Firebase
Dodanie Firebase do aplikacji obejmuje zadania zarówno w konsoli Firebase , jak i w otwartym projekcie Android (na przykład pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do projektu Android).
Krok 1 : utwórz projekt Firebase
Zanim dodasz Firebase do swojej aplikacji na Androida, musisz utworzyć projekt Firebase, aby połączyć się z aplikacją na Androida. Odwiedź Zrozumienie projektów Firebase , aby dowiedzieć się więcej o projektach Firebase.
Krok 2 : Zarejestruj swoją aplikację w Firebase
Aby korzystać z Firebase w aplikacji na Androida, musisz zarejestrować swoją aplikację w projekcie Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.
Przejdź do konsoli Firebase .
Na środku strony przeglądu projektu kliknij ikonę Androida (
) lub Dodaj aplikację , aby uruchomić przepływ pracy instalacji.Wpisz nazwę pakietu swojej aplikacji w polu Nazwa pakietu Androida .
Nazwa pakietu jednoznacznie identyfikuje Twoją aplikację na urządzeniu i w Sklepie Google Play.
Nazwa pakietu jest często określana jako identyfikator aplikacji .
Znajdź nazwę pakietu aplikacji w pliku Gradle modułu (na poziomie aplikacji), zwykle
app/build.gradle
(przykładowa nazwa pakietu:com.yourcompany.yourproject
).Pamiętaj, że w wartości nazwy pakietu rozróżniana jest wielkość liter i nie można jej zmienić dla tej aplikacji Firebase na Androida po jej zarejestrowaniu w projekcie Firebase.
(Opcjonalnie) Podaj inne informacje o aplikacji: pseudonim aplikacji i certyfikat podpisywania debugowania SHA-1 .
Pseudonim aplikacji : wewnętrzny, wygodny identyfikator, który jest widoczny tylko dla Ciebie w konsoli Firebase
Debuguj certyfikat podpisywania SHA-1 : Uwierzytelnianie Firebase (w przypadku korzystania z logowania Google lub logowania za pomocą numeru telefonu ) i Linki dynamiczne Firebase wymaga skrótu SHA-1 .
Kliknij Zarejestruj aplikację .
Krok 3 : Dodaj plik konfiguracyjny Firebase
Dodaj plik konfiguracyjny Firebase Android do swojej aplikacji:
Kliknij Pobierz google-services.json, aby uzyskać plik konfiguracyjny Firebase Android (
).google-services.json Przenieś plik konfiguracyjny do katalogu modułu (na poziomie aplikacji) swojej aplikacji.
Plik konfiguracyjny Firebase zawiera unikalne, ale nie tajne identyfikatory Twojego projektu. Aby dowiedzieć się więcej o tym pliku konfiguracyjnym, odwiedź stronę Zrozumienie projektów Firebase .
W dowolnym momencie możesz ponownie pobrać plik konfiguracyjny Firebase .
Upewnij się, że nazwa pliku konfiguracyjnego nie zawiera dodatkowych znaków, takich jak
(2)
.
Aby włączyć produkty Firebase w swojej aplikacji, dodaj wtyczkę google-services do swoich plików Gradle.
W pliku Gradle na poziomie głównym (na poziomie projektu) (
build.gradle
) dodaj reguły, aby uwzględnić wtyczkę Google Services Gradle. Sprawdź również, czy masz repozytorium Maven firmy Google.buildscript { repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository } dependencies { // ... // Add the following line: classpath 'com.google.gms:google-services:4.3.13' // Google Services plugin } } allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }
W pliku Gradle modułu (na poziomie aplikacji) (zwykle
app/build.gradle
) zastosuj wtyczkę Google Services Gradle:apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
Krok 4. Dodaj pakiety SDK Firebase do swojej aplikacji
Za pomocą Firebase Android BoM zadeklaruj zależności produktów Firebase, których chcesz używać w swojej aplikacji. Zadeklaruj je w pliku Gradle modułu (na poziomie aplikacji) (zwykle
app/build.gradle
).Analytics włączone
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.3.1') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.3.1') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics-ktx' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase Android.
Analytics nie jest włączone
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.3.1') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.3.1') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase Android.
Zsynchronizuj swoją aplikację, aby upewnić się, że wszystkie zależności mają niezbędne wersje.
Kompilacje Gradle korzystające z wtyczki Android Gradle (AGP) w wersji 4.2 lub starszej wymagają włączenia obsługi języka Java 8. W przeciwnym razie podczas dodawania pakietu Firebase SDK w tych projektach na Androida kończy się niepowodzenie kompilacji.
Aby naprawić ten błąd kompilacji, możesz skorzystać z jednej z dwóch opcji:
- Dodaj wymienione
compileOptions
z komunikatu o błędzie do plikubuild.gradle
na poziomie aplikacji. - Zwiększ
minSdkVersion
dla projektu Androida do 26 lub więcej.
Dowiedz się więcej o tym niepowodzeniu kompilacji w tym FAQ .
- Dodaj wymienione
Otóż to! Możesz przejść dalej, aby zapoznać się z zalecanymi kolejnymi krokami .
Jeśli jednak masz problemy z konfiguracją, odwiedź sekcję Rozwiązywanie problemów z Androidem i najczęstsze pytania .
Opcja 2 : Dodaj Firebase za pomocą Asystenta Firebase
Asystent Firebase rejestruje Twoją aplikację w projekcie Firebase i dodaje niezbędne pliki, wtyczki i zależności Firebase do Twojego projektu na Androida — wszystko z poziomu Android Studio!
Otwórz projekt na Androida w Android Studio, a następnie upewnij się, że korzystasz z najnowszych wersji Android Studio i Asystenta Firebase:
- Windows / Linux: Pomoc > Sprawdź aktualizacje
- macOS: Android Studio > Sprawdź aktualizacje
Otwórz Asystenta Firebase: Narzędzia > Firebase .
W okienku Asystent wybierz produkt Firebase, który chcesz dodać do swojej aplikacji. Rozwiń jego sekcję, a następnie kliknij link do samouczka (na przykład
Analytics > Rejestruj zdarzenie Analytics ).Kliknij Połącz z Firebase , aby połączyć projekt Androida z Firebase.
Ten przepływ pracy automatycznie tworzy nową aplikację Firebase na Androida przy użyciu nazwy pakietu Twojej aplikacji . Nową aplikację Firebase na Androida możesz utworzyć w istniejącym lub nowym projekcie Firebase.
Oto kilka wskazówek dotyczących konfigurowania projektu Firebase:
Zapoznaj się z naszymi sprawdzonymi metodami dodawania aplikacji do projektu Firebase, w tym z obsługą wielu wariantów.
Jeśli tworzysz nowy projekt, zdecydowanie zalecamy skonfigurowanie Google Analytics dla swojego projektu, co zapewni optymalne korzystanie z wielu produktów Firebase.
Ten przepływ pracy dodaje również plik konfiguracyjny systemu Android projektu Firebase (
) do katalogu modułu (na poziomie aplikacji) Twojej aplikacji.google-services.json
Kliknij przycisk, aby dodać żądany produkt Firebase (na przykład
Dodaj Analytics do swojej aplikacji ).
Zsynchronizuj swoją aplikację, aby upewnić się, że wszystkie zależności mają niezbędne wersje.
W okienku Asystent postępuj zgodnie z pozostałymi instrukcjami konfiguracji wybranego produktu Firebase.
Dodaj tyle innych produktów Firebase, ile chcesz, za pomocą Asystenta Firebase!
Otóż to! Sprawdź zalecane dalsze kroki .
Jeśli jednak masz problemy z konfiguracją, odwiedź sekcję Rozwiązywanie problemów z Androidem i najczęstsze pytania .
Dostępne biblioteki
W tej sekcji wymieniono produkty Firebase obsługiwane w systemie Android oraz ich zależności od Gradle. Dowiedz się więcej o tych bibliotekach Firebase na Androida:
Dokumentacja referencyjna ( Java | Kotlin+KTX )
Repozytorium GitHub pakietu Firebase Android SDK
Pamiętaj, że korzystając z Firebase Android BoM , nie określasz poszczególnych wersji bibliotek podczas deklarowania zależności biblioteki Firebase w build.gradle
.
Java
Usługa lub produkt | Zależność Gradle | Najnowszy wersja | Dodać Analytics? |
---|---|---|---|
Firebase Android BoM (Zestawienie materiałów) | com.google.firebase:firebase-bom Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase na Androida. Aby dowiedzieć się, które wersje bibliotek są mapowane na konkretną wersję BoM, przejrzyj uwagi do wydania dla tej wersji BoM. | 30.3.1 | |
AdMob | com.google.android.gms:reklamy usług-play | 21.1.0 | |
Analityka | com.google.firebase:firebase-analytics | 21.1.0 | |
Niestandardowy dostawca sprawdzania aplikacji | com.google.firebase:firebase-appcheck | 16.0.0 | |
Dostawca debugowania sprawdzania aplikacji | com.google.firebase:firebase-appcheck-debug | 16.0.0 | |
Dostawca usługi App Check Play Integrity | com.google.firebase:firebase-appcheck-playintegrity | 16.0.0 | |
Dostawca App Check SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.0.0 | |
Dystrybucja aplikacji | com.google.firebase:firebase-appdistribution | 16.0.0-beta03 | |
API dystrybucji aplikacji | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta03 | |
Wtyczka do dystrybucji aplikacji | com.google.firebase:firebase-appdistribution-gradle | 3.0.3 | |
Uwierzytelnianie | com.google.firebase:firebase-auth | 21.0.7 | |
Cloud Firestore | com.google.firebase:firebase-firestore | 24.2.2 | |
Pakiet SDK Cloud Functions dla klienta Firebase | com.google.firebase:funkcje-firebase | 20.1.0 | |
Wiadomości w chmurze | com.google.firebase:wiadomości-firebase | 23.0.7 | |
Magazyn w chmurze | com.google.firebase:pamięć-firebase | 20.0.1 | |
Crashlytics | com.google.firebase:firebase-crashlytics | 18.2.12 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.2.12 | |
Wtyczka Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.1 | |
Obsługa modułu funkcji dynamicznych | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta02 | |
Dynamiczne linki | com.google.firebase:firebase-dynamic-links | 21.0.1 | |
Wiadomości w aplikacji | com.google.firebase:firebase-inappmessaging | 20.1.2 | (wymagany) |
Wyświetlanie wiadomości w aplikacji | com.google.firebase:firebase-inappmessaging-display | 20.1.2 | (wymagany) |
Instalacje Firebase | com.google.firebase:instalacje-firebase | 17.0.1 | |
Interfejs API Firebase ML Model Downloader | com.google.firebase:firebase-ml-modeldownloader | 24.0.4 | |
Monitoring wydajności | com.google.firebase:firebase-perf | 20.1.0 | |
Wtyczka do monitorowania wydajności | com.google.firebase:wtyczka perf | 1.4.1 | |
Baza danych czasu rzeczywistego | com.google.firebase:baza-danych-firebase | 20,0,5 | |
Zdalna konfiguracja | com.google.firebase:firebase-config | 21.1.1 | |
Wtyczka usług Google Play | com.google.gms:usługi-google | 4.3.13 | |
Przestarzałe biblioteki | |||
Indeksowanie aplikacji | com.google.firebase:firebase-appindexing | 20.0.0 | |
Interfejsy API modelu niestandardowego Firebase ML | com.google.firebase:firebase-ml-model-interpreter | 22.0.4 | |
Interfejsy API Firebase ML Vision | com.google.firebase:firebase-ml-wizja | 24.1.0 | |
Firebase ML: model etykietowania obrazów | com.google.firebase:firebase-ml-vision-image-label-model | 20.0.2 | |
Firebase ML: model wykrywania i śledzenia obiektów | com.google.firebase:firebase-ml-vision-model-wykrywania-obiektu | 19.0.6 | |
Firebase ML: model wykrywania twarzy | com.google.firebase:firebase-ml-vision-model-twarzy | 20.0.2 | |
Firebase ML: model skanowania kodów kreskowych | com.google.firebase:firebase-ml-vision-barcode-model | 16.1.2 | |
Firebase ML: interfejs API AutoML Vision Edge | com.google.firebase:firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: interfejsy API języka naturalnego | com.google.firebase:firebase-ml-język-naturalny | 22.0.1 | |
Firebase ML: model identyfikacji języka | com.google.firebase:firebase-ml-model-identyfikatora-języka-naturalnego | 20.0.8 | |
Firebase ML: tłumaczenie modelu | com.google.firebase:firebase-ml-natural-language-translate-model | 20.0.9 | |
Firebase ML: model inteligentnej odpowiedzi | com.google.firebase:firebase-ml-natural-język-inteligentna-odpowiedź-model | 20.0.8 |
Kotlin+KTX
Usługa lub produkt | Zależność Gradle | Najnowszy wersja | Dodać Analytics? |
---|---|---|---|
Firebase Android BoM (Zestawienie materiałów) | com.google.firebase:firebase-bom Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase na Androida. Aby dowiedzieć się, które wersje bibliotek są mapowane na konkretną wersję BoM, przejrzyj uwagi do wydania dla tej wersji BoM. | 30.3.1 | |
AdMob | com.google.android.gms:reklamy usług-play | 21.1.0 | |
Analityka | com.google.firebase:firebase-analytics-ktx | 21.1.0 | |
Niestandardowy dostawca sprawdzania aplikacji | com.google.firebase:firebase-appcheck | 16.0.0 | |
Dostawca debugowania sprawdzania aplikacji | com.google.firebase:firebase-appcheck-debug | 16.0.0 | |
Dostawca App Check SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.0.0 | |
API dystrybucji aplikacji | com.google.firebase:firebase-appdistribution-api-ktx | 16.0.0-beta03 | |
Wtyczka do dystrybucji aplikacji | com.google.firebase:firebase-appdistribution-gradle | 3.0.3 | |
Uwierzytelnianie | com.google.firebase:firebase-auth-ktx | 21.0.7 | |
Cloud Firestore | com.google.firebase:firebase-firestore-ktx | 24.2.2 | |
Pakiet SDK Cloud Functions dla klienta Firebase | com.google.firebase:funkcje-firebase-ktx | 20.1.0 | |
Wiadomości w chmurze | com.google.firebase:firebase-messaging-ktx | 23.0.7 | |
Magazyn w chmurze | com.google.firebase:firebase-storage-ktx | 20.0.1 | |
Crashlytics | com.google.firebase:firebase-crashlytics-ktx | 18.2.12 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.2.12 | |
Wtyczka Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.1 | |
Obsługa modułu funkcji dynamicznych | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta02 | |
Dynamiczne linki | com.google.firebase:firebase-dynamic-links-ktx | 21.0.1 | |
Wiadomości w aplikacji | com.google.firebase:firebase-inappmessaging-ktx | 20.1.2 | (wymagany) |
Wyświetlanie wiadomości w aplikacji | com.google.firebase:firebase-inappmessaging-display-ktx | 20.1.2 | (wymagany) |
Instalacje Firebase | com.google.firebase:firebase-instalacje-ktx | 17.0.1 | |
Interfejs API Firebase ML Model Downloader | com.google.firebase:firebase-ml-modeldownloader-ktx | 24.0.4 | |
Monitoring wydajności | com.google.firebase:firebase-perf-ktx | 20.1.0 | |
Wtyczka do monitorowania wydajności | com.google.firebase:wtyczka perf | 1.4.1 | |
Baza danych czasu rzeczywistego | com.google.firebase:firebase-database-ktx | 20,0,5 | |
Zdalna konfiguracja | com.google.firebase:firebase-config-ktx | 21.1.1 | |
Wtyczka usług Google Play | com.google.gms:usługi-google | 4.3.13 | |
Przestarzałe biblioteki | |||
Indeksowanie aplikacji | com.google.firebase:firebase-appindexing | 20.0.0 | |
Interfejsy API modelu niestandardowego Firebase ML | com.google.firebase:firebase-ml-model-interpreter | 22.0.4 | |
Interfejsy API Firebase ML Vision | com.google.firebase:firebase-ml-wizja | 24.1.0 | |
Firebase ML: model etykietowania obrazów | com.google.firebase:firebase-ml-vision-image-label-model | 20.0.2 | |
Firebase ML: model wykrywania i śledzenia obiektów | com.google.firebase:firebase-ml-vision-model-wykrywania-obiektu | 19.0.6 | |
Firebase ML: model wykrywania twarzy | com.google.firebase:firebase-ml-vision-model-twarzy | 20.0.2 | |
Firebase ML: model skanowania kodów kreskowych | com.google.firebase:firebase-ml-vision-barcode-model | 16.1.2 | |
Firebase ML: interfejs API AutoML Vision Edge | com.google.firebase:firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: interfejsy API języka naturalnego | com.google.firebase:firebase-ml-język-naturalny | 22.0.1 | |
Firebase ML: model identyfikacji języka | com.google.firebase:firebase-ml-model-identyfikatora-języka-naturalnego | 20.0.8 | |
Firebase ML: tłumaczenie modelu | com.google.firebase:firebase-ml-natural-language-translate-model | 20.0.9 | |
Firebase ML: model inteligentnej odpowiedzi | com.google.firebase:firebase-ml-natural-język-inteligentna-odpowiedź-model | 20.0.8 |
Następne kroki
Dodaj usługi Firebase do swojej aplikacji:
Uzyskaj wgląd w zachowanie użytkowników dzięki Analytics .
Skonfiguruj przepływ uwierzytelniania użytkownika za pomocą uwierzytelniania .
Przechowuj dane, takie jak informacje o użytkownikach, w Cloud Firestore lub Bazie danych czasu rzeczywistego .
Przechowuj pliki, takie jak zdjęcia i filmy, w Cloud Storage .
Wyzwalaj kod backendu, który działa w bezpiecznym środowisku z Cloud Functions .
Wysyłaj powiadomienia przez Cloud Messaging .
Dowiedz się, kiedy i dlaczego Twoja aplikacja ulega awarii, korzystając z Crashlytics .
Dowiedz się więcej o Firebase:
Odwiedź stronę Omówienie projektów Firebase , aby dowiedzieć się więcej o projektach Firebase i sprawdzonych metodach dotyczących projektów.
Odwiedź stronę Dowiedz się więcej o Androidzie i Firebase , jeśli masz pytania dotyczące pojęć, które są nieznane lub specyficzne dla Firebase i programowania na Androida.
Poznaj przykładowe aplikacje Firebase .
Zdobądź praktyczne doświadczenie w Firebase Android Codelab .
Dowiedz się więcej z Firebase podczas weekendowego kursu.
Przygotuj się do uruchomienia aplikacji:
- Skonfiguruj alerty budżetowe dla swojego projektu w Google Cloud Console.
- Monitoruj panel użycia i rozliczeń w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
- Zapoznaj się z listą kontrolną uruchamiania Firebase .
Masz problem z Firebase i projektem na Androida? Odwiedź sekcję rozwiązywania problemów z Androidem i najczęstsze pytania .