Menambahkan Firebase ke project Android Anda

Prasyarat

• Instal atau update Android Studio ke versi terbaru.

• Pastikan project Anda memenuhi persyaratan berikut (perhatikan bahwa beberapa produk mungkin memiliki persyaratan yang lebih ketat):

  • Level API target 21 (Lollipop) atau yang lebih baru
  • Menggunakan Android 5.0 atau yang lebih baru
  • Menggunakan Jetpack (AndroidX), termasuk memenuhi persyaratan versi berikut ini:
    • com.android.tools.build:gradle v7.3.0 atau yang lebih baru
    • compileSdkVersion 28 atau yang lebih baru

• Siapkan perangkat fisik atau gunakan emulator untuk menjalankan aplikasi Anda.
  Perhatikan bahwa Firebase SDK yang memiliki dependensi pada layanan Google Play mengharuskan layanan Google Play diinstal di perangkat atau emulator.

• Login ke Firebase menggunakan akun Google Anda.

Jika Anda belum memiliki project Android dan hanya ingin mencoba produk Firebase, download salah satu contoh panduan memulai.

Anda dapat menghubungkan aplikasi Android ke Firebase menggunakan salah satu opsi berikut:

• Opsi 1: (direkomendasikan) Menggunakan alur kerja penyiapan Firebase console.
• Opsi 2: Menggunakan Firebase Assistant Android Studio (mungkin memerlukan konfigurasi tambahan).

---

Opsi 1: Menambahkan Firebase menggunakan Firebase console

Penambahan Firebase ke aplikasi memerlukan tindakan baik di Firebase console maupun di project Android yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari console, lalu memindahkannya ke project Android).

Langkah 1: Buat project Firebase

Agar dapat menambahkan Firebase ke aplikasi Android, Anda perlu membuat project Firebase untuk dihubungkan ke aplikasi Android. Buka bagian Memahami Project Firebase untuk mempelajari project Firebase lebih lanjut.

Membuat project Firebase

1. Di Firebase console, klik Add project.

   • Untuk menambahkan resource Firebase ke project Google Cloud yang sudah ada, masukkan nama project-nya atau pilih dari menu dropdown.

   • Untuk membuat project baru, masukkan nama project. Anda juga dapat mengedit project ID yang ditampilkan di bawah nama project.

     Firebase menghasilkan ID unik untuk project Firebase Anda berdasarkan nama yang Anda berikan. Jika ingin mengedit project ID ini, Anda harus melakukannya sekarang karena project ID tidak dapat diubah setelah Firebase menyediakan resource untuk project Anda. Buka artikel Memahami Project Firebase untuk mempelajari cara Firebase menggunakan project ID.

2. Jika diminta, tinjau dan setujui persyaratan Firebase.

3. Klik Continue.

4. (Opsional) Siapkan Google Analytics untuk project Anda, yang memungkinkan pengalaman optimal menggunakan produk Firebase berikut: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging, dan Remote Config (termasuk Personalisasi).

   Pilih akun Google Analytics yang ada atau buat akun baru. Jika Anda membuat akun baru, pilih lokasi pelaporan Analytics, lalu setujui setelan berbagi data dan persyaratan Google Analytics untuk project Anda.

   Anda dapat sewaktu-waktu menyiapkan Google Analytics dari tab Integrations di Project settings Anda.

5. Klik Create project (atau Add Firebase, jika Anda menambahkan Firebase ke project Google Cloud yang sudah ada).

Firebase otomatis menyediakan resource untuk project Firebase Anda. Begitu selesai, Anda akan dibawa ke halaman ringkasan untuk project Firebase Anda di Firebase console.

Langkah 2: Daftarkan aplikasi Anda ke Firebase

Untuk menggunakan Firebase di aplikasi Android, Anda perlu mendaftarkan aplikasi ke project Firebase. Mendaftarkan aplikasi sering kali disebut sebagai "menambahkan" aplikasi ke project Anda.

Catatan: Lihat praktik terbaik kami untuk menambahkan aplikasi ke project Firebase, termasuk cara menangani beberapa varian.

1. Buka Firebase console.

2. Di bagian tengah halaman ringkasan project, klik ikon Android () atau Add app untuk meluncurkan alur kerja penyiapan.

3. Masukkan nama paket aplikasi Anda di kolom Android package name.

   Apa itu nama paket, dan di mana lokasinya?

   • Nama paket secara unik mengidentifikasi aplikasi Anda di perangkat dan di Google Play Store.

   • Nama paket sering disebut sebagai ID aplikasi.

   • Temukan nama paket aplikasi dalam file Gradle modul (level aplikasi), biasanya app/build.gradle (contoh nama paket: com.yourcompany.yourproject).

   • Perhatikan bahwa nilai nama paket peka huruf besar/kecil dan tidak dapat diubah untuk aplikasi Android Firebase ini setelah didaftarkan ke project Firebase Anda.

   Pastikan untuk memasukkan nama paket yang benar-benar digunakan aplikasi Anda. Nilai nama paket peka huruf besar/kecil dan tidak dapat diubah untuk aplikasi Android Firebase ini setelah didaftarkan ke project Firebase Anda.

4. (Opsional) Masukkan informasi aplikasi yang lain: App nickname dan Debug signing certificate SHA-1.

   Bagaimana App nickname dan Debug signing certificate SHA-1 digunakan dalam Firebase?

   • App nickname: ID internal praktis yang hanya terlihat oleh Anda di Firebase console.

   • Debug signing certificate SHA-1: Hash SHA-1 diwajibkan oleh Firebase Authentication (saat menggunakan Login dengan Google atau login dengan nomor telepon) dan Firebase Dynamic Links.

5. Klik Register app.

Langkah 3: Tambahkan file konfigurasi Firebase

1. Download, lalu tambahkan file konfigurasi Firebase aplikasi Anda (google-services.json) ke codebase:

   1. Klik Download google-services.json untuk mendapatkan file konfigurasi Firebase aplikasi Anda.

   2. Pindahkan file konfigurasi ke direktori root modul (level aplikasi) aplikasi Anda.

   Apa yang perlu Anda ketahui tentang file konfigurasi ini?

   • File konfigurasi Firebase berisi ID unik, tetapi tidak bersifat rahasia, untuk project dan aplikasi Anda. Untuk mempelajari file konfigurasi ini lebih lanjut, baca Memahami Project Firebase.

   • Anda dapat mendownload file konfigurasi Firebase lagi kapan saja.

   • Pastikan nama file konfigurasi tidak diberi karakter tambahan, seperti (2).

2. Agar nilai dalam file konfigurasi google-services.json Anda dapat diakses oleh Firebase SDK, Anda memerlukan plugin Gradle layanan Google (google-services).

   1. Dalam file Gradle level root (level project) (<project>/build.gradle.kts atau <project>/build.gradle), tambahkan plugin layanan Google sebagai dependensi:

      Kotlin

      Apakah Anda masih menggunakan sintaksis buildscript? Pelajari cara menambahkan plugin Firebase menggunakan sintaksis tersebut.

      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.3" apply false
      }

      Groovy

      Apakah Anda masih menggunakan sintaksis buildscript? Pelajari cara menambahkan plugin Firebase menggunakan sintaksis tersebut.

      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.3' apply false
      }

   2. Dalam file Gradle modul (level aplikasi) (biasanya <project>/<app-module>/build.gradle.kts atau <project>/<app-module>/build.gradle), tambahkan plugin layanan 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'
        // ...
      }

Langkah 4: Tambahkan Firebase SDK ke aplikasi Anda

1. Dalam file Gradle modul (level aplikasi) (biasanya <project>/<app-module>/build.gradle.kts atau <project>/<app-module>/build.gradle), tambahkan dependensi untuk produk Firebase yang ingin digunakan di aplikasi. Sebaiknya gunakan Firebase Android BoM untuk mengontrol pembuatan versi library.

   Analytics diaktifkan

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

   Dengan menggunakan Firebase Android BoM, aplikasi Anda akan selalu menggunakan versi library Android Firebase yang kompatibel.

   Mencari modul library khusus Kotlin? Mulai Oktober 2023 (Firebase BoM 32.5.0), developer Kotlin dan Java dapat bergantung pada modul library utama (untuk mengetahui detailnya, lihat FAQ tentang inisiatif ini).

   Analytics tidak aktif

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

   Dengan menggunakan Firebase Android BoM, aplikasi Anda akan selalu menggunakan versi library Android Firebase yang kompatibel.

   Mencari modul library khusus Kotlin? Mulai Oktober 2023 (Firebase BoM 32.5.0), developer Kotlin dan Java dapat bergantung pada modul library utama (untuk mengetahui detailnya, lihat FAQ tentang inisiatif ini).

