דף זה תורגם על ידי Cloud Translation API.

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

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

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

הגדרת האפליקציה ל-Android לטיפול בקישור Firebase Hosting
1. כדי לטפל בקישורים האלה מאפליקציית Android, צריך לציין את שם החבילה של האפליקציה בהגדרות הפרויקט במסוף Firebase. בנוסף, צריך לספק את SHA-1 ו-SHA-256 של אישור האפליקציה.
2. אם רוצים שקישורי Firebase Hosting יפנו לפעילות ספציפית, צריך להגדיר מסנן intent בקובץ 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.
הגדרת הפרויקט לשימוש בקישורים החדשים

כשאתם מוכנים לטפל בקישורי הדומיין החדשים, אתם יכולים להשתמש ב-Firebase Admin SDK כדי לעדכן את אופן יצירת הקישורים לאימייל, ולהנחות את ה-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);
  }
};
```
חשוב: כדי לחזור ל-Firebase Dynamic Links במהלך ההטמעה והבדיקה של פתרון הגיבוי, צריך להגדיר את הדומיין בחזרה ל-FIREBASE_DYNAMIC_LINK. Firebase Dynamic Links הפתרון יהיה זמין עד 25 באוגוסט 2025.
שליחה ומימוש של קישור באימייל

שולחים את הקישור לכניסה באמצעות אימייל כמו קודם. כשמשתמש הקצה לוחץ על הקישור, הוא מופנה לאפליקציה אם היא מותקנת, כדי להשלים את הכניסה.

התאמה אישית של קישורים בנייד

אתם יכולים להשתמש בFirebase Hostingדומיין מותאם אישית או להשתמש מחדש בדומיין המותאם אישית Firebase Dynamic Linksכדי להגדיר אותו כדומיין החדש של הקישורים לנייד.

שימוש בדומיין מותאם אישית Firebase Hosting

פועלים לפי ההוראות Firebase Hostingבמדריך הזה כדי להגדיר דומיין בהתאמה אישית.
מגדירים את אפליקציית Android כך שתטפל בקישור Firebase Hosting. (ההוראות מפורטות בקטע הקודם).
שליחת קישור לאימות לכתובת האימייל של המשתמש עם אובייקט ActionCodeSettings מעודכן עם דומיין מותאם אישית בתור linkDomain.

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

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