Wymagania wstępne
Instalowanie lub aktualizowanie Android Studio do najnowszej wersji.
Sprawdź, czy Twój projekt spełnia te wymagania (pamiętaj, że niektóre usługi mogą mieć bardziej rygorystyczne wymagania):
- Docelowy poziom interfejsu API: 19 (KitKat) lub więcej
- ma Androida 4.4 lub nowszego,
- Zastosowania
Jetpack (AndroidX),
w tym:
com.android.tools.build:gradle
w wersji 7.3.0 lub nowszejcompileSdkVersion
28 lub nowsze
Skonfiguruj urządzenie fizyczne lub użyj emulator na uruchom aplikację.
Pamiętaj, że pakiety SDK Firebase zależą od Google Play usługi wymagają urządzenia lub emulatorowi, by mieć zainstalowane Usługi Google Play.Zaloguj się w Firebase, korzystając ze swojego konta Google koncie.
Jeśli nie masz jeszcze projektu na Androida, a chcesz tylko wypróbować Firebase możesz pobrać nasze krótkie wprowadzenia.
Swoją aplikację na Androida możesz połączyć z Firebase przy użyciu jednej z tych metod:
opcje:
- Opcja 1: (zalecana) Użyj Proces konfiguracji konsoli Firebase.
- Opcja 2. Użycie Firebase w Android Studio Asystent (może wymagać dodatkowej konfiguracji).
Opcja 1. Dodawanie Firebase za pomocą konsoli Firebase
Dodanie Firebase do aplikacji wymaga wykonywania zadań zarówno w konsoli Firebase, jak w otwartym projekcie Androida (np. pobierasz pliki konfiguracyjne Firebase, w konsoli, a następnie przenieś je do projektu Androida).
Krok 1. Utwórz projekt Firebase
Zanim dodasz Firebase do swojej aplikacji na Androida, musisz utworzyć taką aplikację do połączenia z aplikacją na Androida. Odwiedź Więcej informacji o projektach Firebase Projekty Firebase.
Krok 2. Zarejestruj aplikację w Firebase
Aby używać Firebase w swojej aplikacji na Androida, musisz ją zarejestrować w projekt Firebase. Rejestracja aplikacji często nazywa się „dodawaniem” aplikacji na w projektach AI.
Otwórz konsolę Firebase.
Na środku strony przeglądu projektu kliknij ikonę Androida. (
) lub Dodaj aplikację, aby rozpocząć proces konfiguracji.Wpisz nazwę pakietu aplikacji w polu Nazwa pakietu na Androida.
.(Opcjonalnie) Wpisz inne informacje o aplikacji: Nazwa aplikacji i Certyfikat podpisywania debugowania SHA-1.
Kliknij Zarejestruj aplikację.
Krok 3. Dodaj plik konfiguracji Firebase
Pobierz i dodaj plik konfiguracji Firebase na Androida (
) do Twojej aplikacji:google-services.json Kliknij Pobierz google-services.json, aby uzyskać Firebase na Androida. .
Przenieś plik konfiguracyjny do katalogu głównego module (poziom aplikacji) serwera do aplikacji.
Aby udostępnić wartości w pliku konfiguracyjnym
do pakietów SDK Firebase, Wtyczka Gradle usług Google (google-services.json google-services
).w pliku Gradle na poziomie głównym (na poziomie projektu); (
<project>/build.gradle.kts
lub<project>/build.gradle
), dodaj Wtyczka 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.2" 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.2' 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 pakiety SDK Firebase do aplikacji
w pliku Gradle (na poziomie aplikacji) modułu, (zwykle
<project>/<app-module>/build.gradle.kts
lub<project>/<app-module>/build.gradle
), dodaj zależności dla argumentu Usługi Firebase których chcesz użyć w aplikacji. Zalecamy użycie metody Firebase Android BoM do sterowania obsługi wersji biblioteki.Analityka włączona
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // 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") }
Za pomocą Firebase Android BoM, Twoja aplikacja zawsze będzie używać zgodnych wersji Firebase na Androida biblioteki.
Szukasz modułu biblioteki korzystającego z usługi Kotlin? Zaczyna się za Październik 2023 r. (Firebase BoM 32.5.0), programiści, zarówno w języku Kotlin, jak i w języku Java, zależą od modułu biblioteki głównej (więcej informacji znajdziesz w Najczęstsze pytania na temat tej inicjatywy).
Statystyki nie są włączone
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // 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") }
Za pomocą Firebase Android BoM, Twoja aplikacja zawsze będzie używać zgodnych wersji Firebase na Androida biblioteki.
Szukasz modułu biblioteki korzystającego z usługi Kotlin? Zaczyna się za Październik 2023 r. (Firebase BoM 32.5.0), programiści, zarówno w języku Kotlin, jak i w języku Java, zależą od modułu biblioteki głównej (więcej informacji znajdziesz w 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 sprawdzić polecane Dalsze kroki.
Jeśli jednak masz problemy z konfiguracją, odwiedź Rozwiązywanie problemów z Androidem Najczęstsze pytania.
Opcja 2. Dodawanie Firebase za pomocą Asystenta Firebase
Asystent Firebase zarejestruje się z projektem Firebase i doda niezbędne pliki, wtyczki Firebase i zależności od projektu na Androida – a wszystko to z poziomu Android Studio.
Otwórz projekt na Androida w Android Studio i sprawdź, czy za pomocą najnowszej 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ę i kliknij link samouczka (np.
Analytics > Zarejestruj zdarzenie Analytics ).Kliknij Połącz z Firebase, aby połączyć swój projekt na Androida z Firebase.
Kliknij przycisk, aby dodać odpowiednią usługę Firebase (na przykład
Dodaj Analytics do aplikacji ).
Zsynchronizuj aplikację, aby mieć pewność, że wszystkie zależności mają niezbędne wersje.
W panelu Asystent postępuj zgodnie z pozostałymi instrukcjami konfiguracji dotyczącymi wybranej usługi Firebase.
Możesz dodać dowolną liczbę innych usług Firebase za pomocą tej usługi. Asystent!
To wszystko. Pamiętaj, aby zapoznać się z zalecanymi Dalsze kroki.
Jeśli jednak masz problemy z konfiguracją, odwiedź Rozwiązywanie problemów z Androidem Najczęstsze pytania.
Dostępne biblioteki
W tej sekcji znajdziesz listę usług Firebase obsługiwanych na Androidzie oraz powiązanych z nimi usług Gradle zależności. Dowiedz się więcej o tych bibliotekach Firebase na Androida:
Dokumentacja źródłowa (Kotlin+KTX | Java)
Pakiet SDK Firebase na Androida Repozytorium GitHub
Pamiętaj, że podczas korzystania z BoM Firebase Android BoM, przy deklarowaniu biblioteki Firebase nie określasz poszczególnych wersji bibliotek. zależności w pliku konfiguracji kompilacji Gradle.
Usługa lub produkt | Zależność Gradle | Najnowsza wersja |
Dodać Analytics? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
BoM Firebase na Androida (lista materiałów) |
com.google.firebase:firebase-bom
Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase na Androida. Informacje o wersjach biblioteki są zmapowane na konkretną wersję BoM, zapoznaj się z informacjami o wersji dla danej wersji BoM. |
33.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 23.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Analytics | com.google.firebase:firebase-analytics | 22.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 usługi Sprawdzania integralności aplikacji w Play Integrity | com.google.firebase:firebase-appcheck-playintegrity | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Rozpowszechnianie aplikacji | com.google.firebase:firebase-appdistribution | 16.0.0-beta13 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta13 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wtyczka App Distribution | com.google.firebase:firebase-appdistribution-gradle | 5.0.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.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Storage | com.google.firebase:firebase-storage | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics | com.google.firebase:firebase-crashlytics | 19.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 19.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wtyczka Crahlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.1.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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Monitorowanie wydajności | com.google.firebase:firebase-perf | 21.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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-beta03 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wtyczka Usług Google Play | com.google.gms:google-services | 4.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BIBLIOTEKI WYCOFANE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Dostawca SafetyNet do Sprawdzania aplikacji | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Indeksowanie aplikacji | com.google.firebase:firebase-appindexing | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Moduły Firebase KTX
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Biblioteki Firebase ML Kit
|
Dalsze kroki
Dodaj usługi Firebase do aplikacji:
Uzyskuj statystyki dotyczące zachowań użytkowników za pomocą Statystyki.
Skonfiguruj proces uwierzytelniania użytkowników za pomocą Authentication (Uwierzytelnianie).
Przechowuj dane, takie jak informacje o użytkownikach, w Cloud Firestore lub Baza danych czasu rzeczywistego.
Przechowuj pliki, np. zdjęcia i filmy, w: Cloud Storage
Aktywuj kod backendu, który działa w bezpiecznym środowisku za pomocą Cloud Functions.
Wysyłaj powiadomienia przez Komunikacja w chmurze.
Dowiedz się, kiedy i dlaczego występują awarie aplikacji Crashlytics.
Więcej informacji o Firebase:
Więcej informacji znajdziesz w artykule Omówienie projektów Firebase. o projektach Firebase i sprawdzonych metodach związanych z projektami.
Odwiedź Więcej informacji o Androidzie i Firebase, jeśli: masz pytania dotyczące zagadnień, które są nieznane lub specyficzne dla Firebase; Programowanie aplikacji na Androida.
Odkrywaj świat przykładowych aplikacji Firebase.
Zdobądź praktyczne doświadczenie dzięki Firebase na Androida Ćwiczenia z programowania.
Więcej informacji: Weekendowy kurs Firebase.
Przygotowanie do wprowadzenia aplikacji:
- Określ budżet alerty swojego projektu w konsoli Google Cloud.
- Monitorowanie korzystania i płatności panel w konsoli Firebase, aby uzyskać ogólny obraz i wielu usług Firebase.
- Zapoznaj się z listą kontrolną uruchamiania Firebase.
Masz problemy z Firebase i projektem na Androida? Odwiedź stronę Rozwiązywanie problemów z Androidem Najczęstsze pytania.