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

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

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

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