Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Menambahkan Firebase ke project Android Anda

Prasyarat

  • Instal atau update Android Studio ke versi terbaru.

  • Pastikan project Anda memenuhi persyaratan berikut:

    • Menargetkan API level 16 (Jelly Bean) atau yang lebih baru
    • Menggunakan Gradle 4.1 atau yang lebih baru
    • 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.
    Emulator harus menggunakan image emulator dengan Google Play.

  • 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) Gunakan alur kerja penyiapan Firebase console.
  • Opsi 2: Gunakan Firebase Assistant Android Studio (mungkin memerlukan konfigurasi tambahan).



Opsi 1: Menambahkan Firebase menggunakan Firebase console

Menambahkan Firebase ke aplikasi melibatkan tugas di Firebase console dan di project Android yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari konsol, lalu memindahkannya ke project Android).

Langkah 1: Buat project Firebase

Agar dapat menambahkan Firebase ke aplikasi Android, Anda perlu membuat project Firebase untuk terhubung 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 "menambahkan" aplikasi ke project Anda.

  1. Buka Firebase console.

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

  3. Masukkan nama paket aplikasi Anda di kolom Nama paket Android.

  4. (Opsional) Masukkan informasi aplikasi lain: Nama panggilan aplikasi dan Sertifikat penandatanganan debug SHA-1.

  5. Klik Daftarkan aplikasi.

Langkah 3: Tambahkan file konfigurasi Firebase

  1. Tambahkan file konfigurasi Android Firebase ke aplikasi Anda:

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

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

  2. Untuk mengaktifkan produk Firebase di aplikasi Anda, tambahkan plugin google-services ke file Gradle Anda.

    1. Di file Gradle (build.gradle) level root (level project), tambahkan aturan untuk menyertakan plugin Gradle Layanan Google. Pastikan Anda juga memiliki repositori Maven 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.4'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. Di file Gradle modul (level aplikasi) Anda (biasanya app/build.gradle), terapkan plugin Gradle Layanan Google:

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

Langkah 4: Tambahkan Firebase SDK ke aplikasi Anda

  1. Dengan menggunakan Firebase Android BoM, deklarasikan dependensi untuk produk Firebase yang ingin Anda gunakan di aplikasi. Deklarasikan di file Gradle modul (level aplikasi) (biasanya app/build.gradle).

    Analytics diaktifkan

    Java

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

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

    Analytics tidak diaktifkan

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.0')
    
      // 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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.0')
    
      // 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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

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

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

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



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 dari dalam Android Studio.

  1. Buka project Android di Android Studio lalu akses Firebase Assistant:

    1. Buka File > Periksa update terbaru untuk memastikan Anda menggunakan versi terbaru Android Studio dan Firebase Assistant.

    2. Buka Alat > Firebase untuk membuka panel Assistant.

  2. Pilih produk Firebase untuk ditambahkan ke aplikasi Anda. Luaskan bagiannya, lalu klik link tutorial (misalnya, Analytics > Mencatat peristiwa Analytics ke dalam log).

    1. Klik Hubungkan ke Firebase untuk menghubungkan project Android Anda dengan Firebase.

    2. Klik tombol untuk menambahkan produk Firebase yang diinginkan (misalnya, Menambahkan Analytics ke aplikasi Anda).

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

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

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

Selesai! Pastikan untuk melihat langkah berikutnya yang direkomendasikan.



Library yang tersedia

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

Perhatikan saat menggunakan Firebase Android BoM, Anda tidak menentukan versi library masing-masing saat mendeklarasikan dependensi library Firebase di build.gradle.

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 dari setiap library Android Firebase. Untuk mempelajari versi library yang dipetakan ke versi BoM tertentu, tinjau catatan rilis untuk versi BoM tersebut.

25.12.0
AdMob com.google.android.gms:play-services-ads 19.4.0
Analytics com.google.firebase:firebase-analytics 17.6.0
App Indexing com.google.firebase:firebase-appindexing 19.1.0
Authentication com.google.firebase:firebase-auth 19.4.0
Cloud Firestore com.google.firebase:firebase-firestore 21.7.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 19.1.0
Cloud Messaging com.google.firebase:firebase-messaging 20.3.0
Cloud Storage com.google.firebase:firebase-storage 19.2.0
Crashlytics com.google.firebase:firebase-crashlytics 17.2.2
Dynamic Links com.google.firebase:firebase-dynamic-links 19.1.1
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML Custom Model API com.google.firebase:firebase-ml-model-interpreter 22.0.4
In-App Messaging com.google.firebase:firebase-inappmessaging 19.1.1
(wajib ada)
Tampilan In-App Messaging com.google.firebase:firebase-inappmessaging-display 19.1.1
(wajib ada)
Performance Monitoring com.google.firebase:firebase-perf 19.0.9
Realtime Database com.google.firebase:firebase-database 19.5.0
Remote Config com.google.firebase:firebase-config 19.2.0
Plugin layanan Google Play com.google.gms:google-services 4.3.4
Library yang tidak digunakan lagi
Firebase ML: Model Pelabelan Gambar com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Deteksi Objek dan Model Pelacakan 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

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 dari setiap library Android Firebase. Untuk mempelajari versi library yang dipetakan ke versi BoM tertentu, tinjau catatan rilis untuk versi BoM tersebut.

25.12.0
AdMob com.google.android.gms:play-services-ads 19.4.0
Analytics com.google.firebase:firebase-analytics-ktx 17.6.0
App Indexing com.google.firebase:firebase-appindexing 19.1.0
Authentication com.google.firebase:firebase-auth-ktx 19.4.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 21.7.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 19.1.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 20.3.0
Cloud Storage com.google.firebase:firebase-storage-ktx 19.2.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 17.2.2
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 19.1.1
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML Custom Model API com.google.firebase:firebase-ml-model-interpreter 22.0.4
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 19.1.1
(wajib ada)
Tampilan In-App Messaging com.google.firebase:firebase-inappmessaging-display-ktx 19.1.1
(wajib ada)
Performance Monitoring com.google.firebase:firebase-perf-ktx 19.0.9
Realtime Database com.google.firebase:firebase-database-ktx 19.5.0
Remote Config com.google.firebase:firebase-config-ktx 19.2.0
Plugin layanan Google Play com.google.gms:google-services 4.3.4
Library yang tidak digunakan lagi
Firebase ML: Model Pelabelan Gambar com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Deteksi Objek dan Model Pelacakan 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: