העברת הכניסה דרך קישור אימייל מ-Firebase Dynamic Links (ל-Android)

בעבר, אימות באמצעות קישור באימייל הסתמך על Firebase Dynamic Links, שייצא משימוש ב-25 באוגוסט 2025. פרסמנו פתרון חלופי ב-Firebase Authentication Android SDK מגרסה 23.2.0 ואילך וב-Firebase BoM גרסה 33.9.0 ואילך. אם האפליקציה שלכם משתמשת בקישורים מהסוג הישן ואתם רוצים להשתמש בשיטה חלופית להעברת האפליקציה, תוכלו לעיין במאמר אימות באמצעות קישור לאימייל ב-Firebase ב-Android כדי להשתמש במערכת החדשה שמבוססת על Firebase Hosting.

בנוסף, אם אתם משתמשים ב-Firebase Authentication Android SDK בגרסה שמתחת ל-20.0.0 (או ב-Firebase BoM בגרסה שמתחת ל-26.0.0) כדי לנהל זרימות OAuth עם Firebase Authentication, תצטרכו לעדכן לגרסה העדכנית של Authentication SDK או לגרסה BoM (Authentication גרסה 20.0.0 ואילך או BoM גרסה 26.0.0 ואילך) כדי להמשיך לנהל זרימות OAuth ב-Firebase Authentication.

העברת דומיין משויך Firebase Dynamic Links לדומיין Firebase Hosting

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

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

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

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

1. הגדרת האפליקציה ל-Android לטיפול בקישור Firebase Hosting

   1. כדי לטפל בקישורים האלה מאפליקציית Android, צריך לציין את שם החבילה של האפליקציה בהגדרות הפרויקט במסוף Firebase. בנוסף, צריך לספק את SHA-1 ו-SHA-256 של אישור האפליקציה.

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

   חשוב: כדי להבטיח שחזרה חלקה לגרסה הקודמת, מומלץ לשמור את מסנן הכוונות הקיים שמטפל ב-Firebase Dynamic Links בזמן שאתם מנסים את פתרון הקישור Firebase Hosting. Firebase Dynamic Links הפתרון יהיה זמין עד 25 באוגוסט 2025.

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

   חשוב: כדי לחזור ל-Firebase Dynamic Links במהלך ההטמעה והבדיקה של פתרון הגיבוי, צריך להגדיר את הדומיין בחזרה ל-FIREBASE_DYNAMIC_LINK. Firebase Dynamic Links הפתרון יהיה זמין עד 25 באוגוסט 2025.

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