Wymagania wstępne
Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.
Upewnij się, że Twój projekt spełnia te wymagania (pamiętaj, że niektóre produkty mogą mieć bardziej rygorystyczne wymagania):
- kierować aplikację co najmniej na poziom API 21 (Lollipop);
- ma zainstalowanego Androida w wersji 5.0 lub nowszej,
- Korzysta z Jetpacka (AndroidX), który 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 z zależnością od Usług Google Play wymagają, aby na urządzeniu lub emulatorze były zainstalowane Usługi Google Play.Zaloguj się w Firebase, używając konta Google.
Jeśli nie masz jeszcze projektu na Androida i chcesz tylko wypróbować usługę Firebase, możesz pobrać jeden z naszych przykładowych projektów szybkiego startu.
Aplikację na Androida możesz połączyć z Firebase na jeden z tych sposobów:
- Opcja 1: (zalecana) użyj przepływu pracy konfiguracji konsoliFirebase.
- Opcja 2: użyj Asystenta Firebase w Android Studio (może wymagać dodatkowej konfiguracji).
Opcja 1: dodaj Firebase za pomocą Firebase konsoli
Dodanie Firebase do aplikacji wymaga wykonania czynności zarówno w Firebasekonsoli, jak i w otwartym projekcie na Androida (np. pobierasz z konsoli pliki konfiguracyjne Firebase, a potem przenosisz je 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 zarejestrować aplikację w projekcie Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.
Otwórz Firebasekonsolę.
W centrum strony „Opis” projektu kliknij ikonę Android lub Dodaj aplikację, aby uruchomić proces konfiguracji.
Wpisz nazwę pakietu aplikacji w polu Nazwa pakietu na Androida.
(Opcjonalnie) wpisz pseudonim aplikacji, czyli wewnętrzny identyfikator ułatwiający rozpoznawanie aplikacji, który jest widoczny tylko dla Ciebie w Firebase konsoli.
Kliknij Zarejestruj aplikację.
Krok 3. Dodaj plik konfiguracyjny Firebase
Pobierz, a następnie dodaj do bazy kodu plik konfiguracyjny Firebase aplikacji (
google-services.json Kliknij Pobierz google-services.json, aby uzyskać plik konfiguracyjny Firebase aplikacji.
Przenieś plik konfiguracyjny do głównego katalogu modułu (na poziomie aplikacji) aplikacji.
Aby wartości w pliku konfiguracyjnym
google-services.json google-services).W pliku Gradle na poziomie głównym (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.4" 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.4' 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 Firebase Android BoM do kontrolowania wersji bibliotek.Włączono: Analytics
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:34.4.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") }
Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.
Nie włączono Analytics
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:34.4.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") }
Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.
Po dodaniu zależności dla usług, których chcesz używać, zsynchronizuj projekt Androida z plikami Gradle.
To wszystko. Możesz przejść od razu do zalecanych kolejnych kroków.
Jeśli masz problemy z konfiguracją, zapoznaj się z rozwiązywaniem problemów z Androidem i najczęstszymi pytaniami.
Opcja 2: dodawanie Firebase za pomocą Asystenta Firebase
Asystent Firebase rejestruje Twoją aplikację w projekcie Firebase i dodaje do projektu na Androida niezbędne pliki, wtyczki i zależności Firebase – wszystko to w Android Studio.
Otwórz projekt na 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 > Rejestrowanie zdarzenia 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 wykonaj pozostałe instrukcje konfiguracji wybranej usługi Firebase.
Za pomocą Asystenta Firebase możesz dodać dowolną liczbę innych usług Firebase.
To wszystko. Zapoznaj się z zalecanymi dalszymi krokami.
Jeśli masz problemy z konfiguracją, zapoznaj się z rozwiązywaniem problemów z Androidem i najczęstszymi pytaniami.
Dostępne biblioteki
W tej sekcji znajdziesz listę usług Firebase obsługiwanych na Androidzie oraz ich zależności Gradle. Więcej informacji o tych bibliotekach Firebase na Androida:
Pakiet Firebase SDK na Androida Repozytorium GitHub
Pamiętaj, że gdy używasz Firebase Android BoM, nie musisz określać wersji poszczególnych bibliotek podczas deklarowania zależności bibliotek Firebase w pliku konfiguracji kompilacji Gradle.
| Usługa lub produkt | Zależność Gradle | Najnowsza wersja |
Dodać 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 wersji BoM. |
34.4.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AdMob | com.google.android.gms:play-services-ads | 24.7.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic 1 | com.google.firebase:firebase-ai | 17.4.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Analytics | com.google.firebase:firebase-analytics | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check niestandardowy dostawca | com.google.firebase:firebase-appcheck | 19.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check dostawca debugowania | com.google.firebase:firebase-appcheck-debug | 19.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check Dostawca Play Integrity | com.google.firebase:firebase-appcheck-playintegrity | 19.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta17 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta17 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution wtyczka | com.google.firebase:firebase-appdistribution-gradle | 5.1.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Authentication | com.google.firebase:firebase-auth | 24.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Firestore | com.google.firebase:firebase-firestore | 26.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 22.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Messaging | com.google.firebase:firebase-messaging | 25.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Storage | com.google.firebase:firebase-storage | 22.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics | com.google.firebase:firebase-crashlytics | 20.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 20.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics wtyczka | com.google.firebase:firebase-crashlytics-gradle | 3.0.6 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Data Connect | com.google.firebase:firebase-dataconnect | 17.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Obsługa modułów funkcji dynamicznych | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta04 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging | com.google.firebase:firebase-inappmessaging | 22.0.1 | (wymagane) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging Reklama displayowa | com.google.firebase:firebase-inappmessaging-display | 22.0.1 | (wymagane) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase instalacje | com.google.firebase:firebase-installations | 19.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader | 26.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring | com.google.firebase:firebase-perf | 22.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring wtyczka | com.google.firebase:perf-plugin | 2.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase Phone Number Verification | com.google.firebase:firebase-pnv | 16.0.0-beta01 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Realtime Database | com.google.firebase:firebase-database | 22.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Remote Config | com.google.firebase:firebase-config | 23.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Wtyczka usług Google Play | com.google.gms:google-services | 4.4.4 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| PRZESTARZAŁE LUB NIEWSPIERANE BIBLIOTEKI | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Indexing | com.google.firebase:firebase-appindexing | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dynamic Links | com.google.firebase:firebase-dynamic-links | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Moduły Firebase KTX – nie są już obsługiwane
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Biblioteki Firebase ML Kit
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1 Firebase AI Logic wcześniej nazywał się
„Vertex AI in Firebase” w pakiecie
com.google.firebase:firebase-vertexai.
Dalsze kroki
Dodaj do aplikacji usługi Firebase:
Twórz funkcje generatywnej AI za pomocą modeli Gemini i Imagen, korzystając z Firebase AI Logic.
Uzyskuj statystyki dotyczące zachowań użytkowników za pomocą Analytics.
Skonfiguruj proces uwierzytelniania użytkowników 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 usłudze Cloud Storage.
Uruchamiaj kod backendu, który działa w bezpiecznym środowisku, za pomocą Cloud Functions.
Wysyłaj powiadomienia za pomocą Cloud Messaging.
Dowiedz się, kiedy i dlaczego aplikacja ulega awarii, korzystając z Crashlytics.
Więcej informacji o Firebase:
Więcej informacji o projektach Firebase i sprawdzonych metodach dotyczących projektów znajdziesz w artykule Informacje o projektach Firebase.
Jeśli masz pytania dotyczące pojęć, które są Ci nieznane lub specyficzne dla Firebase i programowania na Androida, odwiedź stronę Więcej informacji o Androidzie i Firebase.
Przejrzyj przykładowe aplikacje Firebase.
Zdobądź praktyczne doświadczenie dzięki laboratorium Firebase na Androida.
Więcej informacji znajdziesz w kursie Firebase w jeden weekend.
Przygotuj się do uruchomienia aplikacji:
- Skonfiguruj alerty dotyczące budżetu w projekcie w konsoli Google Cloud.
- Monitoruj panel Wykorzystanie i rozliczenia w Firebase konsoli, aby uzyskać ogólny obraz wykorzystania usług Firebase w projekcie.
- Zapoznaj się z listą kontrolną dotyczącą uruchamiania Firebase.
Masz problemy z Firebase i projektem na Androida? Zapoznaj się z rozwiązywaniem problemów z Androidem i najczęstszymi pytaniami.