2. Setelah menambahkan dependensi untuk produk yang ingin Anda gunakan, sinkronkan project Android Anda dengan file Gradle.

   Apakah Anda mengalami kegagalan build terkait dukungan untuk pemanggilan kustom dan pengaktifan desugaring? Berikut cara memperbaikinya.

   Build Gradle yang menggunakan plugin Android Gradle (AGP) v4.2 atau versi sebelumnya perlu mengaktifkan dukungan Java 8. Jika tidak, project Android ini akan mengalami kegagalan build saat menambahkan Firebase SDK.

   Untuk memperbaiki kegagalan build ini, Anda dapat mengikuti salah satu dari dua opsi berikut:

   • Tambahkan compileOptions yang tercantum dari pesan error ke file build.gradle.kts atau build.gradle level aplikasi.
   • Tingkatkan minSdk untuk project Android Anda menjadi 26 atau lebih tinggi.

   Pelajari kegagalan build ini lebih lanjut dalam FAQ ini.

Selesai! Anda dapat melewatkan bagian ini untuk melihat langkah berikutnya yang direkomendasikan.

Jika Anda mengalami kesulitan dalam penyiapan, kunjungi FAQ & pemecahan masalah Android.

---

Opsi 2: Menambahkan Firebase menggunakan Firebase Assistant

Firebase Assistant mendaftarkan aplikasi Anda ke project Firebase dan menambahkan file, plugin, serta dependensi Firebase yang diperlukan ke project Android Anda. Semuanya dapat dilakukan dari dalam Android Studio.

1. Buka project Android di Android Studio, lalu pastikan Anda menggunakan versi terbaru Android Studio dan Firebase Assistant:

   • Windows/Linux: Help > Check of updates
   • macOS: Android Studio > Check for updates

2. Buka Firebase Assistant: Tools > Firebase.

3. Di panel Assistant pilih produk Firebase yang akan ditambahkan ke aplikasi Anda. Luaskan bagiannya, lalu klik link tutorial (misalnya, Analytics > Log an Analytics event).

   1. Klik Connect to Firebase untuk menghubungkan project Android Anda dengan Firebase.

      Apa fungsi alur kerja ini?

      • Alur kerja ini otomatis membuat aplikasi Android Firebase yang baru menggunakan nama paket aplikasi Anda. Anda dapat membuat aplikasi Android Firebase yang baru ini, baik di project Firebase yang sudah ada maupun di project baru.

        Berikut adalah beberapa tips tentang penyiapan project Firebase:

        • Lihat praktik terbaik kami untuk menambahkan aplikasi ke project Firebase, termasuk cara menangani beberapa varian.

        • Jika Anda membuat project baru, sebaiknya siapkan Google Analytics untuk project Anda. Dengan cara ini, Anda akan mendapatkan pengalaman optimal menggunakan berbagai produk Firebase.

      • Alur kerja ini juga menambahkan file konfigurasi Android milik project Firebase Anda (google-services.json) ke direktori modul (level aplikasi) aplikasi Anda.

        Catatan: File konfigurasi Firebase berisi ID unik, tetapi tidak bersifat rahasia, untuk project Anda.
        Buka bagian Memahami Project Firebase untuk mempelajari file konfigurasi ini lebih lanjut.

   2. Klik tombol untuk menambahkan produk Firebase yang diinginkan (misalnya, Add Analytics to your app).

4. Sinkronkan aplikasi Anda untuk memastikan bahwa semua dependensi memiliki versi yang diperlukan.

5. Di panel Assistant, ikuti petunjuk penyiapan yang tersisa untuk produk Firebase yang dipilih.

6. Tambahkan sebanyak mungkin produk Firebase lainnya yang Anda inginkan melalui Firebase Assistant.

Apakah Anda ingin cara yang lebih mudah untuk mengelola versi library?
Anda dapat menggunakan Firebase Android BoM untuk mengelola versi library Firebase dan memastikan bahwa aplikasi Anda selalu menggunakan versi library yang kompatibel.

Selesai! Pastikan untuk melihat langkah berikutnya yang direkomendasikan.

Jika Anda mengalami kesulitan dalam penyiapan, kunjungi FAQ & pemecahan masalah Android.

