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 usługi mogą mieć bardziej rygorystyczne wymagania):
- jest kierowana na interfejs API na poziomie 24 (Nougat) lub wyższym;
- ma system Android 7.0 lub nowszy,
- używa Jetpacka (AndroidX), co obejmuje spełnienie tych wymagań dotyczących wersji:
com.android.tools.build:gradlew wersji 7.3.0 lub nowszejcompileSdkVersion28 lub nowsza wersja,
Skonfiguruj urządzenie fizyczne lub użyj emulatora, aby uruchomić aplikację.
Pamiętaj, że pakiety SDK Firebase zależne od Google Play services wymagają, aby na urządzeniu lub emulatorze była zainstalowana usługa Google Play services.
Jeśli nie masz jeszcze projektu aplikacji na Androida i chcesz tylko wypróbować usługę Firebase, możesz pobrać jeden z naszych przykładów z krótkiego przewodnika.
Możesz połączyć aplikację na Androida z Firebase, korzystając z jednej z tych opcji:
- Opcja 1. (zalecana) Użyj procesu konfiguracji konsoli Firebase.
- Opcja 2. Użyj asystenta Firebase w Android Studio (może wymagać dodatkowej konfiguracji).
Opcja 1. Dodaj Firebase za pomocą konsoli Firebase.
Dodanie Firebase do aplikacji wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie aplikacji na Androida (np. pobrania plików konfiguracji Firebase z konsoli, a następnie przeniesienia ich do projektu aplikacji na Androida).
Krok 1. Utwórz projekt w Firebase.
Zanim dodasz Firebase do aplikacji na Androida, musisz utworzyć projekt w Firebase, aby połączyć go z tą aplikacją. Aby dowiedzieć się więcej o projektach w Firebase, przeczytaj artykuł Informacje o projektach Firebase.
Krok 2. Zarejestruj aplikację w Firebase
Aby używać Firebase w aplikacji na Androida, musisz zarejestrować aplikację w projekcie w Firebase. Rejestrowanie aplikacji jest często nazywane „dodawaniem” aplikacji do projektu.
Otwórz konsolę Firebase.
Na środku strony Przegląd projektu kliknij ikonę Androida () lub Dodaj aplikację, aby uruchomić proces konfiguracji.
Wpisz nazwę pakietu aplikacji w polu Nazwa pakietu na Androida.
(Opcjonalnie) Wpisz pseudonim aplikacji, który jest wewnętrznym, wygodnym identyfikatorem widocznym tylko dla Ciebie w konsoli Firebase.
Kliknij Zarejestruj aplikację.
Krok 3. Dodaj plik konfiguracji Firebase
Pobierz plik konfiguracji Firebase aplikacji (
), a następnie dodaj go do bazy kodu:google-services.json Kliknij Pobierz google-services.json, aby uzyskać plik konfiguracji Firebase aplikacji.
Przenieś plik konfiguracyjny do katalogu głównego modułu (na poziomie aplikacji).
Aby wartości w pliku konfiguracji
były dostępne dla pakietów SDK Firebase, potrzebujesz wtyczki Gradle usług Google (google-services.json ).google-services W pliku Gradle na poziomie głównym (poziomie projektu) (
<project>/build.gradle.ktslub<project>/build.gradle) dodaj wtyczkę Gradle 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.6.0" 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.6.0' apply false }
W pliku Gradle na poziomie modułu (aplikacji) (zwykle
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle) dodaj wtyczkę Gradle 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) (zwykle
<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. Do kontrolowania wersji biblioteki zalecamy używanie Firebase Android BoM.Model Analytics został włączony
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:35.2.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:35.2.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 aplikacji na Androida z plikami Gradle.
To wszystko. Możesz przejść do zalecanych kolejnych kroków.
Jeśli masz problemy z konfiguracją, zapoznaj się z najczęstszymi pytaniami i rozwiązaniami problemów na Androidzie.
Opcja 2. Dodaj Firebase za pomocą funkcji Firebase Assistant
Asystent Firebase rejestruje aplikację w projekcie Firebase i dodaje niezbędne pliki, wtyczki i zależności Firebase do projektu na Androida – wszystko to w Android Studio.
Otwórz projekt aplikacji na Androida w Android Studio, a następnie upewnij się, że używasz najnowszych wersji Android Studio i funkcji Firebase Assistant:
- Windows / Linux: Pomoc > Sprawdź dostępność aktualizacji
- macOS: Android Studio > Sprawdź aktualizacje
Otwórz funkcję Firebase Assistant: Narzędzia > Firebase.
W panelu Asystent wybierz usługę Firebase, którą chcesz dodać do aplikacji. Rozwiń jej sekcję, a następnie kliknij link do samouczka (np.
Analytics > Rejestruj zdarzenie Analytics ).Kliknij Connect to Firebase (Połącz z Firebase), aby połączyć projekt aplikacji na Androida z Firebase.
Kliknij przycisk, aby dodać usługę 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 pozostałymi instrukcjami konfiguracji wybranej usługi Firebase.
Dodaj dowolną liczbę innych usług Firebase za pomocą asystenta Firebase.
To wszystko. Zapoznaj się z zalecanymi dalszymi krokami.
Jeśli masz problemy z konfiguracją, zapoznaj się z najczęstszymi pytaniami i rozwiązaniami problemów na Androidzie.
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 SDK Firebase na Androida Repozytorium GitHub
Pamiętaj, że gdy używasz Firebase Android BoM, nie musisz określać poszczególnych wersji bibliotek, gdy deklarujesz 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 wszystkich bibliotek Firebase na Androida. Aby dowiedzieć się, które wersje biblioteki są mapowane na konkretną wersję BoM, zapoznaj się z informacjami o wersji BoM. |
35.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Wtyczka Gradle usług Google | com.google.gms:google-services | 4.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AdMob | com.google.android.gms:play-services-ads | 25.5.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic 1 | com.google.firebase:firebase-ai | 18.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic On-Device | com.google.firebase:firebase-ai-ondevice | 16.0.0-beta08 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI KSP | com.google.firebase:firebase-ai-ksp-processor | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Analytics | com.google.firebase:firebase-analytics | 24.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check niestandardowy dostawca | com.google.firebase:firebase-appcheck | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dostawca debugowania App Check | com.google.firebase:firebase-appcheck-debug | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dostawca Play Integrity App Check | com.google.firebase:firebase-appcheck-playintegrity | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dostawca reCAPTCHA App Check | com.google.firebase:firebase-appcheck-recaptcha | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta21 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta21 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Wtyczka App Distribution | com.google.firebase:firebase-appdistribution-gradle | 5.3.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Authentication | com.google.firebase:firebase-auth | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Firestore | com.google.firebase:firebase-firestore | 27.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Messaging | com.google.firebase:firebase-messaging | 26.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Storage | com.google.firebase:firebase-storage | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics | com.google.firebase:firebase-crashlytics | 21.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 21.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Wtyczka Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.8 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Obsługa modułów funkcji dynamicznych | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta05 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging | com.google.firebase:firebase-inappmessaging | 23.0.0 | (wymagane) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging – sieć reklamowa | com.google.firebase:firebase-inappmessaging-display | 23.0.0 | (wymagane) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase instalacje | com.google.firebase:firebase-installations | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring | com.google.firebase:firebase-perf | 23.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Wtyczka Performance Monitoring | com.google.firebase:perf-plugin | 2.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase Phone Number Verification | com.google.firebase:firebase-pnv | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Realtime Database | com.google.firebase:firebase-database | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Remote Config | com.google.firebase:firebase-config | 24.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| SQL Connect 2 | com.google.firebase:firebase-dataconnect | 18.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| WYCOFANE LUB NIEOBSŁUGIWANE BIBLIOTEKI | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dynamic Links | com.google.firebase:firebase-dynamic-links | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Moduły Firebase KTX – nie są już obsługiwane
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Biblioteki Firebase ML i Firebase ML Kit
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1 Firebase AI Logic wcześniej nosił nazwę „Vertex AI in Firebase” i był powiązany z pakietem com.google.firebase:firebase-vertexai.
2 Firebase SQL Connect wcześniej nosił nazwę „Firebase Data Connect”.
Dalsze kroki
Dodaj usługi Firebase do aplikacji:
Twórz funkcje oparte na generatywnej AI za pomocą modeli Gemini, korzystając z Firebase AI Logic.
Uzyskuj statystyki dotyczące zachowań użytkowników dzięki Analytics.
Skonfiguruj proces uwierzytelniania użytkowników za pomocą Authentication.
Przechowuj dane, takie jak informacje o użytkownikach, za pomocą Cloud Firestore lub Realtime Database.
Przechowuj pliki, takie jak zdjęcia i filmy, w Cloud Storage.
Uruchamiaj kod backendu 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 w 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 są specyficzne dla Firebase i programowania na Androida, przeczytaj artykuł Więcej informacji o Androidzie i Firebase.
Zapoznaj się z przykładowymi aplikacjami Firebase.
Zdobądź praktyczne doświadczenie dzięki ćwiczeniu z programowania Firebase na Androida.
Więcej informacji znajdziesz w kursie Firebase in a Weekend.
Przygotuj się do opublikowania aplikacji:
- Skonfiguruj alerty dotyczące budżetu dla projektu w konsoli Google Cloud.
- Monitoruj panel Korzystanie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase.
- Zapoznaj się z listą kontrolną dotyczącą uruchamiania Firebase.
Masz problemy z Firebase i projektem aplikacji na Androida? Zapoznaj się z najczęstszymi pytaniami i rozwiązaniami problemów z Androidem.