ย้ายข้อมูลการลงชื่อเข้าใช้ด้วยลิงก์อีเมลออกจากลิงก์แบบไดนามิกของ Firebase (Android)

ก่อนหน้านี้ การตรวจสอบสิทธิ์ลิงก์อีเมลอาศัย Firebase Dynamic Links ซึ่งจะปิดให้บริการในวันที่ 25 สิงหาคม 2025 เราได้เผยแพร่โซลูชันทางเลือกใน Firebase Authentication Android SDK เวอร์ชัน 23.2.0 ขึ้นไปและ Firebase BoM เวอร์ชัน 33.9.0 ขึ้นไป หากแอปของคุณใช้ลิงก์รูปแบบเก่าและคุณต้องการใช้วิธีอื่นในการย้ายข้อมูลแอป โปรดดูตรวจสอบสิทธิ์ด้วย Firebase โดยใช้ลิงก์อีเมลใน Android เพื่อใช้ระบบที่อิงตาม Firebase Hosting ใหม่

นอกจากนี้ หากคุณใช้ Android SDK ของ Firebase Authentication ที่ต่ำกว่าเวอร์ชัน 20.0.0 (หรือ Firebase BoM ที่ต่ำกว่าเวอร์ชัน 26.0.0) เพื่อจัดการขั้นตอน OAuth ด้วย Firebase Authentication คุณจะต้องอัปเดตเป็น SDK ของ Authentication หรือเวอร์ชัน BoM ล่าสุด (Authentication เวอร์ชัน 20.0.0 ขึ้นไปหรือ BoM เวอร์ชัน 26.0.0 ขึ้นไป) เพื่อจัดการขั้นตอน OAuth ใน Firebase Authentication ต่อไป

ย้ายข้อมูลโดเมน Firebase Dynamic Links ที่เชื่อมโยงไปยังโดเมน Firebase Hosting

นับจากนี้ไป Firebase Authentication จะใช้โดเมนเริ่มต้น Firebase Hosting สำหรับโปรเจ็กต์ของคุณเพื่อสร้างลิงก์สำหรับลิงก์อีเมลและการดำเนินการลิงก์นอกแบนด์อื่นๆ ในแอปบนอุปกรณ์เคลื่อนที่ แทนที่จะใช้โดเมน Firebase Dynamic Links ซึ่งหมายความว่าคุณจะต้องอัปเดตแอปเพื่อใช้โดเมนเริ่มต้นนี้เป็นโดเมนที่เชื่อมโยงสำหรับลิงก์การตรวจสอบสิทธิ์อีเมลไปยังแอปบนอุปกรณ์เคลื่อนที่ด้วย

คุณสามารถทำตามวิธีการในตรวจสอบสิทธิ์ด้วย Firebase โดยใช้ลิงก์อีเมลใน Android เพื่ออัปเดต Mobile App Link ให้ใช้โดเมนเริ่มต้น Firebase Hosting ที่จัดสรรโดยอัตโนมัติใหม่

ใช้คำแนะนำต่อไปนี้เพื่อจัดการลิงก์จากโดเมนใหม่และเพื่อสั่งให้ Firebase Authentication เริ่มใช้โดเมนใหม่เพื่อสร้างลิงก์แอปบนอุปกรณ์เคลื่อนที่ต่อไป

หากต้องการใช้โดเมน Firebase Hosting ที่กำหนดเองหรือแม้แต่โดเมน Firebase Dynamic Links ที่กำหนดเองต่อไปเป็นโดเมนใหม่ที่เชื่อมโยง ให้ทำตามขั้นตอนที่ตรงกับโดเมนที่ต้องการใช้ โปรดทราบว่าหลังจากทำตามวิธีการในส่วนต่อไปนี้แล้ว ระบบจะนำฟีเจอร์การทำ Deep Link ในโดเมนที่กำหนดเอง Firebase Dynamic Links ออก โดยจะเหลือเพียงโดเมนสำหรับการสร้างลิงก์อีเมลเท่านั้น

