ย้ายข้อมูลการลงชื่อเข้าใช้ด้วยลิงก์อีเมลออกจากลิงก์แบบไดนามิกของ 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 เวอร์ชันต่ำกว่า 20.0.0 (หรือ Firebase BoM เวอร์ชันต่ำกว่า 26.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 Authentication จะใช้โดเมนเริ่มต้น Firebase Hosting สำหรับโปรเจ็กต์ของคุณเพื่อสร้างลิงก์สำหรับลิงก์ในอีเมลและการดําเนินการกับลิงก์นอกแบนด์อื่นๆ ในแอปบนอุปกรณ์เคลื่อนที่แทนการใช้โดเมน Firebase Dynamic Links ซึ่งหมายความว่าแอปของคุณจะต้องอัปเดตเพื่อใช้โดเมนเริ่มต้นนี้เป็นโดเมนที่เชื่อมโยงสำหรับลิงก์การตรวจสอบสิทธิ์อีเมลไปยังแอปบนอุปกรณ์เคลื่อนที่ด้วย

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

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

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

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

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

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

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

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

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

   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);
     });
   }
   

   สำคัญ: หากต้องการเปลี่ยนกลับไปใช้ Firebase Dynamic Links ขณะติดตั้งใช้งานและทดสอบโซลูชันการสำรองข้อมูล คุณควรตั้งค่าโดเมนกลับไปเป็น FIREBASE_DYNAMIC_LINK โซลูชัน Firebase Dynamic Links จะพร้อมให้บริการจนถึงวันที่ 25 สิงหาคม 2025

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