---

Library yang tersedia

Bagian ini mencantumkan produk Firebase yang didukung untuk Android dan dependensi Gradle-nya. Pelajari library Android Firebase ini lebih lanjut:

• Dokumentasi referensi (Kotlin | Java)

• Repositori GitHub Firebase Android SDK

Perhatikan bahwa saat menggunakan Firebase Android BoM, Anda tidak menentukan versi library satu per satu saat mendeklarasikan dependensi library Firebase dalam file konfigurasi build Gradle.

Penting: Developer Kotlin kini harus bergantung pada modul utama, bukan modul KTX (saat menggunakan Firebase BoM v32.5.0+ atau versi modul utama yang tercantum dalam BoM v32.5.0+). Untuk mengetahui detailnya, lihat FAQ tentang inisiatif ini.

Bagian utama tabel di bawah ini mencantumkan dependensi untuk modul dan versi terbarunya. Namun, jika diperlukan, Anda masih dapat menemukan daftar semua modul KTX dan versinya di bagian bawah tabel.

Layanan atau Produk	Dependensi Gradle	Versi terbaru	Tambahkan Analytics?
Firebase Android BoM (Bill of Materials)	com.google.firebase:firebase-bom Versi Firebase BoM terbaru berisi versi terbaru setiap library Android Firebase. Untuk mempelajari versi library yang dipetakan ke versi BoM tertentu, tinjau catatan rilis untuk versi BoM tersebut.	33.16.0
AdMob	com.google.android.gms:play-services-ads	24.4.0
Firebase AI Logic ^1	com.google.firebase:firebase-ai	16.2.0
Analytics	com.google.firebase:firebase-analytics	22.5.0
Penyedia kustom App Check	com.google.firebase:firebase-appcheck	18.0.0
Penyedia debug App Check	com.google.firebase:firebase-appcheck-debug	18.0.0
Penyedia Play Integrity App Check	com.google.firebase:firebase-appcheck-playintegrity	18.0.0
App Distribution	com.google.firebase:firebase-appdistribution	16.0.0-beta15
App Distribution API	com.google.firebase:firebase-appdistribution-api	16.0.0-beta15
Plugin App Distribution	com.google.firebase:firebase-appdistribution-gradle	5.1.1
Authentication	com.google.firebase:firebase-auth	23.2.1
Cloud Firestore	com.google.firebase:firebase-firestore	25.1.4
Cloud Functions for Firebase Client SDK	com.google.firebase:firebase-functions	21.2.1
Cloud Messaging	com.google.firebase:firebase-messaging	24.1.2
Cloud Storage	com.google.firebase:firebase-storage	21.0.2
Crashlytics	com.google.firebase:firebase-crashlytics	19.4.4
Crashlytics NDK	com.google.firebase:firebase-crashlytics-ndk	19.4.4
Plugin Crashlytics	com.google.firebase:firebase-crashlytics-gradle	3.0.4
Data Connect	com.google.firebase:firebase-dataconnect	16.0.3
Dukungan modul fitur dinamis	com.google.firebase:firebase-dynamic-module-support	16.0.0-beta03
Dynamic Links	com.google.firebase:firebase-dynamic-links	22.1.0
In-App Messaging	com.google.firebase:firebase-inappmessaging	21.0.2	(wajib ada)
Tampilan In-App Messaging	com.google.firebase:firebase-inappmessaging-display	21.0.2	(wajib ada)
Penginstalan Firebase	com.google.firebase:firebase-installations	18.0.0
Firebase ML Model Downloader API	com.google.firebase:firebase-ml-modeldownloader	25.0.1
Performance Monitoring	com.google.firebase:firebase-perf	21.0.5
Plugin Performance Monitoring	com.google.firebase:perf-plugin	1.4.2
Realtime Database	com.google.firebase:firebase-database	21.0.0
Remote Config	com.google.firebase:firebase-config	22.1.2
Plugin layanan Google Play	com.google.gms:google-services	4.4.3
LIBRARY YANG TIDAK DIGUNAKAN LAGI
Penyedia SafetyNet App Check	com.google.firebase:firebase-appcheck-safetynet	16.1.2
App Indexing	com.google.firebase:firebase-appindexing	20.0.0
Modul KTX Firebase API ekstensi Kotlin (KTX) telah ditambahkan ke modul utamanya masing-masing. Misalnya, semua API dari firebase-perf-ktx telah ditambahkan ke firebase-perf di bagian paket com.google.firebase.perf. Perubahan ini berarti bahwa developer Kotlin kini harus bergantung pada modul utama, bukan modul KTX (saat menggunakan Firebase BoM v32.5.0+ atau versi modul utama yang tercantum dalam BoM v32.5.0+). Sebagai bagian dari perubahan ini, API KTX di setiap modul KTX kini tidak digunakan lagi. Mulai September 2024, kami tidak akan lagi merilis modul KTX dan kami juga akan menghapus library KTX dari Firebase Android BoM pada saat itu. Jika Anda menggunakan API KTX dari modul KTX, sebaiknya migrasikan aplikasi Anda untuk menggunakan API KTX dari modul utama. Untuk mengetahui detailnya, lihat FAQ tentang inisiatif ini. Analytics com.google.firebase:firebase-analytics-ktx 22.5.0 Penyedia kustom App Check com.google.firebase:firebase-appcheck-ktx 18.0.0 App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15 Authentication com.google.firebase:firebase-auth-ktx 23.2.1 Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4 Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1 Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2 Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2 Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4 Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0 In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2 (wajib ada) Tampilan In-App Messaging com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2 (wajib ada) Penginstalan Firebase com.google.firebase:firebase-installations-ktx 18.0.0 Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1 Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.5 Realtime Database com.google.firebase:firebase-database-ktx 21.0.0 Remote Config com.google.firebase:firebase-config-ktx 22.1.2
Library Firebase ML Kit Firebase ML Custom Model API com.google.firebase:firebase-ml-model-interpreter 22.0.4 Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0 Firebase ML: Model Pelabelan Gambar com.google.firebase:firebase-ml-vision-image-label-model 20.0.2 Firebase ML: Model Deteksi dan Pelacakan Objek com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6 Firebase ML: Model Deteksi Wajah com.google.firebase:firebase-ml-vision-face-model 20.0.2 Firebase ML: Model Pemindaian Kode Batang com.google.firebase:firebase-ml-vision-barcode-model 16.1.2 Firebase ML: AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6 Firebase ML: Natural Language API com.google.firebase:firebase-ml-natural-language 22.0.1 Firebase ML: Model Identifikasi Bahasa com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8 Firebase ML: Model Terjemahan com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9 Firebase ML: Model Smart Reply com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

