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

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

คุณทําตามวิธีการใน ตรวจสอบสิทธิ์ด้วย 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>
      

   เมื่อผู้ใช้เปิดลิงก์การโฮสต์ที่มีเส้นทาง "/__/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