Menambahkan Firebase ke project Android Anda

Prasyarat

• Instal atau update Android Studio ke versi terbaru.

• Pastikan aplikasi Android Anda:

  • Menargetkan API level 16 (Jelly Bean) atau yang lebih baru
  • Menggunakan Gradle 4.1 atau yang lebih baru

• Siapkan perangkat atau emulator untuk menjalankan aplikasi Anda.

  • Emulator harus menggunakan image emulator dengan Google Play.

• Login ke Firebase menggunakan Akun Google Anda.

Jika belum memiliki project aplikasi Android, Anda dapat mendownload salah satu contoh panduan memulai kami jika hanya ingin mencoba produk Firebase.

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

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

Membuat project Firebase

1. Di Firebase console, klik Tambahkan project, lalu pilih atau masukkan Nama project.

   Jika sudah memiliki project Google Cloud Platform (GCP), Anda dapat memilih project tersebut dari menu drop-down Nama project. Jika tidak, masukkan Nama project baru.

2. (Opsional) Edit Project ID.

   Firebase menetapkan ID unik ke project Firebase Anda secara otomatis. Buka bagian Memahami Project Firebase untuk mempelajari cara Firebase menggunakan project ID.

   Setelah Firebase menyediakan resource untuk project Firebase Anda, Anda tidak dapat mengubah project ID.
   Untuk menggunakan ID khusus, Anda harus mengedit project ID selama langkah penyiapan ini.

3. Ikuti langkah-langkah penyiapan selanjutnya di Firebase console, lalu klik Buat project (atau Tambahkan Firebase, jika Anda menggunakan project Google yang sudah ada).

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

Langkah 2: Daftarkan aplikasi Anda ke Firebase

Setelah memiliki project Firebase, Anda dapat menambahkan aplikasi Android ke dalamnya.

Buka bagian Memahami Project Firebase untuk mempelajari lebih lanjut praktik terbaik dan pertimbangan dalam menambahkan aplikasi ke project Firebase, termasuk cara menangani beberapa variasi build.

1. Di tengah halaman ringkasan project Firebase console, klik ikon Android untuk meluncurkan alur kerja penyiapan.

   Jika Anda telah menambahkan aplikasi ke project Firebase, klik Tambahkan aplikasi untuk menampilkan opsi platform.

2. Masukkan ID aplikasi untuk aplikasi Anda di kolom Nama paket Android.

   Pastikan Anda memasukkan ID yang benar-benar digunakan aplikasi Anda. Anda tidak dapat menambah atau mengubah nilai ini setelah mendaftarkan aplikasi Anda ke project Firebase.

   • ID aplikasi terkadang disebut sebagai nama paket.

   • Temukan ID aplikasi ini dalam file Gradle modul Anda (tingkat aplikasi), biasanya app/build.gradle (contoh ID: com.yourcompany.yourproject).

3. (Opsional) Masukkan informasi aplikasi lain seperti yang diminta oleh alur kerja penyiapan.

   Nama pengguna ini adalah ID internal untuk memudahkan dan hanya terlihat oleh Anda di Firebase console.

   Catatan: Informasi SHA-1 diperlukan oleh Firebase Authentication (saat menggunakan Login dengan Google atau login dengan nomor telepon) dan Firebase Dynamic Links.

4. 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 (google-services.json) Anda.

      • Anda dapat mendownload file konfigurasi Android Firebase lagi kapan saja.
      • Pastikan file konfigurasi tidak ditambahkan dengan karakter tambahan, seperti (2).

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

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

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

   1. Dalam file Gradle tingkat root (tingkat project) (build.gradle), tambahkan aturan untuk menyertakan plugin 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.2.0'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      

   2. Dalam file Gradle modul Anda (tingkat aplikasi) (biasanya app/build.gradle), tambahkan sebuah baris ke bagian paling bawah file.

      apply plugin: 'com.android.application'
      
      android {
        // ...
      }
      
      // Add the following line to the bottom of the file:
      apply plugin: 'com.google.gms.google-services'  // Google Play services Gradle plugin
      

Langkah 4: Tambahkan Firebase SDK ke aplikasi Anda

Anda dapat menambahkan produk Firebase yang didukung ke aplikasi Android. Sebaiknya mulailah dengan Firebase SDK inti (com.google.firebase:firebase-core), yang menyediakan fungsionalitas Google Analytics for Firebase.