1. กำหนดค่าแอปพลิเคชัน Android ให้จัดการลิงก์ Firebase Hosting

   1. หากต้องการจัดการลิงก์เหล่านี้จากแอปพลิเคชัน Android คุณต้องระบุชื่อแพ็กเกจของแอปในการตั้งค่าโปรเจ็กต์คอนโซล Firebase นอกจากนี้ คุณต้องระบุ SHA-1 และ SHA-256 ของใบรับรองแอปพลิเคชันด้วย

   2. หากต้องการให้ลิงก์ Firebase Hosting เหล่านี้เปลี่ยนเส้นทางไปยังกิจกรรมที่เฉพาะเจาะจง คุณจะต้องกำหนดค่าตัวกรอง Intent ในไฟล์ AndroidManifest.xml ตัวกรอง Intent ควรตรวจจับลิงก์ Firebase Hosting ของโดเมนคุณ ใน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>
      

   เมื่อผู้ใช้เปิดลิงก์โฮสติ้งที่มีเส้นทาง "/__/auth/links" รวมถึงรูปแบบและโฮสต์ที่คุณระบุ แอปจะเริ่มกิจกรรมด้วยตัวกรอง Intent นี้เพื่อจัดการลิงก์

2. กำหนดค่าโปรเจ็กต์ให้ใช้ลิงก์ใหม่

   เมื่อพร้อมที่จะจัดการลิงก์โดเมนใหม่แล้ว คุณสามารถใช้ Firebase Admin SDK เพื่ออัปเดตวิธีสร้างลิงก์อีเมลและสั่งให้แบ็กเอนด์เริ่มสร้างลิงก์โดยใช้โดเมน Firebase Hosting ใหม่ได้

   import { getAuth } from 'firebase-admin/auth';
   
   const updateEmailAuthDomain = async () => {
     const updateRequest = {
       mobileLinksConfig: {
         domain: 'HOSTING_DOMAIN',
       },
     };
   
     const projectConfigManager = getAuth().projectConfigManager();
   
     try {
       const response = await projectConfigManager.updateProjectConfig(updateRequest);
       // Updated project config
       console.log('Project configuration updated successfully:', response);
     } catch (error) {
       console.error('Error updating the project:', error);
     }
   };
   

3. ส่งและแลกสิทธิ์ลิงก์อีเมล

   ส่งลิงก์ลงชื่อเข้าใช้ทางอีเมลเหมือนเดิม เมื่อผู้ใช้ปลายทางคลิกลิงก์ ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังแอปหากติดตั้งไว้เพื่อลงชื่อเข้าใช้ให้เสร็จสมบูรณ์

ปรับแต่งลิงก์ในอุปกรณ์เคลื่อนที่

คุณสามารถใช้โดเมน Firebase Hosting ที่กำหนดเองหรือใช้โดเมน Firebase Dynamic Links ที่กำหนดเองซ้ำเพื่อเป็นโดเมนลิงก์ในอุปกรณ์เคลื่อนที่ใหม่ได้

ใช้โดเมน Firebase Hosting ที่กำหนดเอง

1. ทำตามคู่มือ Firebase Hosting เพื่อตั้งค่าโดเมนที่กำหนดเอง
2. กำหนดค่าแอปพลิเคชัน Android ให้จัดการลิงก์ Firebase Hosting (วิธีการในส่วนก่อนหน้าด้านบน)
3. ส่งลิงก์การตรวจสอบสิทธิ์ไปยังอีเมลของผู้ใช้พร้อมออบเจ็กต์ ActionCodeSettings ที่อัปเดตแล้วซึ่งมีโดเมนที่กำหนดเองเป็น linkDomain

ใช้โดเมน Firebase Dynamic Links ที่กำหนดเองซ้ำ

1. คุณสามารถใช้โดเมน Firebase Dynamic Links ใดก็ได้ซ้ำเป็นโดเมนที่กำหนดเอง อย่างไรก็ตาม ระบบจะไม่รองรับฟังก์ชันการทำงานของ Firebase Dynamic Links อีกต่อไป (เช่น ผู้ใช้จะไม่ได้รับการเปลี่ยนเส้นทางไปยัง App Store หากไม่ได้ติดตั้งแอปในอุปกรณ์)
2. กำหนดค่าแอปพลิเคชัน Android ให้จัดการลิงก์ Firebase Hosting (วิธีการอยู่ในส่วนก่อนหน้าด้านบน)
3. ส่งลิงก์การตรวจสอบสิทธิ์ไปยังอีเมลของผู้ใช้พร้อมออบเจ็กต์ ActionCodeSettings ที่อัปเดตแล้วซึ่งมีโดเมนที่กำหนดเองเป็น linkDomain