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 następujące wymagania:

  • Docelowy poziom API 19 (KitKat) lub wyższy
  • Używa Androida 4.4 lub nowszego
  • Korzysta z Jetpack (AndroidX) , co obejmuje spełnienie następujących wymagań wersji:
    • com.android.tools.build:gradle w wersji 7.3.0 lub nowszej
    • compileSdkVersion 28 lub nowsza

• Skonfiguruj urządzenie fizyczne lub użyj emulatora , aby uruchomić aplikację.
  Pamiętaj, że zestawy 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 i chcesz po prostu wypróbować produkt Firebase, możesz pobrać jeden z naszych przykładów szybkiego startu .

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

• Opcja 1 : (zalecana) Użyj przepływu pracy 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 na Androida (na przykład pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do projektu na Androida).

Krok 1 : Utwórz projekt Firebase

Zanim będziesz mógł dodać Firebase do swojej aplikacji na Androida, musisz utworzyć projekt Firebase, aby połączyć się z tą aplikacją na Androida. Odwiedź stronę Poznaj projekty 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ć 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ć proces konfiguracji.

3. Wpisz nazwę pakietu aplikacji w polu nazwy pakietu Androida .

   Jaka jest nazwa pakietu i gdzie ją można znaleźć?

   • 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 swojej aplikacji w pliku Gradle modułu (na poziomie aplikacji), zazwyczaj app/build.gradle (przykładowa nazwa pakietu: com.yourcompany.yourproject ).

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

4. (Opcjonalnie) Wprowadź 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

   • Certyfikat podpisywania debugowania SHA-1 : skrót SHA-1 jest wymagany przez uwierzytelnianie Firebase (podczas korzystania z logowania Google lub logowania się za pomocą numeru telefonu ) i łączy dynamicznych Firebase .

5. Kliknij opcję Zarejestruj aplikację .

Krok 3 : Dodaj plik konfiguracyjny Firebase

1. Pobierz, a następnie dodaj plik konfiguracyjny Firebase Android ( google-services.json ) do swojej aplikacji:

   1. Kliknij Pobierz plik google-services.json, aby uzyskać plik konfiguracyjny Firebase na Androida.

   2. Przenieś plik konfiguracyjny do katalogu głównego 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ę Informacje o projektach Firebase .

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

   • Upewnij się, że nazwa pliku konfiguracyjnego nie jest uzupełniona dodatkowymi znakami, takimi jak (2) .

2. Aby wartości w pliku konfiguracyjnym google-services.json były dostępne dla zestawów SDK Firebase, potrzebujesz wtyczki Gradle usług Google ( google-services ).

   1. W pliku Gradle na poziomie 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.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.4.0' apply false
      }
      

   2. 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 swojej aplikacji

1. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle ) dodaj zależności dla produktów Firebase którego chcesz używać w swojej aplikacji. Zalecamy używanie Firebase Android BoM do kontrolowania wersji bibliotek.

   Analityka włączona

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.6.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")
   }
   

   Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze korzystać z kompatybilnych wersji bibliotek Firebase Android.

   Szukasz modułu bibliotecznego specyficznego dla Kotlina? Począwszy od października 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i Java mogą polegać na głównym module biblioteki (więcej informacji można znaleźć w często zadawanych pytaniach dotyczących tej inicjatywy ).

   Analityka nie jest włączona

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.6.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")
   }
   

   Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze korzystać z kompatybilnych wersji bibliotek Firebase Android.

   Szukasz modułu bibliotecznego specyficznego dla Kotlina? Począwszy od października 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i Java mogą polegać na głównym module biblioteki (więcej informacji można znaleźć w często zadawanych pytaniach dotyczących tej inicjatywy ).

