Dodaj Firebase do swojego projektu na Androida

Warunki wstępne

• Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.

• Upewnij się, że Twój projekt spełnia te wymagania:

  • Targets API level 19 (KitKat) lub wyższy
  • Używa Androida 4.4 lub nowszego
  • Używa Jetpack (AndroidX) , który obejmuje spełnienie następujących wymagań wersji:
    • com.android.tools.build:gradle v3.2.1 lub nowszy
    • compileSdkVersion 28 lub nowszą

• 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ą, aby na urządzeniu lub emulatorze były zainstalowane usługi Google Play.

• Zaloguj się do Firebase przy użyciu swojego konta Google.

Jeśli nie masz jeszcze projektu na Androida, a chcesz tylko wypróbować produkt Firebase, możesz pobrać jeden z naszych krótkich przykładów .

Możesz połączyć swoją aplikację na Androida z Firebase, korzystając z jednej z następujących opcji:

• Opcja 1 : (zalecane) Użyj procedury konfiguracji konsoli Firebase.
• Opcja 2 : użyj Asystenta Firebase Android Studio (może wymagać dodatkowej konfiguracji).

Opcja 1 : Dodaj Firebase za pomocą konsoli Firebase

Dodanie Firebase do aplikacji obejmuje zadania zarówno w konsoli Firebase , jak i w otwartym projekcie Android (na przykład pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do projektu Android).

Krok 1 : utwórz projekt Firebase

Zanim dodasz Firebase do swojej aplikacji na Androida, musisz utworzyć projekt Firebase, aby połączyć się z aplikacją na Androida. Odwiedź Zrozumienie projektów Firebase , aby dowiedzieć się więcej o projektach Firebase.

Krok 2 : Zarejestruj swoją aplikację w Firebase

Aby korzystać z Firebase w aplikacji na Androida, musisz zarejestrować swoją aplikację w projekcie Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.

1. Przejdź do konsoli Firebase .

2. Na środku strony przeglądu projektu kliknij ikonę Androida ( plat_android ) lub Dodaj aplikację , aby uruchomić przepływ pracy instalacji.

3. Wpisz nazwę pakietu swojej aplikacji w polu Nazwa pakietu Androida .

   Jaka jest nazwa pakietu i gdzie ją znajdziesz?

   • Nazwa pakietu jednoznacznie identyfikuje Twoją aplikację na urządzeniu i w Sklepie Google Play.

   • Nazwa pakietu jest często określana jako identyfikator aplikacji .

   • Znajdź nazwę pakietu aplikacji w pliku Gradle modułu (na poziomie aplikacji), zwykle app/build.gradle (przykładowa nazwa pakietu: com.yourcompany.yourproject ).

   • Pamiętaj, że w wartości nazwy pakietu rozróżniana jest wielkość liter i nie można jej zmienić dla tej aplikacji Firebase na Androida po jej zarejestrowaniu w projekcie Firebase.

4. (Opcjonalnie) Podaj inne informacje o aplikacji: pseudonim aplikacji i certyfikat podpisywania debugowania SHA-1 .

   W jaki sposób pseudonim aplikacji i certyfikat podpisywania debugowania SHA-1 są używane w Firebase?

   • Pseudonim aplikacji : wewnętrzny, wygodny identyfikator, który jest widoczny tylko dla Ciebie w konsoli Firebase

   • Debuguj certyfikat podpisywania SHA-1 : Uwierzytelnianie Firebase (w przypadku korzystania z logowania Google lub logowania za pomocą numeru telefonu ) i Linki dynamiczne Firebase wymaga skrótu SHA-1 .

5. Kliknij Zarejestruj aplikację .

Krok 3 : Dodaj plik konfiguracyjny Firebase

