העברת הכניסה דרך קישור אימייל מ-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 בגרסה שמתחת ל-v20.0.0 (או ב-Firebase BoM בגרסה שמתחת ל-v26.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 Hosting שהוקצה אוטומטית, אפשר לפעול לפי ההוראות במאמר אימות באמצעות קישור באימייל ב-Firebase ב-Android.

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

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

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

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

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

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

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

שימוש חוזר בדומיין Firebase Dynamic Links המותאם אישית

1. אתם יכולים להשתמש מחדש בכל אחד מהדומיינים של Firebase Dynamic Links כדומיין מותאם אישית. עם זאת, לא תהיה יותר תמיכה בפונקציונליות של Firebase Dynamic Links (לדוגמה, אי אפשר יהיה להפנות משתמשים לחנות אפליקציות אם האפליקציה לא מותקנת במכשיר שלהם).
2. מגדירים את אפליקציה ל-Android לטיפול בקישור Firebase Hosting (הוראות בקטע הקודם שלמעלה).
3. שליחת קישור לאימות לכתובת האימייל של המשתמש עם אובייקט ActionCodeSettings מעודכן עם דומיין מותאם אישית בתור linkDomain.