1. Dalam file Gradle modul Anda (tingkat aplikasi) (biasanya app/build.gradle), tambahkan dependensi untuk Firebase SDK inti:

   dependencies {
    // ...
    implementation 'com.google.firebase:firebase-core:17.0.0'
   
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
   }
   

2. (Opsional) Tambahkan dependensi untuk library Firebase lain yang ingin Anda gunakan.

   Beberapa Firebase SDK untuk Android menawarkan library ekstensi Kotlin alternatif.

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

4. Jalankan aplikasi untuk mengirim verifikasi ke Firebase bahwa Anda telah berhasil mengintegrasikan Firebase.

   Log perangkat Anda akan menampilkan verifikasi Firebase bahwa inisialisasi telah selesai. Jika menjalankan aplikasi pada emulator yang memiliki akses jaringan, Firebase console akan memberi tahu bahwa koneksi aplikasi Anda telah selesai.

Selesai! Anda dapat langsung mengikuti langkah berikutnya.

Opsi 2: Menambahkan Firebase menggunakan Firebase Assistant

Firebase Assistant mendaftarkan aplikasi Anda ke project Firebase dan menambahkan file serta kode Firebase yang diperlukan ke project Android Anda — semuanya dari dalam Android Studio.

Perhatian: Saat menggunakan Firebase Assistant, ikuti langkah-langkah yang dijelaskan dalam bagian panduan ini dengan cermat untuk memastikan bahwa semua dependensi dan setelan Anda telah dikonfigurasi dengan benar.

Perhatikan bahwa opsi yang direkomendasikan untuk menghubungkan aplikasi Anda ke Firebase adalah menggunakan Alur kerja penyiapan Firebase console.

1. Buka project Android Anda di Android Studio.

2. Pilih Fitur > Firebase untuk membuka jendela Assistant.

3. Luaskan salah satu produk Firebase yang tercantum (misalnya Analytics), kemudian klik link tutorial yang tersedia (misalnya Membuat log peristiwa Analytics).

4. Klik Hubungkan ke Firebase untuk mendaftarkan aplikasi Anda ke project Firebase yang ada atau baru, dan untuk otomatis menambahkan file serta kode yang diperlukan ke project Android Anda.

5. Pastikan versi plugin dan library Anda merupakan yang terbaru:

   • Dalam file Gradle tingkat root (tingkat project) (build.gradle), periksa apakah versi plugin Layanan Google Anda merupakan yang terbaru (com.google.gms:google-services:4.2.0).

   • Dalam file Gradle modul Anda (tingkat aplikasi) (biasanya app/build.gradle), periksa apakah versi library Firebase Android Anda merupakan yang terbaru.

   Catatan: Jika Anda menggunakan Android Studio v3.2 atau yang lebih lama, pastikan juga bahwa setiap baris dependensi hanya memiliki satu nomor versi yang ditentukan.

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

7. Konfigurasi setelan berbagi data Analytics Anda di Setelan project Firebase console.
   Setelan berbagi data Analytics kepada produk Firebase lain harus aktif agar dapat menggunakan produk Firebase seperti Firebase Predictions atau Pengujian A/B Firebase.

8. Jalankan aplikasi untuk mengirim verifikasi ke Firebase bahwa Anda telah berhasil mengintegrasikan Firebase.

   Log perangkat Anda akan menampilkan verifikasi Firebase bahwa inisialisasi telah selesai. Jika menjalankan aplikasi pada emulator yang memiliki akses jaringan, Firebase console akan memberi tahu bahwa koneksi aplikasi Anda telah selesai.

Library yang tersedia

Library Android berikut tersedia untuk berbagai produk Firebase.

Beberapa Firebase SDK untuk Android menawarkan library ekstensi Kotlin alternatif.