1. Dodaj plik konfiguracyjny Firebase Android do swojej aplikacji:

   1. Kliknij Pobierz google-services.json, aby uzyskać plik konfiguracyjny Firebase Android ( google-services.json ).

   2. Przenieś plik konfiguracyjny do katalogu modułu (na poziomie aplikacji) swojej aplikacji.

   Co musisz wiedzieć o tym pliku konfiguracyjnym?

   • Plik konfiguracyjny Firebase zawiera unikalne, ale nie tajne identyfikatory Twojego projektu. Aby dowiedzieć się więcej o tym pliku konfiguracyjnym, odwiedź stronę Zrozumienie projektów Firebase .

   • W dowolnym momencie możesz ponownie pobrać plik konfiguracyjny Firebase .

   • Upewnij się, że nazwa pliku konfiguracyjnego nie zawiera dodatkowych znaków, takich jak (2) .

2. Aby włączyć produkty Firebase w swojej aplikacji, dodaj wtyczkę google-services do swoich plików Gradle.

   1. W pliku Gradle na poziomie głównym (na poziomie projektu) ( build.gradle ) dodaj reguły, aby uwzględnić wtyczkę Google Services Gradle. Sprawdź również, czy masz repozytorium Maven firmy Google.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.13'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      

   2. W pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle ) zastosuj wtyczkę Google Services Gradle:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

Krok 4. Dodaj pakiety SDK Firebase do swojej aplikacji

1. Za pomocą Firebase Android BoM zadeklaruj zależności produktów Firebase, których chcesz używać w swojej aplikacji. Zadeklaruj je w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle ).

   Analytics włączone

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:30.3.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics'
   
     // Declare the dependencies for any other desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth'
     implementation 'com.google.firebase:firebase-firestore'
   }
   

   Kotlin+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:30.3.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics-ktx'
   
     // Declare the dependencies for any other desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx'
     implementation 'com.google.firebase:firebase-firestore-ktx'
   }
   

   Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase Android.

   Analytics nie jest włączone

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:30.3.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependencies for the desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth'
     implementation 'com.google.firebase:firebase-firestore'
   }
   

   Kotlin+KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:30.3.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependencies for the desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx'
     implementation 'com.google.firebase:firebase-firestore-ktx'
   }
   

   Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase Android.

2. Zsynchronizuj swoją aplikację, aby upewnić się, że wszystkie zależności mają niezbędne wersje.

   Błąd kompilacji dotyczący obsługi niestandardowej wywołania i włączania usuwania cukru? Oto jak to naprawić.

   Kompilacje Gradle korzystające z wtyczki Android Gradle (AGP) w wersji 4.2 lub starszej wymagają włączenia obsługi języka Java 8. W przeciwnym razie podczas dodawania pakietu Firebase SDK w tych projektach na Androida kończy się niepowodzenie kompilacji.

   Aby naprawić ten błąd kompilacji, możesz skorzystać z jednej z dwóch opcji:

   • Dodaj wymienione compileOptions z komunikatu o błędzie do pliku build.gradle na poziomie aplikacji.
   • Zwiększ minSdkVersion dla projektu Androida do 26 lub więcej.

   Dowiedz się więcej o tym niepowodzeniu kompilacji w tym FAQ .

Otóż ​​to! Możesz przejść dalej, aby zapoznać się z zalecanymi kolejnymi krokami .

Jeśli jednak masz problemy z konfiguracją, odwiedź sekcję Rozwiązywanie problemów z Androidem i najczęstsze pytania .

Opcja 2 : Dodaj Firebase za pomocą Asystenta Firebase

Asystent Firebase rejestruje Twoją aplikację w projekcie Firebase i dodaje niezbędne pliki, wtyczki i zależności Firebase do Twojego projektu na Androida — wszystko z poziomu Android Studio!

1. Otwórz projekt na Androida w Android Studio, a następnie upewnij się, że korzystasz z najnowszych wersji Android Studio i Asystenta Firebase:

   • Windows / Linux: Pomoc > Sprawdź aktualizacje
   • macOS: Android Studio > Sprawdź aktualizacje

2. Otwórz Asystenta Firebase: Narzędzia > Firebase .

