Memigrasikan login dengan link email dari Firebase Dynamic Links (Android)

Autentikasi link email sebelumnya mengandalkan Firebase Dynamic Links, yang akan dinonaktifkan pada 25 Agustus 2025. Kami telah memublikasikan solusi alternatif di Firebase Authentication Android SDK versi 23.2.0+ dan Firebase BoM versi 33.9.0+. Jika aplikasi Anda menggunakan link gaya lama dan Anda ingin menggunakan metode alternatif untuk memigrasikan aplikasi, lihat Melakukan autentikasi dengan Firebase menggunakan Link Email di Android untuk menggunakan sistem berbasis Firebase Hosting yang baru.

Selain itu, jika Anda menggunakan Firebase Authentication Android SDK dengan versi di bawah v20.0.0 (atau Firebase BoM di bawah v26.0.0) untuk mengelola alur OAuth dengan Firebase Authentication, Anda harus mengupdate ke versi Authentication SDK atau BoM terbaru (Authentication v20.0.0+ atau BoM v26.0.0+) untuk terus mengelola alur OAuth di Firebase Authentication.

Memigrasikan domain Firebase Dynamic Links terkait ke domain Firebase Hosting

Ke depannya, Firebase Authentication akan menggunakan domain default Firebase Hosting untuk project Anda, bukan menggunakan domain Firebase Dynamic Links, untuk membuat link untuk link email dan tindakan link out-of-band lainnya di aplikasi seluler. Artinya, aplikasi Anda juga perlu diupdate untuk menggunakan domain default ini sebagai domain terkait untuk link autentikasi email ke aplikasi seluler Anda.

Anda dapat mengikuti petunjuk di artikel Melakukan Autentikasi dengan Firebase Menggunakan Link Email di Android untuk memperbarui link aplikasi seluler agar menggunakan domain default Firebase Hosting baru yang disediakan secara otomatis.

Gunakan petunjuk berikut untuk menangani link dari domain baru dan untuk memberi tahu Firebase Authentication agar mulai menggunakan domain baru untuk membuat link aplikasi seluler ke depannya.

Jika Anda ingin terus menggunakan domain Firebase Hosting kustom atau bahkan domain Firebase Dynamic Links kustom sebagai domain terkait baru, ikuti langkah-langkah yang cocok dengan domain yang ingin Anda gunakan. Perhatikan bahwa setelah menyelesaikan petunjuk di bagian berikut, fitur deep linking di domain kustom Firebase Dynamic Links Anda akan dihapus; hanya domain itu sendiri yang akan tetap ada untuk membuat link email.

1. Mengonfigurasi aplikasi Android untuk menangani link Firebase Hosting

   1. Untuk menangani link ini dari aplikasi Android, Anda harus menentukan nama paket aplikasi di setelan project Firebase console. Selain itu, SHA-1 dan SHA-256 sertifikat aplikasi harus dimasukkan.

   2. Jika ingin link Firebase Hosting ini dialihkan ke aktivitas tertentu, Anda harus mengonfigurasi filter intent di file AndroidManifest.xml. Filter intent harus menangkap Firebase Hosting link domain Anda. Di AndroidManifest.xml:

      <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data
          android:scheme="https"
          android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
          android:pathPrefix="/__/auth/links" />
      </intent-filter>
      

   Saat pengguna membuka link hosting dengan jalur "/__/auth/links" serta skema dan host yang Anda tentukan, aplikasi Anda akan memulai aktivitas dengan filter intent ini untuk menangani link tersebut.

   Penting: Untuk memastikan rollback yang lancar, sebaiknya simpan filter intent yang ada yang menangani Firebase Dynamic Links saat mencoba solusi link Firebase Hosting. Solusi Firebase Dynamic Links akan tersedia hingga 25 Agustus 2025.

2. Mengonfigurasi project untuk menggunakan link baru

   Jika sudah siap menangani link domain baru, Anda dapat menggunakan Firebase Admin SDK untuk memperbarui cara dalam pembuatan link email dan menginstruksikan backend kami untuk mulai membuat link menggunakan domain Firebase Hosting baru.

   const updateRequest = {
     mobileLinksConfig: {
         domain: 'HOSTING_DOMAIN'
     }
   }
   const updateProjectConfig = () => {
     projectConfigManager.updateProjectConfig(updateRequest)
     .then((response) => {
         // updated project config
     }).catch((error) => {
         console.log('Error updating the project:', error);
     });
   }
   

   Penting: Untuk melakukan rollback ke Firebase Dynamic Links saat menerapkan dan menguji solusi pencadangan, Anda harus menetapkan domain kembali ke FIREBASE_DYNAMIC_LINK. Solusi Firebase Dynamic Links akan tersedia hingga 25 Agustus 2025.

3. Mengirim dan menukarkan link email

   Kirim link login email seperti sebelumnya. Saat pengguna akhir mengklik link, mereka akan dialihkan ke aplikasi jika sudah diinstal untuk menyelesaikan login.

Menyesuaikan link seluler

Anda dapat menggunakan domain Firebase Hosting kustom atau menggunakan kembali domain Firebase Dynamic Links kustom sebagai domain link seluler baru.

Menggunakan domain Firebase Hosting kustom

1. Ikuti panduan Firebase Hosting untuk menyiapkan domain kustom.
2. Konfigurasikan aplikasi Android untuk menangani link Firebase Hosting. (petunjuk di bagian sebelumnya di atas).
3. Kirim link autentikasi ke alamat email pengguna dengan objek ActionCodeSettings yang diperbarui dengan domain kustom sebagai linkDomain.

Menggunakan kembali domain Firebase Dynamic Links kustom

1. Anda dapat menggunakan kembali domain Firebase Dynamic Links sebagai domain kustom. Namun, semua fungsi Firebase Dynamic Links tidak akan lagi didukung (misalnya, pengguna tidak dapat dialihkan ke app store jika aplikasi tidak diinstal di perangkat mereka).
2. Konfigurasikan aplikasi Android untuk menangani link Firebase Hosting (petunjuk di bagian sebelumnya di atas).
3. Kirim link autentikasi ke alamat email pengguna dengan objek ActionCodeSettings yang diperbarui dengan domain kustom sebagai linkDomain.