Saat mengembangkan proyek Android menggunakan Firebase, Anda mungkin menemukan konsep yang tidak familier atau khusus untuk Firebase. Halaman ini bertujuan untuk menjawab pertanyaan tersebut atau mengarahkan Anda ke sumber daya untuk mempelajari lebih lanjut.
Jika Anda memiliki pertanyaan tentang topik yang tidak dibahas di halaman ini, silakan kunjungi salah satu komunitas online kami . Kami juga akan memperbarui halaman ini dengan topik baru secara berkala, jadi periksa kembali untuk melihat apakah kami telah menambahkan topik yang ingin Anda pelajari!
Plugin Asisten Firebase untuk Android Studio
Firebase Assistant adalah plugin Android Studio yang mendaftarkan aplikasi Android Anda dengan proyek Firebase dan menambahkan file konfigurasi, plugin, dan dependensi Firebase yang diperlukan ke proyek Android Anda — semuanya dari dalam Android Studio!
Ikuti petunjuk di halaman memulai Android untuk menggunakan Firebase Assistant. Pastikan Anda menggunakan Android Studio dan Firebase Assistant versi terbaru (buka File > Check for updates ).
Saat Anda memilih produk Firebase tertentu untuk ditambahkan ke aplikasi Anda, Firebase Assistant secara otomatis mendeklarasikan dependensi yang diperlukan dalam file app/build.gradle
Anda. Namun, untuk menggunakan fitur Firebase yang berada di luar kemampuan Firebase Assistant saat ini, Anda mungkin ingin membuat beberapa perubahan manual pada dependensi ini:
Jika Anda ingin menggunakan Firebase Android BoM , perbarui dependensi dalam file Gradle modul (level aplikasi) Anda (biasanya
app/build.gradle
) untuk mengimpor platform BoM. Anda juga harus menghapus versi dari setiap baris dependensi pustaka Firebase.Jika Anda ingin menggunakan library ekstensi Kotlin , ubah baris dependensi yang ditambahkan ke file Gradle modul (level aplikasi) Anda (biasanya
app/build.gradle
) untuk menggunakan library Firebase versiktx
.
Layanan Google — file plugin dan konfigurasi
Sebagai bagian dari penambahan Firebase ke project Android, Anda perlu menambahkan plugin google- google-services
dan file konfigurasi
ke project Anda.
Jika Anda menambahkan Firebase ke proyek Android melalui Firebase console , Management REST API , atau Firebase CLI , Anda harus menambahkan plugin dan file konfigurasi secara manual ke proyek Anda. Namun, jika Anda menggunakan Firebase Assistant , tugas ini otomatis dilakukan untuk Anda selama penyiapan.
Kunjungi dokumentasi Android untuk mempelajari tentang bagaimana plugin layanan Google dan file konfigurasi bekerja sama.
Firebase Android BoM (Bill of Material)
Firebase Android BoM (Bill of Materials) memungkinkan Anda mengelola semua versi pustaka Firebase dengan hanya menentukan satu versi — versi BoM.
Saat Anda menggunakan Firebase BoM di aplikasi Anda, BoM secara otomatis menarik versi perpustakaan individual yang dipetakan ke versi BoM. Semua versi perpustakaan individual akan kompatibel. Saat Anda memperbarui versi BoM di aplikasi, semua pustaka Firebase yang Anda gunakan di aplikasi akan diperbarui ke versi yang dipetakan ke versi BoM tersebut.
Untuk mempelajari versi pustaka Firebase mana yang dipetakan ke versi BoM tertentu, lihat catatan rilis untuk versi BoM tersebut. Jika Anda perlu membandingkan versi pustaka yang dipetakan ke satu versi BoM dibandingkan dengan versi BoM lainnya, gunakan widget perbandingan di bawah ini.
Pelajari lebih lanjut tentang dukungan Gradle untuk platform BoM .
Berikut cara menggunakan Firebase Android BoM untuk mendeklarasikan dependensi dalam file Gradle modul (level aplikasi) Anda (biasanya app/build.gradle
). Saat menggunakan BoM, Anda tidak menentukan versi pustaka individual di baris ketergantungan.
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Declare the dependencies for the desired Firebase products without specifying versions // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Berikut adalah beberapa pertanyaan umum tentang penggunaan Firebase Android BoM:
Berikut cara mengganti versi pustaka yang ditentukan di BoM:
Pertahankan jalur untuk mengimpor platform BoM.
Di baris dependensi pustaka, tentukan versi pustaka yang diinginkan. Misalnya, berikut ini cara mendeklarasikan dependensi jika Anda ingin menggunakan Pengindeksan Aplikasi v18.0.0 apa pun versi yang ditetapkan di BoM, tetapi Anda ingin menggunakan versi BoM untuk Otentikasi dan Cloud Firestore:
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Declare the dependency for the App Indexing library and specify a version // This specified library version overrides the version designated in the BoM. implementation 'com.google.firebase:firebase-appindexing:18.0.0' // Declare the dependencies for the other Firebase libraries without specifying versions // These libraries will use the versions designated in the BoM. implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Tidak. Untuk benar-benar menambahkan dan menggunakan pustaka Firebase di aplikasi, Anda harus mendeklarasikan setiap pustaka sebagai baris dependensi terpisah dalam file Gradle modul (level aplikasi) Anda (biasanya app/build.gradle
).
Menggunakan BoM memastikan bahwa versi pustaka Firebase apa pun di aplikasi Anda kompatibel, tetapi BoM tidak benar-benar menambahkan pustaka Firebase tersebut ke aplikasi Anda.
Ya! Saat Anda mendeklarasikan baris dependensi pustaka Firebase spesifik, cukup gunakan nama pustaka KTX, seperti:
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.0') // Declare the dependencies for the desired Firebase products, without specifying versions // 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' }
Tidak. Firebase Android BoM hanya mengelola versi pustaka untuk pustaka Firebase. Satu-satunya pengecualian adalah penyertaan Google Mobile Ads SDK karena sangat umum digunakan di aplikasi Firebase.
Meskipun setiap pustaka Firebase dibuat versinya sendiri-sendiri, mereka dibangun bersama untuk memastikan bahwa rilis terbaru setiap pustaka kompatibel dengan yang lain.
Dengan menggunakan BoM untuk mengelola versi pustaka Firebase aplikasi Anda, Anda tidak perlu melacak versi pustaka Firebase mana yang kompatibel dengan pustaka Firebase lainnya.
Bahkan jika Anda hanya menggunakan satu pustaka Firebase di aplikasi Anda saat ini, kami tetap menyarankan untuk menggunakan BoM karena Anda tidak pernah tahu kapan Anda ingin menggunakan pustaka Firebase lainnya!
Ya, Anda masih bisa menggunakan BoM! Untuk Gradle 5.0 dan yang lebih baru, dukungan BoM diaktifkan secara otomatis. Namun, untuk versi Gradle sebelumnya, Anda hanya perlu mengaktifkan fitur BoM dan mengimpor BoM sedikit berbeda.
Ke file
settings.gradle
Anda, tambahkanenableFeaturePreview('IMPROVED_POM_SUPPORT')
.Ke file Gradle modul (level aplikasi) Anda (biasanya
app/build.gradle
), impor BoM seperti library normal (tanpa pengubahplatform
), seperti:dependencies { // Import the Firebase BoM implementation 'com.google.firebase:firebase-bom:31.2.0' // Declare the dependencies for the desired Firebase products, without specifying versions // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kunjungi repo Firebase Android SDK di GitHub .
Bandingkan versi Firebase BoM
Library ekstensi Kotlin (KTX).
Pustaka ekstensi Firebase Kotlin (KTX) adalah pelengkap kecil untuk SDK Firebase dasar yang memungkinkan Anda menulis kode Kotlin yang indah dan idiomatis.
Untuk menggunakan library KTX di aplikasi Anda, ubah dependensi Anda untuk menyertakan akhiran -ktx
. Setiap library KTX secara otomatis memiliki dependensi pada library dasar, sehingga tidak perlu menyertakan kedua dependensi tersebut di aplikasi Anda.
dependencies { // Import the BoM for the Firebase platform (learn more) implementation platform('com.google.firebase:firebase-bom:31.2.0')// Declare the base library implementation 'com.google.firebase:firebase-analytics'// Declare the KTX library instead (which automatically has a dependency on the base library) implementation 'com.google.firebase:firebase-analytics-ktx' }
Setiap pustaka KTX menyediakan ekstensi sintaksis yang berbeda dari pustaka dasar. Misalnya, library KTX Analytics memudahkan pencatatan peristiwa ke dalam log:
Sebelumnya (menggunakan perpustakaan dasar)
val analytics = FirebaseAnalytics.getInstance(); val bundle = Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); analytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM, bundle);
Setelah (sebagai gantinya menggunakan perpustakaan KTX)
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Semua produk Firebase menawarkan pustaka KTX kecuali untuk Firebase ML dan Pengindeksan Aplikasi.
Jika Anda belum melakukannya, periksa dokumen referensi API untuk pustaka KTX.
Modul fitur dan Play Feature Delivery
Mulai Mei 2021 (Firebase BoM v28.0.0), Firebase Android SDK dapat digunakan dalam modul fitur dinamis yang dipasang terpisah dari modul aplikasi dasar Anda.
Untuk mengaktifkan dukungan untuk modul fitur dinamis, tambahkan dependensi berikut ke file build.gradle
modul dasar Anda:
dependencies {
implementation 'com.google.firebase:firebase-dynamic-module-support:16.0.0-beta03'
}
Sekarang setelah Anda menambahkan dukungan modul dinamis, Anda dapat menambahkan dependensi Firebase SDK (dengan atau tanpa Firebase BoM) untuk menampilkan modul aplikasi Anda dan menggunakannya seperti biasa.
Misalnya, jika aplikasi Anda menggunakan Realtime Database untuk menjalankan fitur realtime tertentu, Anda dapat menambahkan dependensi firebase-database
ke build.gradle
modul fitur, bukan modul dasar. Ini akan mengurangi ukuran unduhan untuk sebagian besar pengguna.
Waspadai peringatan berikut saat menggunakan Firebase SDK dalam modul fitur:
Produk seperti Dynamic Links atau Firebase In-App Messaging yang mengandalkan peristiwa
first_open
Analytics mungkin melewatkan peristiwa ini saat digunakan dalam modul fitur dinamis.Saat menggunakan Cloud Firestore dan Authentication secara bersamaan, Anda harus selalu menyertakan keduanya dalam modul yang sama. Jika ini tidak memungkinkan, pastikan Authentication dimuat sebelum Cloud Firestore; jika tidak, beberapa operasi Cloud Firestore mungkin memiliki status autentikasi yang salah.
Saat menggunakan
firebase-crashlytics-ndk
sebagai dependensi modul fitur dinamis, Anda perlu menyetel propertiunstrippedNativeLibsDir
di filebuild.gradle
aplikasi Anda, seperti yang dijelaskan dalam dokumentasi Crashlytics NDK .
Untuk informasi selengkapnya tentang modul fitur dan Play Feature Delivery, kunjungi Ikhtisar Play Feature Delivery .
Plugin Gradle layanan Google vs layanan Google Play vs Google Play Store
Beberapa bagian ekosistem Google, Firebase, dan Android memiliki konvensi penamaan yang serupa. Berikut penjelasan singkat untuk masing-masing:
- Plugin Gradle layanan Google
- Plugin Gradle (
com.google.gms.google-services
) yang berjalan pada waktu build untuk memastikan bahwa aplikasi Anda memiliki konfigurasi yang tepat untuk mengakses Firebase dan Google API - Terlepas dari namanya, plugin ini tidak ada kaitannya dengan layanan Google Play (lihat entri berikutnya) dan tidak berdampak pada kemampuan aplikasi Anda saat runtime.
- Plugin ini juga memproses file
google-services.json
yang Anda tambahkan ke aplikasi sebagai bagian dari penyiapan Firebase. Pelajari lebih lanjut plugin Gradle layanan Google . - Layanan Google Play
- Layanan latar belakang tak terlihat yang berjalan di perangkat Android dan menyediakan beberapa Google API umum (seperti Google Maps dan Google Sign In) ke aplikasi di perangkat
- Dengan memusatkan API umum ini ke dalam satu layanan, ini mengurangi ukuran aplikasi lain dan memungkinkan perangkat menerima pembaruan keamanan otomatis dan peningkatan fitur tanpa pembaruan OS. Pelajari lebih lanjut tentang layanan Google Play .
- Toko Google Play
- Toko untuk mengunduh aplikasi, film, buku, dan lainnya di perangkat Android
- Sebagai developer, Anda mengelola distribusi, rilis, dll. untuk aplikasi Anda melalui Konsol Google Play. Jika suatu perangkat memiliki Google Play Store, perangkat tersebut juga menjalankan layanan Google Play (lihat entri sebelumnya). Pelajari lebih lanjut tentang Google Play Store untuk pengembang .
- Layanan Google Play Game
- Satu set API untuk pengembang game seluler
- Pelajari lebih lanjut tentang layanan Google Play Game dan cara mengintegrasikan Firebase dengan proyek layanan Google Play Game Anda .
Resource open source untuk Firebase Android SDK
Firebase mendukung pengembangan sumber terbuka, dan kami mendorong kontribusi dan masukan dari komunitas.
Firebase Android SDK
Sebagian besar Firebase Android SDK dikembangkan sebagai pustaka open source di repositori publik Firebase GitHub kami. Kami sedang berupaya secara aktif untuk segera memindahkan pustaka Firebase yang dikembangkan secara pribadi ke GitHub publik kami!
Sampel quickstart
Firebase menyimpan kumpulan contoh quickstart untuk sebagian besar API Firebase di Android. Temukan quickstart ini di repositori quickstart Firebase GitHub publik kami.
Anda dapat membuka setiap quickstart sebagai project Android Studio, lalu menjalankannya di perangkat seluler atau perangkat virtual (AVD). Atau Anda dapat menggunakan quickstart ini sebagai contoh kode untuk menggunakan Firebase SDK.
Topik menarik lainnya
- Dependensi Firebase Android SDK pada layanan Google Play
- Tautkan aplikasi Firebase Anda ke Google Play
- Integrasikan dengan proyek layanan Play Game Anda