Menambahkan Firebase ke project Android Anda

Prasyarat

  • Instal atau update Android Studio ke versi terbaru.

  • Pastikan project Anda memenuhi persyaratan berikut:

    • Menarget API level 19 (KitKat) atau yang lebih tinggi
    • Menggunakan Android 4.4 atau yang lebih tinggi
    • Menggunakan Jetpack (AndroidX), termasuk memenuhi persyaratan versi berikut ini:
      • com.android.tools.build:gradle v3.2.1 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.

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.

  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.

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

  5. Klik Register app.

Langkah 3: Tambahkan file konfigurasi Firebase

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

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

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

  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

      plugins {
        id("com.android.application") version "7.2.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.3.15" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.2.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.3.15' 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>/build.gradle.kts atau <project>/build.gradle), tambahkan dependensi untuk produk Firebase yang ingin digunakan di aplikasi. Sebaiknya gunakan Firebase Android BoM untuk mengontrol pembuatan versi library.

    Analytics diaktifkan

    Kotlin+KTX

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

    Java

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

    Analytics tidak diaktifkan

    Kotlin+KTX

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

    Java

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

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

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.

    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.

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:

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.

Kotlin+KTX

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.

32.3.1
AdMob com.google.android.gms:play-services-ads 22.4.0
Analytics com.google.firebase:firebase-analytics-ktx 21.3.0
Penyedia kustom App Check com.google.firebase:firebase-appcheck-ktx 17.0.1
Penyedia debug App Check com.google.firebase:firebase-appcheck-debug 17.0.1
Penyedia App Check Play Integrity com.google.firebase:firebase-appcheck-playintegrity 17.0.1
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta10
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta10
Plugin App Distribution com.google.firebase:firebase-appdistribution-gradle 4.0.0
Authentication com.google.firebase:firebase-auth-ktx 22.1.2
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.8.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.3.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 23.2.1
Cloud Storage com.google.firebase:firebase-storage-ktx 20.2.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.4.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.4.3
Plugin Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
Dukungan modul fitur dinamis com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 21.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 20.3.5
(wajib ada)
Tampilan In-App Messaging com.google.firebase:firebase-inappmessaging-display-ktx 20.3.5
(wajib ada)
Penginstalan Firebase com.google.firebase:firebase-installations-ktx 17.1.4
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.1.3
Performance Monitoring com.google.firebase:firebase-perf-ktx 20.4.1
Plugin Performance Monitoring com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database-ktx 20.2.2
Remote Config com.google.firebase:firebase-config-ktx 21.4.1
Plugin layanan Google Play com.google.gms:google-services 4.3.15
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

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

Java

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.

32.3.1
AdMob com.google.android.gms:play-services-ads 22.4.0
Analytics com.google.firebase:firebase-analytics 21.3.0
Penyedia kustom App Check com.google.firebase:firebase-appcheck 17.0.1
Penyedia debug App Check com.google.firebase:firebase-appcheck-debug 17.0.1
Penyedia App Check Play Integrity com.google.firebase:firebase-appcheck-playintegrity 17.0.1
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta10
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta10
Plugin App Distribution com.google.firebase:firebase-appdistribution-gradle 4.0.0
Authentication com.google.firebase:firebase-auth 22.1.2
Cloud Firestore com.google.firebase:firebase-firestore 24.8.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 20.3.1
Cloud Messaging com.google.firebase:firebase-messaging 23.2.1
Cloud Storage com.google.firebase:firebase-storage 20.2.1
Crashlytics com.google.firebase:firebase-crashlytics 18.4.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.4.3
Plugin Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
Dukungan modul fitur dinamis com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 21.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 20.3.5
(wajib ada)
Tampilan In-App Messaging com.google.firebase:firebase-inappmessaging-display 20.3.5
(wajib ada)
Penginstalan Firebase com.google.firebase:firebase-installations 17.1.4
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.1.3
Performance Monitoring com.google.firebase:firebase-perf 20.4.1
Plugin Performance Monitoring com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 20.2.2
Remote Config com.google.firebase:firebase-config 21.4.1
Plugin layanan Google Play com.google.gms:google-services 4.3.15
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

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



Langkah berikutnya

Menambahkan layanan Firebase ke aplikasi Anda:

Mempelajari Firebase: