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

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

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

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

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

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

  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.