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

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

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

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

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

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

หากต้องการใช้โดเมน Firebase Hosting ที่กำหนดเองหรือแม้แต่โดเมน Firebase Dynamic Links ที่กำหนดเองต่อไปเป็นโดเมนที่เชื่อมโยงใหม่ ให้ใช้คำแนะนำในส่วนปรับแต่ง Mobile Link โดยปรับขั้นตอนให้ตรงกับโดเมนที่ต้องการใช้

  1. ลิงก์โดเมน Firebase Hosting กับโดเมนที่เชื่อมโยงกับแอป

    คุณจะต้องกำหนดค่าโดเมนที่เลือกเป็นโดเมนที่เชื่อมโยงสำหรับ App Link หากต้องการตั้งค่าการให้สิทธิ์ในแอป ให้เปิดแท็บ Signing & Capabilities ของเป้าหมายใน Xcode แล้วเพิ่มโดเมน Firebase Hosting จากขั้นตอนก่อนหน้าลงในความสามารถของโดเมนที่เชื่อมโยง หากใช้โดเมน Firebase Hosting เริ่มต้น โดเมนนี้จะเป็น applinks:PROJECT_ID.firebaseapp.com

    ดูข้อมูลเพิ่มเติมได้ที่การรองรับโดเมนที่เชื่อมโยงในเว็บไซต์เอกสารประกอบของ Apple

    ระบบได้ติดตั้งใช้งานไฟล์โดเมนที่เชื่อมโยงภายใต้โดเมน Firebase Hosting ทั้งหมดของคุณแล้ว หากต้องการเข้าถึง ให้ไปที่ PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association ไฟล์ AASA นี้สามารถเขียนทับได้ ดูข้อมูลเพิ่มเติมได้ที่สร้างและโฮสต์ไฟล์การกำหนดค่า Universal Link

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