Wymagania wstępne
Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.
Upewnij się, że Twój projekt spełnia te wymagania (zauważ, że niektóre produkty mogą mieć bardziej rygorystyczne wymagania):
- kierowana na poziom API 21 (Lollipop) lub wyższy;
- Urządzenie z Androidem w wersji 5.0 lub nowszej.
- Używa Jetpacka (AndroidX), który musi spełniać te wymagania dotyczące wersji:
com.android.tools.build:gradlew wersji 7.3.0 lub nowszejcompileSdkVersion28 lub nowsza
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ą zainstalowania usług Google Play na urządzeniu lub w emulatorze.Zaloguj się w Firebase, używając konta Google.
Jeśli nie masz jeszcze projektu na Androida i chcesz wypróbować usługę Firebase, możesz pobrać jeden z naszych sampli szybkiego startu.
Aplikację na Androida możesz połączyć z Firebase, korzystając z jednego z tych sposobów:
- Opcja 1: (zalecane) użyj przepływu pracy konfiguracji konsoli Firebase.
- Opcja 2: użyj Asystenta Firebase w Android Studio (może wymagać dodatkowej konfiguracji).
Opcja 1: dodaj Firebase w konsoli Firebase
Dodanie Firebase do aplikacji wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie na Androida (np. pobieranie plików konfiguracji Firebase z konsoli i przenoszenie ich do projektu na Androida).
Krok 1. Utwórz projekt Firebase
Zanim dodasz Firebase do aplikacji na Androida, musisz utworzyć projekt Firebase, aby połączyć go z tą aplikacją. Więcej informacji o projektach Firebase znajdziesz w artykule Informacje o projektach Firebase.
Krok 2. Zarejestruj aplikację w Firebase
Aby korzystać z Firebase w aplikacji na Androida, musisz ją zarejestrować w projekcie Firebase. Rejestrowanie aplikacji jest często nazywane „dodawaniem” aplikacji do projektu.
Otwórz konsolę Firebase.
W centrum strony „Opis” projektu kliknij ikonę Androida () lub Dodaj aplikację, aby uruchomić proces konfiguracji.
W polu Nazwa pakietu na Androida wpisz nazwę pakietu aplikacji.
(Opcjonalnie) Wpisz inne informacje o aplikacji: pseudonim aplikacji i certyfikat podpisywania debugowania SHA-1.
Kliknij Zarejestruj aplikację.
Krok 3. Dodaj plik konfiguracji Firebase
Pobierz plik konfiguracji Firebase (
google-services.json Kliknij Pobierz plik google-services.json, aby pobrać plik konfiguracji Firebase swojej aplikacji.
Przenieś plik konfiguracji do głównego katalogu modułu (poziom aplikacji).
Aby udostępnić wartości w pliku konfiguracyjnym
google-services.json google-services).W pliku Gradle na poziomie katalogu głównego (na poziomie projektu) (
<project>/build.gradle.ktslub<project>/build.gradle) dodaj wtyczkę usług Google jako zależność:Kotlin
plugins { id("com.android.application") version "7.3.0" apply false // ... // Add the dependency for the Google services Gradle plugin id("com.google.gms.google-services") version "4.4.3" apply false }
Groovy
plugins { id 'com.android.application' version '7.3.0' apply false // ... // Add the dependency for the Google services Gradle plugin id 'com.google.gms.google-services' version '4.4.3' apply false }
W pliku Gradle modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle) dodaj wtyczkę usług Google:Kotlin
plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
Groovy
plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' // ... }
Krok 4. Dodaj do aplikacji pakiety SDK Firebase
W pliku Gradle modułu (na poziomie aplikacji) (zazwyczaj
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle) dodaj zależności dla usług Firebase, których chcesz używać w aplikacji. Zalecamy używanie parametru Firebase Android BoM do kontrolowania wersji bibliotek.Włączono Analytics
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.16.0")) // When using the BoM, you don't specify versions in Firebase library dependencies // Add the dependency for the Firebase SDK for Google Analytics implementation("com.google.firebase:firebase-analytics") // TODO: Add the dependencies for any other Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation("com.google.firebase:firebase-auth") implementation("com.google.firebase:firebase-firestore") }
Dzięki użyciu Firebase Android BoMaplikacja zawsze będzie używać zgodnych wersji bibliotek Firebase na Androida.
Szukasz modułu biblioteki dla Kotlina? Od października 2023 r. (Firebase BoM 32.5.0) deweloperzy Kotlina i Java mogą korzystać z głównego modułu biblioteki (szczegółowe informacje znajdziesz w często zadawanych pytaniach dotyczących tej inicjatywy).
Analytics nie jest włączona
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.16.0")) // When using the BoM, you don't specify versions in Firebase library dependencies // TODO: Add the dependencies for Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation("com.google.firebase:firebase-auth") implementation("com.google.firebase:firebase-firestore") }
Dzięki użyciu Firebase Android BoMaplikacja zawsze będzie używać zgodnych wersji bibliotek Firebase na Androida.
Szukasz modułu biblioteki dla Kotlina? Od października 2023 r. (Firebase BoM 32.5.0) deweloperzy Kotlina i Java mogą korzystać z głównego modułu biblioteki (szczegółowe informacje znajdziesz w często zadawanych pytaniach dotyczących tej inicjatywy).
Po dodaniu zależności dla usług, których chcesz używać, zsynchronizuj projekt Androida z plikami Gradle.
To wszystko. Możesz pominąć ten krok i sprawdzić zalecane kolejne kroki.
Jeśli jednak masz problem z konfiguracją, zapoznaj się z artykułem Rozwiązywanie problemów z Androidem i najczęstsze pytania.
Opcja 2. Dodaj Firebase za pomocą Asystenta Firebase.
Asystent Firebase rejestruje aplikację w projekcie Firebase i dodaje do projektu Androida niezbędne pliki, wtyczki i zależności Firebase – wszystko to w Android Studio.
Otwórz projekt Androida w Android Studio, a potem sprawdź, czy używasz najnowszych wersji Android Studio i Asystenta Firebase:
- Windows / Linux: Pomoc > Sprawdź dostępność aktualizacji
- macOS: Android Studio > Sprawdź dostępność aktualizacji
Otwórz Asystenta Firebase: Narzędzia > Firebase.
W panelu Asystent wybierz usługę Firebase, którą chcesz dodać do aplikacji. Rozwiń jej sekcję, a potem kliknij link do samouczka (np.
Analytics > Rejestruj zdarzenie Analytics ).Aby połączyć projekt na Androida z Firebase, kliknij Połącz z Firebase.
Kliknij przycisk, aby dodać wybrany produkt Firebase (np.
Dodaj Analytics do aplikacji ).
Zsynchronizuj aplikację, aby wszystkie zależności na pewno miały odpowiednie wersje.
W panelu Asystent postępuj zgodnie z instrukcjami dotyczącymi pozostałych ustawień wybranej usługi Firebase.
Za pomocą Asystenta Firebase możesz dodawać dowolną liczbę innych usług Firebase.
To wszystko. Zapoznaj się z zalecanymi dalszymi czynnościami.
Jeśli jednak masz problem z konfiguracją, zapoznaj się z artykułem Rozwiązywanie problemów z Androidem i najczęstsze pytania.
Dostępne biblioteki
W tej sekcji znajdziesz listę usług Firebase obsługiwanych na Androidzie oraz ich zależności Gradle. Dowiedz się więcej o tych bibliotekach Firebase na Androida:
Pakiet SDK Firebase na Androida Repozytorium GitHub
Pamiętaj, że w przypadku wersji Firebase Android BoM nie musisz określać wersji poszczególnych bibliotek podczas deklarowania zależności od bibliotek Firebase w pliku konfiguracji kompilacji Gradle.
| Usługa lub produkt | Zależność Gradle | Najnowsza wersja |
Dodaj Analytics? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Firebase Android BoM (Bill of Materials) |
com.google.firebase:firebase-bom
Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase na Androida. Aby dowiedzieć się, które wersje biblioteki są mapowane na konkretną wersję BoM, zapoznaj się z informacjami o tej wersji BoM. |
33.16.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AdMob | com.google.android.gms:play-services-ads | 24.4.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic 1 | com.google.firebase:firebase-ai | 16.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Analytics | com.google.firebase:firebase-analytics | 22.5.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check dostawca niestandardowego | com.google.firebase:firebase-appcheck | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check dostawca debugowania | com.google.firebase:firebase-appcheck-debug | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check Usługodawca Play Integrity | com.google.firebase:firebase-appcheck-playintegrity | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta15 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta15 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distributionwtyczka | com.google.firebase:firebase-appdistribution-gradle | 5.1.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Authentication | com.google.firebase:firebase-auth | 23.2.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Firestore | com.google.firebase:firebase-firestore | 25.1.4 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 21.2.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Messaging | com.google.firebase:firebase-messaging | 24.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Storage | com.google.firebase:firebase-storage | 21.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics | com.google.firebase:firebase-crashlytics | 19.4.4 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 19.4.4 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlyticswtyczka | com.google.firebase:firebase-crashlytics-gradle | 3.0.4 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Data Connect | com.google.firebase:firebase-dataconnect | 16.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Obsługa modułów funkcji dynamicznych | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta03 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dynamic Links | com.google.firebase:firebase-dynamic-links | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging | com.google.firebase:firebase-inappmessaging | 21.0.2 | (wymagane) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging Wyświetlacz | com.google.firebase:firebase-inappmessaging-display | 21.0.2 | (wymagane) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase instalacji | com.google.firebase:firebase-installations | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader | 25.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring | com.google.firebase:firebase-perf | 21.0.5 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoringwtyczka | com.google.firebase:perf-plugin | 1.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Realtime Database | com.google.firebase:firebase-database | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Remote Config | com.google.firebase:firebase-config | 22.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| wtyczka usług Google Play, | com.google.gms:google-services | 4.4.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| WYCOFANE BIBLIOTEKI | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check Dostawca SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Indexing | com.google.firebase:firebase-appindexing | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Moduły KTX Firebase
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Biblioteki Firebase ML Kit
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1 Firebase AI Logic w pakiecie com.google.firebase:firebase-vertexai nazywał się wcześniej „Vertex AI in Firebase”.
Dalsze kroki
Aby dodać usługi Firebase do aplikacji:
Twórz funkcje generatywnej AI za pomocą modeli Gemini i Imagen za pomocą Firebase AI Logic.
Uzyskaj statystyki dotyczące zachowań użytkowników za pomocą Analytics.
Skonfiguruj proces uwierzytelniania użytkownika za pomocą Authentication.
Przechowuj dane, np. informacje o użytkownikach, za pomocą Cloud Firestore lub Realtime Database.
Przechowuj pliki, takie jak zdjęcia i filmy, w Cloud Storage.
Uruchom kod backendu, który działa w bezpiecznym środowisku z Cloud Functions.
Wysyłanie powiadomień za pomocą Cloud Messaging.
Dowiedz się, kiedy i dlaczego Twoja aplikacja ulega awarii, korzystając z funkcji Crashlytics.
Więcej informacji o Firebase:
Aby dowiedzieć się więcej o projektach Firebase i sprawdzonych metodach ich tworzenia, przeczytaj artykuł Projekty Firebase – informacje i porady.
Jeśli masz pytania o nieznane lub specyficzne dla Firebase i Androida zagadnienia, odwiedź stronę Więcej informacji o Androidzie i Firebase.
Zapoznaj się z przykładowymi aplikacjami Firebase.
Poznaj praktyczne zastosowania Firebase na Androida w Codelab.
Dowiedz się więcej z kursu Firebase w weekend.
Przygotuj się do uruchomienia aplikacji:
- W konsoli Google Cloud skonfiguruj alerty dotyczące budżetu dla swojego projektu.
- Aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase, monitoruj panel Dane i rozliczenia w konsoli Firebase.
- Przejrzyj listę kontrolną przed wdrożeniem Firebase.
Masz problemy z Firebase i projektem na Androida? Przeczytaj najczęstsze pytania i informacje o rozwiązywaniu problemów z Androidem.