3. W okienku Asystent wybierz produkt Firebase, który chcesz dodać do swojej aplikacji. Rozwiń jego sekcję, a następnie kliknij link do samouczka (na przykład Analytics > Rejestruj zdarzenie Analytics ).

   1. Kliknij Połącz z Firebase , aby połączyć projekt Androida z Firebase.

      Co robi ten przepływ pracy?

      • Ten przepływ pracy automatycznie tworzy nową aplikację Firebase na Androida przy użyciu nazwy pakietu Twojej aplikacji . Nową aplikację Firebase na Androida możesz utworzyć w istniejącym lub nowym projekcie Firebase.

        Oto kilka wskazówek dotyczących konfigurowania projektu Firebase:

        • Zapoznaj się z naszymi sprawdzonymi metodami dodawania aplikacji do projektu Firebase, w tym z obsługą wielu wariantów.

        • Jeśli tworzysz nowy projekt, zdecydowanie zalecamy skonfigurowanie Google Analytics dla swojego projektu, co zapewni optymalne korzystanie z wielu produktów Firebase.

      • Ten przepływ pracy dodaje również plik konfiguracyjny systemu Android projektu Firebase ( google-services.json ) do katalogu modułu (na poziomie aplikacji) Twojej aplikacji.

   2. Kliknij przycisk, aby dodać żądany produkt Firebase (na przykład Dodaj Analytics do swojej aplikacji ).

4. Zsynchronizuj swoją aplikację, aby upewnić się, że wszystkie zależności mają niezbędne wersje.

5. W okienku Asystent postępuj zgodnie z pozostałymi instrukcjami konfiguracji wybranego produktu Firebase.

6. Dodaj tyle innych produktów Firebase, ile chcesz, za pomocą Asystenta Firebase!

Otóż ​​to! Sprawdź zalecane dalsze kroki .

Jeśli jednak masz problemy z konfiguracją, odwiedź sekcję Rozwiązywanie problemów z Androidem i najczęstsze pytania .

Dostępne biblioteki

W tej sekcji wymieniono produkty Firebase obsługiwane w systemie Android oraz ich zależności od Gradle. Dowiedz się więcej o tych bibliotekach Firebase na Androida:

• Dokumentacja referencyjna ( Java | Kotlin+KTX )

• Repozytorium GitHub pakietu Firebase Android SDK

Pamiętaj, że korzystając z Firebase Android BoM , nie określasz poszczególnych wersji bibliotek podczas deklarowania zależności biblioteki Firebase w build.gradle .

Następne kroki

Dodaj usługi Firebase do swojej aplikacji:

• Uzyskaj wgląd w zachowanie użytkowników dzięki Analytics .

• Skonfiguruj przepływ uwierzytelniania użytkownika za pomocą uwierzytelniania .

• Przechowuj dane, takie jak informacje o użytkownikach, w Cloud Firestore lub Bazie danych czasu rzeczywistego .

• Przechowuj pliki, takie jak zdjęcia i filmy, w Cloud Storage .

• Wyzwalaj kod backendu, który działa w bezpiecznym środowisku z Cloud Functions .

• Wysyłaj powiadomienia przez Cloud Messaging .

• Dowiedz się, kiedy i dlaczego Twoja aplikacja ulega awarii, korzystając z Crashlytics .

Dowiedz się więcej o Firebase:

• Odwiedź stronę Omówienie projektów Firebase , aby dowiedzieć się więcej o projektach Firebase i sprawdzonych metodach dotyczących projektów.

• Odwiedź stronę Dowiedz się więcej o Androidzie i Firebase , jeśli masz pytania dotyczące pojęć, które są nieznane lub specyficzne dla Firebase i programowania na Androida.

• Poznaj przykładowe aplikacje Firebase .

• Zdobądź praktyczne doświadczenie w Firebase Android Codelab .

• Dowiedz się więcej z Firebase podczas weekendowego kursu.

• Przygotuj się do uruchomienia aplikacji:

  • Skonfiguruj alerty budżetowe dla swojego projektu w Google Cloud Console.
  • Monitoruj panel użycia i rozliczeń w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
  • Zapoznaj się z listą kontrolną uruchamiania Firebase .

• Masz problem z Firebase i projektem na Androida? Odwiedź sekcję rozwiązywania problemów z Androidem i najczęstsze pytania .