Prasyarat
Pasang atau perbarui Android Studio ke versi terbarunya.
Pastikan proyek Anda memenuhi persyaratan berikut:
- Menargetkan API level 19 (KitKat) atau lebih tinggi
- Menggunakan Android 4.4 atau lebih tinggi
- Menggunakan Jetpack (AndroidX) , yang termasuk memenuhi persyaratan versi berikut:
-
com.android.tools.build:gradle
v3.2.1 atau lebih baru -
compileSdkVersion
28 atau lebih baru
-
Siapkan perangkat fisik atau gunakan emulator untuk menjalankan aplikasi Anda.
Perhatikan bahwa SDK Firebase dengan ketergantungan pada layanan Google Play mengharuskan perangkat atau emulator untuk memasang layanan Google Play.Masuk ke Firebase menggunakan akun Google Anda.
Jika Anda belum memiliki proyek Android dan hanya ingin mencoba produk Firebase, Anda dapat mendownload salah satu contoh quickstart kami.
Anda dapat menghubungkan aplikasi Android ke Firebase menggunakan salah satu opsi berikut:
- Opsi 1 : (disarankan) Gunakan alur kerja penyiapan konsol Firebase.
- Opsi 2 : Gunakan Android Studio Firebase Assistant (mungkin memerlukan konfigurasi tambahan).
Opsi 1 : Tambahkan Firebase menggunakan konsol Firebase
Menambahkan Firebase ke aplikasi Anda melibatkan tugas baik di konsol Firebase maupun di proyek Android terbuka Anda (misalnya, Anda mengunduh file konfigurasi Firebase dari konsol, lalu memindahkannya ke proyek Android Anda).
Langkah 1 : Buat proyek Firebase
Sebelum dapat menambahkan Firebase ke aplikasi Android, Anda perlu membuat proyek Firebase untuk terhubung ke aplikasi Android. Kunjungi Memahami Proyek Firebase untuk mempelajari lebih lanjut tentang proyek Firebase.
Langkah 2 : Daftarkan aplikasi Anda ke Firebase
Untuk menggunakan Firebase di aplikasi Android Anda, Anda perlu mendaftarkan aplikasi Anda ke proyek Firebase Anda. Mendaftarkan aplikasi Anda sering disebut "menambahkan" aplikasi Anda ke proyek Anda.
Buka konsol Firebase .
Di tengah halaman ikhtisar proyek, klik ikon Android (
) atau Tambahkan aplikasi untuk meluncurkan alur kerja penyiapan.Masukkan nama paket aplikasi Anda di kolom nama paket Android .
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 di file Gradle modul (level aplikasi), biasanya
app/build.gradle
(contoh nama paket:com.yourcompany.yourproject
).Ketahuilah bahwa nilai nama paket peka huruf besar/kecil, dan tidak dapat diubah untuk aplikasi Android Firebase ini setelah didaftarkan ke proyek Firebase Anda.
(Opsional) Masukkan informasi aplikasi lainnya: Nama panggilan aplikasi dan sertifikat penandatanganan Debug SHA-1 .
Nama panggilan aplikasi : Pengidentifikasi kenyamanan internal yang hanya dapat dilihat oleh Anda di konsol Firebase
Sertifikat penandatanganan debug SHA-1 : Hash SHA-1 diperlukan oleh Firebase Authentication (saat menggunakan Google Sign In atau login dengan nomor telepon ) dan Firebase Dynamic Links .
Klik Daftarkan aplikasi .
Langkah 3 : Tambahkan file konfigurasi Firebase
Unduh lalu tambahkan file konfigurasi Android Firebase (
) ke aplikasi Anda:google-services.json Klik Unduh google-services.json untuk mendapatkan file konfigurasi Android Firebase Anda.
Pindahkan file konfigurasi Anda ke direktori root modul (level aplikasi) aplikasi Anda.
File konfigurasi Firebase berisi pengidentifikasi unik namun tidak rahasia untuk proyek Anda. Untuk mempelajari lebih lanjut tentang file konfigurasi ini, kunjungi Memahami Proyek Firebase .
Anda dapat mengunduh kembali file konfigurasi Firebase Anda kapan saja.
Pastikan nama file konfigurasi tidak ditambahkan dengan karakter tambahan, seperti
(2)
.
Agar nilai dalam file konfigurasi
Anda dapat diakses oleh Firebase SDK, Anda memerlukan plugin Gradle layanan Google (google-services.json google-services
).Di file Gradle level root (level proyek) Anda (
<project>/build.gradle
), tambahkan plugin layanan Google sebagai dependensi buildscript:buildscript { repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } dependencies { ... // Add the dependency for the Google services Gradle plugin classpath 'com.google.gms:google-services:4.3.15' } } allprojects { ... repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } }
Dalam file Gradle modul (tingkat aplikasi) Anda (biasanya
<project>/<app-module>/build.gradle
), tambahkan plugin layanan Google: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
Dalam file Gradle modul (level aplikasi) Anda (biasanya
<project>/<app-module>/build.gradle
), tambahkan dependensi untuk produk Firebase yang ingin Anda gunakan di aplikasi Anda. Kami merekomendasikan penggunaan Firebase Android BoM untuk mengontrol pembuatan versi library.Analytics diaktifkan
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:31.2.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-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:31.2.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 pustaka Android Firebase yang kompatibel.
Analytics tidak diaktifkan
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:31.2.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-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:31.2.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 pustaka Android Firebase yang kompatibel.
Setelah menambahkan dependensi untuk produk yang ingin Anda gunakan, sinkronkan proyek Android Anda dengan file Gradle.
Build Gradle yang menggunakan plugin Android Gradle (AGP) v4.2 atau yang lebih lama harus 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 kesalahan ke filebuild.gradle
tingkat aplikasi Anda. - Tingkatkan
minSdkVersion
untuk proyek Android Anda menjadi 26 atau lebih tinggi.
Pelajari lebih lanjut tentang kegagalan build ini di FAQ ini .
- Tambahkan
Itu dia! Anda dapat melompat ke depan untuk melihat langkah selanjutnya yang disarankan .
Namun, jika Anda kesulitan menyiapkannya, kunjungi Pemecahan masalah & FAQ Android .
Opsi 2 : Tambahkan Firebase menggunakan Asisten Firebase
Asisten Firebase mendaftarkan aplikasi Anda dengan proyek Firebase dan menambahkan file, plugin, dan dependensi Firebase yang diperlukan ke proyek Android Anda — semuanya dari dalam Android Studio!
Buka proyek Android Anda di Android Studio, lalu pastikan Anda menggunakan Android Studio versi terbaru dan Asisten Firebase:
- Windows / Linux: Bantuan > Periksa pembaruan
- macOS: Android Studio > Periksa pembaruan
Buka Asisten Firebase: Alat > Firebase .
Di panel Asisten , pilih produk Firebase untuk ditambahkan ke aplikasi Anda. Perluas bagiannya, lalu klik tautan tutorial (misalnya,
Analytics > Log an Analytics event ).Klik Hubungkan ke Firebase untuk menghubungkan proyek Android Anda dengan Firebase.
Alur kerja ini secara otomatis membuat aplikasi Android Firebase baru menggunakan nama paket aplikasi Anda . Anda dapat membuat aplikasi Android Firebase baru ini di proyek Firebase yang sudah ada atau proyek baru.
Berikut adalah beberapa tips tentang menyiapkan proyek Firebase Anda:
Lihat praktik terbaik kami untuk menambahkan aplikasi ke proyek Firebase, termasuk cara menangani berbagai varian.
Jika Anda membuat proyek baru, kami sangat menyarankan agar Anda menyiapkan Google Analytics untuk proyek Anda, yang memungkinkan Anda mendapatkan pengalaman optimal menggunakan banyak produk Firebase.
Alur kerja ini juga menambahkan file konfigurasi Android project Firebase Anda (
) ke direktori modul (level aplikasi) aplikasi Anda.google-services.json
Klik tombol untuk menambahkan produk Firebase yang diinginkan (misalnya,
Tambahkan Analytics ke aplikasi Anda ).
Sinkronkan aplikasi Anda untuk memastikan bahwa semua dependensi memiliki versi yang diperlukan.
Di panel Asisten , ikuti petunjuk penyiapan selanjutnya untuk produk Firebase pilihan Anda.
Tambahkan sebanyak mungkin produk Firebase lainnya melalui Asisten Firebase!
Itu dia! Pastikan untuk memeriksa langkah- langkah selanjutnya yang disarankan.
Namun, jika Anda kesulitan menyiapkannya, kunjungi Pemecahan masalah & FAQ Android .
Pustaka yang tersedia
Bagian ini mencantumkan produk Firebase yang didukung untuk Android dan dependensi Gradle-nya. Pelajari lebih lanjut tentang library Firebase Android ini:
Dokumentasi referensi ( Kotlin+KTX | Java )
Repo GitHub Firebase Android SDK
Perhatikan bahwa saat menggunakan Firebase Android BoM , Anda tidak menentukan versi pustaka individual saat mendeklarasikan dependensi pustaka Firebase di build.gradle
.
Kotlin+KTX
Layanan atau Produk | Ketergantungan bertahap | Terbaru Versi: kapan | Tambahkan Analitik? |
---|---|---|---|
Firebase Android BoM (Bill of material) | com.google.firebase:firebase-bom Versi Firebase BoM terbaru berisi versi terbaru dari setiap library Android Firebase. Untuk mempelajari versi pustaka mana yang dipetakan ke versi BoM tertentu, tinjau catatan rilis untuk versi BoM tersebut. | 31.2.0 | |
AdMob | com.google.android.gms:play-services-ads | 21.5.0 | |
Analitik | com.google.firebase:firebase-analytics-ktx | 21.2.0 | |
Penyedia khusus App Check | com.google.firebase:firebase-appcheck-ktx | 16.1.1 | |
Penyedia debug App Check | com.google.firebase:firebase-appcheck-debug | 16.1.1 | |
Penyedia Integritas Play Check Aplikasi | com.google.firebase:firebase-appcheck-playintegrity | 16.1.1 | |
Distribusi Aplikasi | com.google.firebase:firebase-appdistribution | 16.0.0-beta05 | |
API Distribusi Aplikasi | com.google.firebase:firebase-appdistribution-api-ktx | 16.0.0-beta05 | |
Plugin Distribusi Aplikasi | com.google.firebase:firebase-appdistribution-gradle | 3.2.0 | |
Autentikasi | com.google.firebase:firebase-auth-ktx | 21.1.0 | |
Toko Api Awan | com.google.firebase:firebase-firestore-ktx | 24.4.2 | |
Cloud Functions untuk SDK Klien Firebase | com.google.firebase:firebase-functions-ktx | 20.2.2 | |
Pesan Awan | com.google.firebase:firebase-messaging-ktx | 23.1.1 | |
Penyimpanan awan | com.google.firebase:firebase-storage-ktx | 20.1.0 | |
Crashlytics | com.google.firebase:firebase-crashlytics-ktx | 18.3.3 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.3.3 | |
Plugin Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.2 | |
Dukungan modul fitur dinamis | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta03 | |
Tautan Dinamis | com.google.firebase:firebase-dynamic-links-ktx | 21.1.0 | |
Perpesanan Dalam Aplikasi | com.google.firebase:firebase-inappmessaging-ktx | 20.3.0 | (yg dibutuhkan) |
Tampilan Pesan Dalam Aplikasi | com.google.firebase:firebase-inappmessaging-display-ktx | 20.3.0 | (yg dibutuhkan) |
Instalasi Firebase | com.google.firebase:firebase-installations-ktx | 17.1.0 | |
API Pengunduh Model Firebase ML | com.google.firebase:firebase-ml-modeldownloader-ktx | 24.1.2 | |
Pemantauan Kinerja | com.google.firebase:firebase-perf-ktx | 20.3.1 | |
Plugin Pemantauan Kinerja | com.google.firebase:perf-plugin | 1.4.2 | |
Basis Data Waktu Nyata | com.google.firebase:firebase-database-ktx | 20.1.0 | |
Konfigurasi Jarak Jauh | com.google.firebase:firebase-config-ktx | 21.2.1 | |
Plugin layanan Google Play | com.google.gms:layanan-google | 4.3.15 | |
Pustaka yang tidak digunakan lagi | |||
Penyedia App Check SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.1.1 | |
Pengindeksan Aplikasi | com.google.firebase:firebase-appindexing | 20.0.0 | |
API Model Khusus Firebase ML | 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: 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: API Bahasa Alami | 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 Balasan Cerdas | com.google.firebase:firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Java
Layanan atau Produk | Ketergantungan bertahap | Terbaru Versi: kapan | Tambahkan Analitik? |
---|---|---|---|
Firebase Android BoM (Bill of material) | com.google.firebase:firebase-bom Versi Firebase BoM terbaru berisi versi terbaru dari setiap library Android Firebase. Untuk mempelajari versi pustaka mana yang dipetakan ke versi BoM tertentu, tinjau catatan rilis untuk versi BoM tersebut. | 31.2.0 | |
AdMob | com.google.android.gms:play-services-ads | 21.5.0 | |
Analitik | com.google.firebase:firebase-analytics | 21.2.0 | |
Penyedia khusus App Check | com.google.firebase:firebase-appcheck | 16.1.1 | |
Penyedia debug App Check | com.google.firebase:firebase-appcheck-debug | 16.1.1 | |
Penyedia Integritas Play Check Aplikasi | com.google.firebase:firebase-appcheck-playintegrity | 16.1.1 | |
Distribusi Aplikasi | com.google.firebase:firebase-appdistribution | 16.0.0-beta05 | |
API Distribusi Aplikasi | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta05 | |
Plugin Distribusi Aplikasi | com.google.firebase:firebase-appdistribution-gradle | 3.2.0 | |
Autentikasi | com.google.firebase:firebase-auth | 21.1.0 | |
Toko Api Awan | com.google.firebase:firebase-firestore | 24.4.2 | |
Cloud Functions untuk SDK Klien Firebase | com.google.firebase:fungsi-firebase | 20.2.2 | |
Pesan Awan | com.google.firebase:firebase-messaging | 23.1.1 | |
Penyimpanan awan | com.google.firebase:firebase-storage | 20.1.0 | |
Crashlytics | com.google.firebase:firebase-crashlytics | 18.3.3 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.3.3 | |
Plugin Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.2 | |
Dukungan modul fitur dinamis | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta03 | |
Tautan Dinamis | com.google.firebase:tautan-dinamis-firebase | 21.1.0 | |
Perpesanan Dalam Aplikasi | com.google.firebase:firebase-inappmessaging | 20.3.0 | (yg dibutuhkan) |
Tampilan Pesan Dalam Aplikasi | com.google.firebase:firebase-inappmessaging-display | 20.3.0 | (yg dibutuhkan) |
Instalasi Firebase | com.google.firebase:instalasi-firebase | 17.1.0 | |
API Pengunduh Model Firebase ML | com.google.firebase:firebase-ml-modeldownloader | 24.1.2 | |
Pemantauan Kinerja | com.google.firebase:firebase-perf | 20.3.1 | |
Plugin Pemantauan Kinerja | com.google.firebase:perf-plugin | 1.4.2 | |
Basis Data Waktu Nyata | com.google.firebase:firebase-database | 20.1.0 | |
Konfigurasi Jarak Jauh | com.google.firebase:firebase-config | 21.2.1 | |
Plugin layanan Google Play | com.google.gms:layanan-google | 4.3.15 | |
Pustaka yang tidak digunakan lagi | |||
Penyedia App Check SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.1.1 | |
Pengindeksan Aplikasi | com.google.firebase:firebase-appindexing | 20.0.0 | |
API Model Khusus Firebase ML | 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: 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: API Bahasa Alami | 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 Balasan Cerdas | com.google.firebase:firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Langkah selanjutnya
Tambahkan layanan Firebase ke aplikasi Anda:
Dapatkan wawasan tentang perilaku pengguna dengan Analytics .
Siapkan alur autentikasi pengguna dengan Authentication .
Menyimpan 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 yang aman dengan Cloud Functions .
Kirim notifikasi dengan Cloud Messaging .
Cari tahu kapan dan mengapa aplikasi Anda mogok dengan Crashlytics .
Pelajari tentang Firebase:
Kunjungi Memahami Proyek Firebase untuk mempelajari lebih lanjut tentang proyek Firebase dan praktik terbaik untuk proyek.
Kunjungi Pelajari lebih lanjut tentang Android dan Firebase jika Anda memiliki pertanyaan tentang konsep yang tidak familier atau khusus untuk pengembangan Firebase dan Android.
Jelajahi contoh aplikasi Firebase .
Dapatkan pengalaman langsung dengan Firebase Android Codelab .
Pelajari lebih lanjut dengan Firebase dalam kursus Akhir Pekan .
Bersiaplah untuk meluncurkan aplikasi Anda:
- Siapkan peringatan anggaran untuk proyek Anda di Google Cloud Console.
- Pantau dasbor Penggunaan dan penagihan di Firebase console untuk mendapatkan gambaran keseluruhan tentang penggunaan proyek Anda di berbagai layanan Firebase.
- Tinjau daftar periksa peluncuran Firebase .
Mengalami masalah dengan Firebase dan proyek Android Anda? Kunjungi Pemecahan masalah & FAQ Android .