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.

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 dari menu drop-down untuk menambahkan resource Firebase ke project tersebut.

2. (Opsional) Jika sedang membuat project baru, Anda dapat mengedit Project ID.

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

3. Klik Lanjutkan.

4. (Opsional) Siapkan Google Analytics untuk project Anda untuk mengoptimalkan penggunaan produk-produk Firebase berikut:

   Firebase Crashlytics Firebase Predictions

   Firebase Cloud Messaging Firebase In-App Messaging

   Firebase Remote Config Pengujian A/B Firebase

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

5. Klik Buat project (atau Tambahkan Firebase, jika Anda menggunakan project GCP 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

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 (plat_android) atau Tambahkan aplikasi untuk meluncurkan alur kerja penyiapan.

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

   Apa itu nama paket, dan di mana Anda menemukannya?

   • 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 Anda 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 nilai tersebut tidak dapat diubah untuk aplikasi Android Firebase ini setelah didaftarkan dengan project Firebase Anda.

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

   Bagaimana Nama panggilan aplikasi dan Sertifikat penandatanganan debug SHA-1 digunakan dalam Firebase?

   • Nama panggilan aplikasi: ID internal praktis yang hanya dapat dilihat oleh Anda di Firebase console.

   • Sertifikat penandatanganan debug 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 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.

   Apa yang perlu Anda ketahui tentang file konfigurasi ini?

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

   • Anda dapat mendownload lagi file konfigurasi Firebase kapan saja.

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

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.

      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 atau di project baru.

        Berikut adalah beberapa tips tentang penyiapan project Firebase:

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

        • 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 (google-services.json) project Firebase ke direktori modul (level aplikasi) aplikasi Anda.

   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:

• Dokumentasi referensi (Java | Kotlin + KTX)

• Repositori GitHub Firebase Android SDK

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

---

Langkah berikutnya

Menambahkan layanan Firebase ke aplikasi Anda:

• 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 Pelajari Android dan Firebase lebih lanjut jika Anda memiliki pertanyaan tentang konsep yang tidak familier atau spesifik untuk pengembangan Firebase dan Android.

• Pelajari contoh aplikasi Firebase.

• Dapatkan pengalaman langsung dengan Firebase Android Codelab.

• Pelajari lebih lanjut kursus Firebase in a Weekend.

• Bersiap meluncurkan aplikasi Anda:

  • Siapkan pemberitahuan anggaran untuk project Anda di GCP Console.
  • Pantau dasbor Penggunaan dan penagihan di Firebase console.
  • Periksa checklist peluncuran Firebase.