2. Po dodaniu zależności dla produktów, których chcesz używać, zsynchronizuj swój projekt Android z plikami Gradle.

   Czy podczas kompilacji pojawia się błąd związany z obsługą niestandardowych wywołań i włączeniem usuwania cukru? Oto jak to naprawić.

   Kompilacje Gradle korzystające z wtyczki Android Gradle (AGP) w wersji 4.2 lub wcześniejszej muszą włączyć obsługę Java 8. W przeciwnym razie kompilacja tych projektów na Androida zakończy się niepowodzeniem podczas dodawania pakietu SDK Firebase.

   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.kts lub build.gradle na poziomie aplikacji .
   • Zwiększ minSdk dla swojego projektu na Androida do 26 lub więcej.

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

Otóż ​​to! Możesz przejść dalej, aby sprawdzić zalecane kolejne kroki .

Jeśli jednak masz problemy z konfiguracją, odwiedź stronę dotyczącą rozwiązywania problemów i często zadawanych pytań dotyczących systemu Android .

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 — a wszystko to z poziomu Android Studio!

1. Otwórz swój projekt na Androida w Android Studio, a następnie upewnij się, że używasz 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 panelu Asystent wybierz produkt Firebase, który chcesz dodać do swojej aplikacji. Rozwiń jej sekcję, a następnie kliknij link do samouczka (na przykład Analytics > Rejestruj zdarzenie Analytics ).

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

      Co robi ten przepływ pracy?

      • Ten przepływ pracy automatycznie tworzy nową aplikację Firebase na Androida, korzystając z nazwy pakietu aplikacji. Możesz utworzyć tę nową aplikację Firebase na Androida w istniejącym projekcie Firebase lub w nowym projekcie.

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

        • Zapoznaj się z naszymi najlepszymi praktykami dotyczącymi dodawania aplikacji do projektu Firebase, w tym dotyczącymi obsługi wielu wariantów.

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

      • Ten przepływ pracy dodaje również plik konfiguracyjny Androida 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 aplikację, aby mieć pewność, że wszystkie zależności mają niezbędne wersje.

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

6. Dodaj dowolną liczbę innych produktów Firebase za pomocą Asystenta Firebase!

Otóż ​​to! Koniecznie zapoznaj się z zalecanymi kolejnymi krokami .

Jeśli jednak masz problemy z konfiguracją, odwiedź stronę dotyczącą rozwiązywania problemów i często zadawanych pytań dotyczących systemu Android .

Dostępne biblioteki

W tej sekcji wymieniono produkty Firebase obsługiwane dla systemu Android i ich zależności Gradle. Dowiedz się więcej o bibliotekach Firebase na Androida:

• Dokumentacja referencyjna ( Kotlin+KTX | Java )

• Repozytorium Firebase Android SDK GitHub

Pamiętaj, że podczas korzystania z Firebase Android BoM nie określasz poszczególnych wersji bibliotek, gdy deklarujesz zależności bibliotek Firebase w pliku konfiguracyjnym kompilacji Gradle.

Następne kroki

Dodaj usługi Firebase do swojej aplikacji:

• Zdobądź wgląd w zachowania użytkowników dzięki Analytics .

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

• Przechowuj dane, takie jak informacje o użytkowniku, za pomocą Cloud Firestore lub Realtime Database .

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

• Uruchom kod backendu, który działa w bezpiecznym środowisku dzięki Cloud Functions .

• Wysyłaj powiadomienia za pomocą wiadomości w chmurze .

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

Dowiedz się więcej o Firebase:

• Odwiedź stronę Poznaj projekty Firebase, aby dowiedzieć się więcej o projektach Firebase i najlepszych praktykach 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 programowania Firebase i Androida.

• Poznaj przykładowe aplikacje Firebase .

• Zdobądź praktyczne doświadczenie dzięki Firebase Android Codelab .

• Dowiedz się więcej o Firebase w kursie weekendowym .

• Przygotuj się do uruchomienia aplikacji:

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

• Masz problemy z Firebase i swoim projektem na Androida? Odwiedź stronę dotyczącą rozwiązywania problemów i często zadawanych pytań dotyczących Androida .