^{1 Firebase AI Logic sebelumnya disebut "Vertex AI in Firebase" dengan paket com.google.firebase:firebase-vertexai.}

---

Langkah berikutnya

Menambahkan layanan Firebase ke aplikasi Anda:

• Buat fitur AI generatif dengan model Gemini dan Imagen menggunakan Firebase AI Logic.

• Dapatkan insight tentang perilaku pengguna dengan Analytics.

• Siapkan alur autentikasi pengguna dengan Authentication.

• Simpan data, seperti informasi pengguna, dengan Cloud Firestore atau Realtime Database

• Simpan file, seperti foto dan video, dengan Cloud Storage

• Picu kode backend yang berjalan di lingkungan aman dengan Cloud Functions.

• Kirim notifikasi dengan Cloud Messaging

• Ketahui kapan dan mengapa aplikasi Anda mengalami error dengan Crashlytics.

Mempelajari Firebase:

• Buka bagian Memahami Project Firebase untuk mempelajari lebih lanjut project Firebase dan praktik terbaik untuk project.

• Buka bagian Mempelajari Android dan Firebase lebih lanjut jika Anda memiliki pertanyaan tentang konsep yang tidak akrab di telinga atau spesifik untuk pengembangan Firebase dan Android.

• Pelajari contoh aplikasi Firebase.

• Dapatkan pengalaman langsung dengan Firebase Android Codelab.

• Pelajari lebih lanjut dengan kursus Firebase in a Weekend.

• Bersiap meluncurkan aplikasi Anda:

  • Siapkan pemberitahuan anggaran untuk project Anda di konsol Google Cloud.
  • Pantau dasbor Usage and billing di Firebase console untuk mendapatkan gambaran keseluruhan penggunaan project Anda di berbagai layanan Firebase.
  • Periksa checklist peluncuran Firebase.

• Mengalami masalah dengan Firebase dan project Android Anda? Kunjungi FAQ & pemecahan masalah Android.