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

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

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

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

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

คุณสามารถทำตามวิธีการใน การตรวจสอบสิทธิ์ด้วย Firebase โดยใช้ลิงก์อีเมลใน Android เพื่ออัปเดตลิงก์แอปบนอุปกรณ์เคลื่อนที่ ให้ใช้โดเมนเริ่มต้นที่จัดสรรให้โดยอัตโนมัติ 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>
      

   เมื่อผู้ใช้เปิดลิงก์ Hosting ที่มีเส้นทาง "/__/auth/links" รวมถึง Scheme และโฮสต์ที่คุณระบุ แอปจะเริ่มกิจกรรมด้วยตัวกรอง 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