העברת הכניסה דרך קישור אימייל מ-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 v20.0.0 ואילך או BoM v26.0.0 ואילך) כדי להמשיך לנהל תהליכי OAuth ב-Firebase Authentication.

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

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

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

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