העברת הכניסה באמצעות קישור לאימייל מקישורים דינמיים ב-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 Hosting שמוקצה אוטומטית, אפשר לפעול לפי ההוראות במאמר אימות באמצעות קישור באימייל ב-Firebase בפלטפורמות של אפל.

כדי לטפל בקישורים מהדומיין החדש ולהנחות את 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.

    מידע נוסף זמין במאמר תמיכה בדומיינים משויכים באתר התיעוד של Apple.

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

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

    כשמוכנים לטפל בקישורים החדשים לדומיין, אפשר להשתמש ב-Firebase Admin SDK כדי לעדכן את אופן יצירת הקישורים לאימייל, ולהנחות את ה-Backend שלנו להתחיל ליצור קישורים באמצעות הדומיין החדש 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);
});
}

  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.