Layanan atau Produk	Baris dependensi Gradle
Plugin layanan Google Play	com.google.gms:google-services:4.2.0
AdMob	com.google.firebase:firebase-ads:18.0.0
Analytics	com.google.firebase:firebase-core:17.0.0
App Indexing	com.google.firebase:firebase-appindexing:19.0.0
Authentication	com.google.firebase:firebase-auth:18.0.0
Cloud Firestore	com.google.firebase:firebase-firestore:20.0.0
SDK Klien Cloud Functions for Firebase	com.google.firebase:firebase-functions:18.0.0
Cloud Messaging	com.google.firebase:firebase-messaging:19.0.0
Cloud Storage	com.google.firebase:firebase-storage:18.0.0
Crashlytics	com.crashlytics.sdk.android:crashlytics:2.10.1
Dynamic Links	com.google.firebase:firebase-dynamic-links:18.0.0
In-App Messaging	com.google.firebase:firebase-inappmessaging:18.0.0
Tampilan In-App Messaging	com.google.firebase:firebase-inappmessaging-display:18.0.0
ML Kit: Vision API	com.google.firebase:firebase-ml-vision:21.0.0
ML Kit: Model Pelabelan Gambar	com.google.firebase:firebase-ml-vision-image-label-model:18.0.0
ML Kit: Model Deteksi Wajah	com.google.firebase:firebase-ml-vision-face-model:18.0.0
ML Kit: Model Deteksi dan Pelacakan Objek	com.google.firebase:firebase-ml-vision-object-detection-model:17.0.0
ML Kit: Natural Language API	com.google.firebase:firebase-ml-natural-language:20.0.0
ML Kit: Model Identifikasi Bahasa	com.google.firebase:firebase-ml-natural-language-language-id-model:20.0.0
ML Kit: Model Terjemahan	com.google.firebase:firebase-ml-natural-language-translate-model:20.0.0
ML Kit: Model Smart Reply	com.google.firebase:firebase-ml-natural-language-smart-reply-model:20.0.0
ML Kit: API Model Kustom	com.google.firebase:firebase-ml-model-interpreter:20.0.0
ML Kit: AutoML Vision Edge API	com.google.firebase:firebase-ml-vision-automl:17.0.0
Performance Monitoring	com.google.firebase:firebase-perf:18.0.0
Realtime Database	com.google.firebase:firebase-database:18.0.0
Remote Config	com.google.firebase:firebase-config:18.0.0

Mengontrol penentuan versi library dengan Firebase Bill of Material (BoM) (eksperimental)

Untuk pengelolaan versi library yang lebih mudah, pertimbangkan untuk mengimpor Firebase Bill of Material (BoM).

Menambahkan Firebase SDK ke aplikasi Anda menggunakan Firebase BoM

Peringatan: Firebase BoM hanya didukung sebagai fitur eksperimental untuk aplikasi Android Firebase.

Menggunakan fitur Gradle Bill of Material (BoM) bersama Firebase, Anda dapat mengatur versi platform Firebase secara keseluruhan. Setiap versi Firebase BoM berisi versi library Firebase yang kompatibel. Pelajari catatan rilis untuk mengetahui versi library yang dipetakan ke versi BoM tertentu.

Mengupdate ke versi BoM terbaru akan mengupdate semua library Android Firebase ke versi terbaru yang tersedia pada rilis BoM.

Untuk menambahkan Firebase SDK ke aplikasi Anda menggunakan Firebase BoM:

• Untuk Gradle 5.0 dan yang lebih baru, dukungan BoM diaktifkan secara otomatis. Siapkan dependensi Anda dalam file Gradle modul (biasanya app/build.gradle):

  dependencies {
    // Import the platform
    implementation platform('com.google.firebase:firebase-bom:20.0.0')
  
    // When using a BoM, dependencies don't require a specified version
    // If you do specify a version, it overrides the library version specified in the BoM
    implementation 'com.google.firebase:firebase-core'
    implementation 'com.google.firebase:firebase-auth'
    implementation 'com.google.firebase:firebase-firestore'
  }
  

• Untuk versi Gradle yang lebih lama, Anda harus mengaktifkan fitur BoM:
  1. Tambahkan enableFeaturePreview('IMPROVED_POM_SUPPORT') ke file settings.gradle Anda.
  2. Impor BoM seperti library normal (tanpa pengubah platform).

Setelah menambahkan firebase-bom ke dependensi, Anda dapat mendeklarasikan library Firebase tanpa menentukan versinya. Ketika ingin mengupdate versi library Firebase, Anda hanya perlu mengupdate versi Firebase BoM.

Jika Anda menentukan versi dalam baris dependensi library dan Anda menggunakan Firebase BoM, maka versi library yang ditentukan akan mengganti nilai versi yang ada dalam BoM.

Untuk melaporkan masalah atau menawarkan masukan tentang Firebase BoM, kunjungi repositori Firebase Android SDK di GitHub.

Langkah berikutnya

Mempelajari Firebase:

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

• Pelajari contoh aplikasi Firebase.

• Dapatkan pengalaman langsung dengan Firebase Android Codelab.

• Pelajari lebih lanjut kursus Firebase in a Weekend.

• Bersiap meluncurkan aplikasi Anda:

  • Tetapkan pemberitahuan penagihan.
  • Periksa checklist peluncuran Firebase.

Menambahkan fitur Firebase ke aplikasi:

• 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.