העברת הכניסה דרך קישור אימייל מ-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 Authentication להתחיל להשתמש בדומיין החדש כדי ליצור קישורים לאפליקציות לנייד מעכשיו והלאה, פועלים לפי ההוראות הבאות.
אם אתם רוצים להמשיך להשתמש באחד מהדומיינים המותאמים אישית שלכם, Firebase Hosting או אפילו להגדיר את הדומיין המותאם אישית שלכם כדומיין המשויך החדש, אתם צריכים לבצע את השלבים שמתאימים לדומיין שבו אתם רוצים להשתמש.Firebase Dynamic Links הערה: אחרי שתשלימו את ההוראות שבקטע הבא, התכונה של קישור עמוק בדומיין המותאם אישית שלכם ב-Firebase Dynamic Links תוסר. רק הדומיין עצמו יישאר כדי ליצור קישורי אימייל.
הגדרת האפליקציה ל-Android לטיפול בקישור Firebase Hosting
כדי לטפל בקישורים האלה מאפליקציית Android, צריך לציין את שם החבילה של האפליקציה בהגדרות הפרויקט במסוף Firebase. בנוסף, צריך לספק את SHA-1 ו-SHA-256 של אישור האפליקציה.
אם רוצים שקישורי Firebase Hosting יפנו אוטומטית לפעילות ספציפית, צריך להגדיר מסנן כוונות בקובץ AndroidManifest.xml. מסנן הכוונות צריך לזהות קישורים של הדומיין שלכם.Firebase Hosting בAndroidManifest.xml:
כשמשתמשים פותחים קישור לאירוח עם הנתיב "/__/auth/links" והסכימה והמארח שציינתם, האפליקציה שלכם תתחיל את הפעילות עם מסנן הכוונות הזה כדי לטפל בקישור.
הגדרת הפרויקט לשימוש בקישורים החדשים
כשאתם מוכנים לטפל בקישורי הדומיין החדשים, אתם יכולים להשתמש ב-Firebase Admin SDK כדי לעדכן את אופן יצירת הקישורים לאימייל, ולהנחות את ה-Backend שלנו להתחיל ליצור קישורים באמצעות הדומיין החדש Firebase Hosting.
import{getAuth}from'firebase-admin/auth';constupdateEmailAuthDomain=async()=>{constupdateRequest={mobileLinksConfig:{domain:'HOSTING_DOMAIN',},};constprojectConfigManager=getAuth().projectConfigManager();try{constresponse=awaitprojectConfigManager.updateProjectConfig(updateRequest);// Updated project configconsole.log('Project configuration updated successfully:',response);}catch(error){console.error('Error updating the project:',error);}};
שליחה ומימוש של הקישור באימייל
שולחים את הקישור לכניסה באמצעות אימייל כמו קודם. כשמשתמש הקצה לוחץ על הקישור, הוא מופנה לאפליקציה אם היא מותקנת, כדי להשלים את הכניסה.
התאמה אישית של קישורים בנייד
אתם יכולים להשתמש בFirebase Hostingדומיין מותאם אישית או להשתמש מחדש בדומיין המותאם אישיתFirebase Dynamic Links בתור הדומיין החדש של הקישורים לנייד.
שימוש חוזר בדומיין Firebase Dynamic Links מותאם אישית
אתם יכולים להשתמש מחדש בכל אחד מהדומיינים שלכם ב-Firebase Dynamic Links בתור דומיין מותאם אישית. עם זאת, לא תהיה יותר תמיכה בפונקציונליות של Firebase Dynamic Links (לדוגמה, אי אפשר להפנות משתמשים לחנות אפליקציות אם האפליקציה לא מותקנת במכשיר שלהם).
מגדירים את אפליקציית Android לטיפול בקישור Firebase Hosting (הוראות בקטע הקודם למעלה).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-05 (שעון UTC)."],[],[],null,["Email link authentication previously relied on Firebase Dynamic Links, which will be\n[shut down on August 25, 2025](/support/dynamic-links-faq). We've published an\nalternative solution in the Firebase Authentication Android SDK version 23.2.0+ and\nFirebase BoM version 33.9.0+. If your app uses the old style links and you\nwant to use an alternative method for migrating your app, see\n[Authenticate with Firebase using Email Link in Android](/docs/auth/android/email-link-auth)\nto use the new Firebase Hosting based system.\n\nAlso, if you're using the **Firebase Authentication Android SDK below v20.0.0 (or the\nFirebase BoM below v26.0.0) to manage OAuth flows** with Firebase Authentication,\nyou'll need to update to the latest Authentication SDK or BoM version\n(Authentication v20.0.0+ or BoM v26.0.0+) in order to continue managing OAuth\nflows in Firebase Authentication.\n\nMigrate your associated Firebase Dynamic Links domain to a Firebase Hosting domain\n\nMoving forward, rather than using a Firebase Dynamic Links domain, Firebase Authentication\nwill use the Firebase Hosting default domain for your project to create\nlinks for email link and other out-of-band link actions in mobile apps. This\nmeans that your app will also need to be updated to use this default domain as\nthe associated domain for email authentication links to your mobile app.\n\nYou can follow the instructions in\n[Authenticate with Firebase Using Email Link in Android](/docs/auth/android/email-link-auth) to update your mobile app links\nto use the new automatically provisioned Firebase Hosting default domain.\n\nUse the following instructions to handle links from the new domain and to\ninstruct Firebase Authentication to start using the new domain to generate mobile app\nlinks going forward.\n\nIf you'd like to continue using any of your custom Firebase Hosting domains\nor even your custom Firebase Dynamic Links domain to be your new associated\ndomain, follow the steps that match the intended domain you'd like to use. Note\nthat after completing the instructions in the following section, the deep\nlinking feature on your Firebase Dynamic Links custom domain will be removed;\nonly the domain itself will remain for creating email links.\n\n1. **Configure your Android application to handle your Firebase Hosting link**\n\n 1. In order to handle these links from your Android application, your app's package name needs to be specified in the Firebase console project settings. In addition, the SHA-1 and SHA-256 of the application certificate need to be provided.\n 2. If you want these Firebase Hosting links to redirect to a specific\n activity, you will need to configure an intent filter in your\n `AndroidManifest.xml` file. The intent filter should catch\n Firebase Hosting links of your domain. In `AndroidManifest.xml`:\n\n \u003cintent-filter android:autoVerify=\"true\"\u003e\n \u003caction android:name=\"android.intent.action.VIEW\" /\u003e\n \u003ccategory android:name=\"android.intent.category.BROWSABLE\" /\u003e\n \u003ccategory android:name=\"android.intent.category.DEFAULT\" /\u003e\n \u003cdata\n android:scheme=\"https\"\n android:host=\"PROJECT_ID.firebaseapp.com or a custom hosting domain\"\n android:pathPrefix=\"/__/auth/links\" /\u003e\n \u003c/intent-filter\u003e\n\n When users open a hosting link with the \"/__/auth/links\" path and the\n scheme and host you specify, your app will start the activity with this\n intent filter to handle the link.\n | **Important:** To ensure a seamless rollback, we recommend keeping your existing intent filter that handles Firebase Dynamic Links while trying out the Firebase Hosting link solution. The Firebase Dynamic Links solution will be available until August 25, 2025.\n2. **Configure your project to use the new links**\n\n When you're ready to handle the new domain links, you can use the\n [Firebase Admin SDK](/docs/admin/setup) to update how you want email links\n to be generated and instruct our backend to start generating links using\n the new Firebase Hosting domain. \n\n import { getAuth } from 'firebase-admin/auth';\n\n const updateEmailAuthDomain = async () =\u003e {\n const updateRequest = {\n mobileLinksConfig: {\n domain: 'HOSTING_DOMAIN',\n },\n };\n\n const projectConfigManager = getAuth().projectConfigManager();\n\n try {\n const response = await projectConfigManager.updateProjectConfig(updateRequest);\n // Updated project config\n console.log('Project configuration updated successfully:', response);\n } catch (error) {\n console.error('Error updating the project:', error);\n }\n };\n\n | **Important:** To rollback to the Firebase Dynamic Links while implementing and testing the backup solution, you should set the domain back to `FIREBASE_DYNAMIC_LINK`. The Firebase Dynamic Links solution will be available until August 25, 2025.\n3. **Send and redeem the email link**\n\n Send the email sign-in link as before. When the end user clicks the link,\n they will be redirected to the app if installed to complete the sign-in.\n\nCustomize your mobile links\n\nYou can use a custom Firebase Hosting domain or reuse your custom\nFirebase Dynamic Links domain to be your new mobile links domain.\n\nUse a custom Firebase Hosting domain\n\n1. Follow the [Firebase Hosting guide](/docs/hosting/custom-domain) to set up a custom domain.\n2. Configure your Android application to handle your Firebase Hosting link. (instructions in previous section above).\n3. [Send an authentication link to the user's email\n address](/docs/auth/android/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`.\n\nRe-use your custom Firebase Dynamic Links domain\n\n1. You can re-use any of your Firebase Dynamic Links domains as your custom domain. However, any Firebase Dynamic Links functionality will no longer be supported (for example, users cannot be redirected to an app store if the app isn't installed on their device).\n2. Configure your Android application to handle your Firebase Hosting link (instructions in previous section above).\n3. [Send an authentication link to the user's email\n address](/docs/auth/android/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`."]]
