העברת הכניסה באמצעות קישור לאימייל מקישורים דינמיים ב-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 Dynamic Links, Firebase Authentication ישתמש בדומיין ברירת המחדל Firebase Hosting של הפרויקט שלך כדי ליצור קישורים לקישור באימייל ולפעולות אחרות של קישורים מחוץ לרשת באפליקציות לנייד. זה אומר שתצטרכו לעדכן גם את האפליקציה כדי להשתמש בדומיין ברירת המחדל הזה בתור הדומיין המשויך לקישורי אימות באימייל לאפליקציה לנייד.

כדי לעדכן את האפליקציה כך שתשתמש בדומיין ברירת המחדל החדש שמוקצה באופן אוטומטי, אתם יכולים לפעול לפי ההוראות במאמר אימות באמצעות Firebase באמצעות קישור לאימייל בפלטפורמות של Apple.Firebase Hosting

כדי לטפל בקישורים מהדומיין החדש ולהורות ל-Firebase Authentication להתחיל להשתמש בדומיין Firebase Hosting כדי ליצור קישורים לאפליקציה לנייד, צריך לפעול לפי ההוראות הבאות.

אם אתם רוצים להמשיך להשתמש בדומיינים המותאמים אישית של Firebase Hosting או אפילו בדומיין המותאם אישית של Firebase Dynamic Links בתור הדומיין המשויך החדש, אתם יכולים לפעול לפי ההוראות בקטע התאמה אישית של קישורים לנייד ולהתאים את השלבים לדומיין שבו אתם רוצים להשתמש.

  1. מקשרים את הדומיין של Firebase Hosting לדומיין שמשויך לאפליקציה.

    צריך להגדיר את הדומיין שנבחר כדומיין משויך לקישורים לאפליקציות. כדי להגדיר את ההרשאה באפליקציה, פותחים את הכרטיסייה Signing & Capabilities של היעד ב-Xcode ומוסיפים את הדומיינים של Firebase Hosting מהשלב הקודם ליכולת Associated Domains. אם משתמשים בדומיין ברירת המחדל של Firebase Hosting, הערך יהיה applinks:PROJECT_ID.firebaseapp.com.

    מידע נוסף זמין במאמר Supporting associated domains באתר התיעוד של Apple.

    קובץ דומיין משויך נפרס בכל הדומיינים שלך ב-Firebase Hosting. כדי לגשת אליה, עוברים אל PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. אפשר להחליף את קובץ ה-AASA הזה. מידע נוסף זמין במאמר יצירה ואירוח של קובצי התצורה של קישורים אוניברסליים.

  2. מגדירים את הפרויקט כך שישתמש בקישורים החדשים.

    כשתהיו מוכנים לטפל בקישורים לדומיין החדש, תוכלו להשתמש ב-SDK של Firebase לאדמינים כדי לעדכן את האופן שבו אתם רוצים ליצור קישורים לאימייל, ולהורות לבק-אנד שלנו להתחיל ליצור קישורים באמצעות הדומיין החדש 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 לא תהיה נתמכת יותר (לדוגמה, לא ניתן יהיה להפנות משתמשים לחנות האפליקציות אם האפליקציה לא מותקנת במכשיר שלהם).
  2. שליחת קישור אימות לכתובת האימייל של המשתמש עם אובייקט ActionCodeSettings מעודכן עם דומיין מותאם אישית בתור linkDomain.