Wymagania wstępne
Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.
Sprawdź, czy projekt spełnia te wymagania (pamiętaj, że niektóre usługi mogą mieć bardziej rygorystyczne wymagania):
- Jest kierowana na interfejs API na poziomie 19 (KitKat) lub wyższym
- Korzysta z Androida 4.4 lub nowszego
- Wykorzystuje pakiet Jetpack (AndroidX), który spełnia te wymagania dotyczące wersji:
com.android.tools.build:gradle
w wersji 7.3.0 lub nowszejcompileSdkVersion
w wersji 28 lub nowszej
Skonfiguruj urządzenie fizyczne lub użyj emulatora do uruchamiania aplikacji.
Pamiętaj, że pakiety SDK Firebase bazujące na usługach Google Playwymagają zainstalowania urządzenia lub usług Google Play.Zaloguj się w Firebase, korzystając ze swojego konta Google.
Jeśli nie masz jeszcze projektu na Androida i chcesz wypróbować usługę Firebase, możesz pobrać krótkie wprowadzenie.
Swoją aplikację na Androida możesz połączyć 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 obejmuje zadania wykonywane zarówno w konsoli Firebase, jak i w otwartym projekcie Androida (np. pobierasz z konsoli pliki konfiguracyjne Firebase, a potem przenosisz je do projektu Androida).
Krok 1. Utwórz projekt Firebase
Zanim dodasz Firebase do swojej aplikacji na Androida, musisz utworzyć projekt Firebase, który będzie połączony z tą aplikacją. Więcej informacji o projektach Firebase znajdziesz w artykule Omówienie projektów Firebase.
Krok 2. Zarejestruj aplikację w Firebase
Aby używać Firebase w swojej aplikacji na Androida, musisz ją zarejestrować w projekcie Firebase. Rejestracja aplikacji to często tzw. „dodanie” jej do projektu.
Otwórz konsolę Firebase.
Na środku strony przeglądu projektu kliknij ikonę Androida (
) lub Dodaj aplikację, aby uruchomić proces konfiguracji.Wpisz nazwę pakietu aplikacji w polu Nazwa pakietu na Androida.
(Opcjonalnie) Wpisz inne informacje o aplikacji: Nazwa aplikacji i Certyfikat debugowania SHA-1.
Kliknij Zarejestruj aplikację.
Krok 3. Dodaj plik konfiguracji Firebase
Pobierz, a następnie dodaj do aplikacji plik konfiguracyjny Firebase na Androida (
):google-services.json Kliknij Pobierz google-services.json, aby uzyskać plik konfiguracyjny Firebase na Androida.
Przenieś plik konfiguracyjny do katalogu głównego modułu (na poziomie aplikacji) aplikacji.
Aby wartości w pliku konfiguracyjnym
były dostępne dla pakietów SDK Firebase, potrzebujesz wtyczki do Gradle usług Google (google-services.json google-services
).W pliku Gradle głównym (na poziomie projektu) (
<project>/build.gradle.kts
lub<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.1" 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.1' apply false }
W pliku Gradle modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.kts
lub<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 na poziomie modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.kts
lub<project>/<app-module>/build.gradle
) dodaj zależności usług Firebase, których chcesz używać w aplikacji. Do kontrolowania obsługi wersji biblioteki zalecamy używanie BOM Firebase na poziomie aplikacji.Analityka włączona
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.0.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") }
Jeśli używasz BOM Firebase na Androida, Twoja aplikacja zawsze będzie używała zgodnych wersji bibliotek Firebase na Androida.
Szukasz modułu biblioteki specyficznego dla Kotlin? Od października 2023 r. (Firebase BoM w wersji 32.5.0) deweloperzy korzystający z Kotlin i Javy mogą korzystać z modułu biblioteki głównej (szczegółowe informacje znajdziesz w odpowiedziach na najczęstsze pytania na temat tej inicjatywy).
Usługa Analytics nie jest włączona
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.0.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") }
Jeśli używasz BOM Firebase na Androida, Twoja aplikacja zawsze będzie używała zgodnych wersji bibliotek Firebase na Androida.
Szukasz modułu biblioteki specyficznego dla Kotlin? Od października 2023 r. (Firebase BoM w wersji 32.5.0) deweloperzy korzystający z Kotlin i Javy mogą korzystać z modułu biblioteki głównej (szczegółowe informacje znajdziesz w odpowiedziach na najczęstsze pytania na temat tej inicjatywy).
Po dodaniu zależności usług, których chcesz używać, zsynchronizuj projekt na Androida z plikami Gradle.
To wszystko. Możesz przejść dalej i zapoznać się z zalecanymi dalszymi krokami.
Jeśli jednak masz problemy z konfiguracją, przeczytaj odpowiedzi na najczęstsze pytania i rozwiązywanie problemów z Androidem.
Opcja 2. Dodaj Firebase za pomocą Asystenta Firebase
Asystent Firebase rejestruje Twoją aplikację w projekcie Firebase i dodaje do tego projektu na Androida niezbędne pliki, wtyczki oraz zależności Firebase – wszystko to bezpośrednio w Android Studio.
Otwórz projekt na Androida w Android Studio i sprawdź, czy używasz najnowszych wersji Androida 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ń tę sekcję, a potem kliknij link do samouczka (np.
Analytics > Zarejestruj zdarzenie Analytics ).Kliknij Połącz z Firebase, aby połączyć z Firebase projekt na Androida.
Kliknij przycisk, aby dodać wybraną usługę Firebase (np.
Dodaj Analytics do aplikacji ).
Zsynchronizuj aplikację, aby upewnić się, że wszystkie zależności mają niezbędne wersje.
W panelu Asystent wykonaj pozostałe instrukcje konfiguracji dla 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 jednak masz problemy z konfiguracją, przeczytaj odpowiedzi na najczęstsze pytania i rozwiązywanie problemów z Androidem.
Dostępne biblioteki
W tej sekcji znajdziesz listę usług Firebase obsługiwanych na Androidzie oraz ich zależności w ramach Gradle. Dowiedz się więcej o tych bibliotekach Firebase na Androida:
Dokumentacja (Kotlin+KTX | Java)
Pakiet SDK Firebase na Androida Repozytorium GitHub
Pamiętaj, że w przypadku BOM Firebase na Androida nie określa się poszczególnych wersji biblioteki podczas deklarowania zależności biblioteki Firebase w pliku konfiguracji kompilacji Gradle.
Usługa lub produkt | Zależność Gradle | Najnowsza wersja |
Dodać statystyki? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
BOM Firebase na Androida (zbiór 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 biblioteki są zmapowane na konkretną wersję BoM, zapoznaj się z informacjami o tej wersji BoM. |
33,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 23.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Analytics | com.google.firebase:firebase-analytics | 22,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Niestandardowy dostawca Sprawdzania aplikacji | com.google.firebase:firebase-appcheck | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Dostawca debugowania Sprawdzania aplikacji | com.google.firebase:firebase-appcheck-debug | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Dostawca funkcji Integrity funkcji Sprawdzania aplikacji | com.google.firebase:firebase-appcheck-playintegrity | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Rozpowszechnianie aplikacji | com.google.firebase:firebase-appdistribution | 16.0.0-beta12 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta12 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wtyczka App Distribution | com.google.firebase:firebase-appdistribution-gradle | 5,0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uwierzytelnianie | com.google.firebase:firebase-auth | 23,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Firestore. | com.google.firebase:firebase-firestore | 25,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Pakiet SDK klienta Cloud Functions dla Firebase | com.google.firebase:firebase-functions | 21,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Komunikacja w chmurze | com.google.firebase:firebase-messaging | 24:0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Storage, | com.google.firebase:firebase-storage | 21,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics | com.google.firebase:firebase-crashlytics | 19.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 19.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wtyczka Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Obsługa modułu funkcji dynamicznych | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta03 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Linki dynamiczne | com.google.firebase:firebase-dynamic-links | 22,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wysyłanie wiadomości w aplikacji | com.google.firebase:firebase-inappmessaging | 21,0.0 | (wymagane) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wyświetlanie wiadomości w aplikacji | com.google.firebase:firebase-inappmessaging-display | 21,0.0 | (wymagane) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Instalacje Firebase | com.google.firebase:firebase-installations | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Interfejs Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader | 25,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Monitorowanie wydajności | com.google.firebase:firebase-perf | 21,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wtyczka do monitorowania wydajności | com.google.firebase:perf-plugin | 1.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Baza danych czasu rzeczywistego | com.google.firebase:firebase-database | 21,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Zdalna konfiguracja | com.google.firebase:firebase-config | 22,0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Vertex AI dla Firebase | com.google.firebase:firebase-vertexai | 16.0.0-beta01 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wtyczka Usług Google Play | com.google.gms:google-services | 4.4.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BIBLIOTEKI WYCOFANE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Dostawca usługi SafetyNet do Sprawdzania aplikacji | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Indeksowanie aplikacji | com.google.firebase:firebase-appindexing | 20:0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Moduły KTX Firebase
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Biblioteki Firebase ML Kit
|
Dalsze kroki
Dodaj usługi Firebase do aplikacji:
Uzyskuj statystyki o zachowaniach użytkowników w Analytics.
Skonfiguruj proces uwierzytelniania użytkowników za pomocą uwierzytelniania.
Dane, takie jak informacje o użytkowniku, możesz przechowywać w Cloud Firestore lub Bazie danych czasu rzeczywistego.
Możesz przechowywać pliki, takie jak zdjęcia i filmy, w Cloud Storage.
Aktywuj kod backendu, który działa w bezpiecznym środowisku za pomocą Cloud Functions.
Wysyłaj powiadomienia przy użyciu Komunikacji w chmurze.
Dzięki Crashlytics dowiesz się, kiedy i dlaczego Twoja aplikacja ulega awarii.
Więcej informacji o Firebase:
W sekcji Omówienie projektów Firebase znajdziesz więcej informacji o projektach Firebase i sprawdzonych metodach dotyczących projektów.
Jeśli masz pytania dotyczące pojęć, które nie są związane z Firebase i tworzeniem aplikacji na Androida, albo masz pytania o koncepcje, które nie są związane z Firebase i Androidem, zapoznaj się z informacjami o Androidzie i Firebase.
Poznaj przykładowe aplikacje Firebase.
Skorzystaj z ćwiczenia z programowania na Androida Firebase.
Więcej informacji znajdziesz w kursie Firebase w weekend.
Przygotuj się do wprowadzenia aplikacji na rynek:
- Skonfiguruj alerty dotyczące budżetu dla swojego projektu w konsoli Google Cloud.
- Monitoruj panel Wykorzystanie i płatności w konsoli Firebase, aby mieć ogólny obraz wykorzystania projektu w różnych usługach Firebase.
- Zapoznaj się z listą kontrolną uruchamiania Firebase.
Masz problemy z Firebase i projektem na Androida? Przeczytaj artykuł Rozwiązywanie problemów i najczęstsze pytania na temat Androida.