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

מצב ההעברה בפעולות באימייל

ניתן להעביר את המצב דרך כתובת URL להמשך כששולחים פעולות באימייל לסיסמה מאפס או מאמת כתובת אימייל של משתמש. כך המשתמש יכול חוזרים לאפליקציה אחרי שהפעולה תסתיים. בנוסף, ניתן לציין האם לטפל בקישור לפעולה באימייל ישירות מאפליקציה לנייד והוא מותקן במקום בדף אינטרנט.

האפשרות הזו יכולה להיות שימושית מאוד בתרחישים הנפוצים הבאים:

יכול להיות שמשתמש שלא מחובר כרגע מנסה לגשת לתוכן נדרשת כניסה לחשבון. עם זאת, ייתכן שהמשתמש שכח את הסיסמה שלו, ולכן להפעיל את תהליך איפוס הסיסמה. בסוף את התהליך, המשתמש מצפה לחזור לקטע של האפליקציה מנסה לגשת אליו.
אפליקציות יכולות להציע גישה רק לחשבונות מאומתים. עבור לדוגמה, ניוזלטר עשוי לדרוש מהמשתמש לאמת את כתובת האימייל שלו הרשמה למינוי. המשתמש יבצע את תהליך אימות האימייל ויצפה לחזור לאפליקציה כדי להשלים את המינוי.
במקרים אחרים, יכול להיות שהמשתמש התחיל את התהליך מהנייד ומצפים לאחר האימות לחזור לאפליקציה לנייד במקום בדפדפן.

היכולת להעביר מצב באמצעות כתובת URL להמשך היא תכונה חזקה ש-Firebase Auth מספק, ויכולה לשפר משמעותית את חוויית המשתמש.

העברת מצב או כתובת URL להמשך בפעולות באימייל

כדי להעביר באופן מאובטח כתובת URL להמשך, הדומיין של כתובת ה-URL צריך יהיה ברשימת ההיתרים במסוף Firebase. כדי לעשות זאת, מוסיפים את הדומיין הזה לרשימת הדומיינים המורשים בכרטיסייה שיטת הכניסה בקטע אימות, אם הוא לא מופיע שם כבר.

ActionCodeSettings יש לספק מכונה כאשר שולחים אימייל לאיפוס סיסמה, הודעת אימות. אפשר ליצור אותו עם ה-ActionCodeSettings.Builder שמשויך אליו שמכיל את השיטות הבאות:

שיטה	תיאור
`setUrl(String url)`	הגדרת הקישור (כתובת ה-URL של המצב/המשך) שיש לו משמעויות שונות בהקשרים שונים: כאשר מתבצע טיפול בקישור בווידג'טים של פעולה באינטרנט, זהו הפרמטר העמוק בפרמטר של השאילתה `continueUrl`. כאשר הקישור מטופל ישירות באפליקציה, זו פרמטר של שאילתה `continueUrl` בקישור העומק של קישור דינמי.
`setIOSBundleId(String iOSBundleId)`	מגדיר את מזהה החבילה של iOS. הפעולה הזו תנסה לפתוח את הקישור באפליקציה ל-iOS אם מותקן. האפליקציה ל-iOS צריכה להיות רשומה במסוף.
`setAndroidPackageName(String androidPackageName, boolean installIfNotAvailable, String minimumVersion)`	מגדיר את שם החבילה של Android. הפעולה הזו תנסה לפתוח את הקישור באפליקציה ל-Android, אם היא מותקנת. אם האפשרות InstallIfNotAvailable מוגדרת לערך `true`, היא מציינת האם להתקין את האפליקציה ל-Android אם המכשיר תומך בה עדיין לא מותקן. אם צוין minVersion, וגרסה ישנה יותר של האפליקציה מותקנת, המשתמש מועבר חנות Play כדי לשדרג את האפליקציה. האפליקציה ל-Android צריכה להיות רשומה ב: המסוף.
`setHandleCodeInApp(boolean status)`	אם הקישור לפעולה באימייל ייפתח באפליקציה לנייד או באתר תחילה. ערך ברירת המחדל הוא False. אם הערך של הפרמטר הזה מוגדר כ-True, הקישור לקוד הפעולה יישלח כקישור אוניברסלי או כקישור לאפליקציה ל-Android, והאפליקציה תפתח אותו אם היא מותקנת. במקרה של תוצאה שלילית, הקוד יישלח קודם לווידג'ט האינטרנט, ואז המשך הפנייה תוביל לאפליקציה אם היא מותקנת.
`setDynamicLinkDomain(String dynamicLinkDomain)`	מגדיר את דומיין הקישור הדינמי (או תת-הדומיין) לשימוש בקישור הנוכחי אם הוא נפתח באמצעות קישורים דינמיים ב-Firebase. כמספר מודעות דינמיות ניתן להגדיר דומיינים של קישורים לכל פרויקט, השדה הזה מספק את ביכולת לבחור אחת במפורש. אם לא צוין הדומיין, נעשה שימוש כברירת מחדל.

הדוגמה הבאה ממחישה איך לשלוח קישור לאימות אימייל תיפתח קודם באפליקציה לנייד כקישור דינמי ב-Firebase (אפליקציית iOS com.example.ios או אפליקציית Android com.example.android). קישור העומק יכיל את המטען הייעודי (payload) של כתובת ה-URL להמשך. https://www.example.com/?email=user@example.com.

Kotlin+KTX

val auth = Firebase.auth
val user = auth.currentUser!!

val url = "http://www.example.com/verify?uid=" + user.uid
val actionCodeSettings = ActionCodeSettings.newBuilder()
    .setUrl(url)
    .setIOSBundleId("com.example.ios")
    // The default for this is populated with the current android package name.
    .setAndroidPackageName("com.example.android", false, null)
    .build()

user.sendEmailVerification(actionCodeSettings)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "Email sent.")
        }
    }
MainActivity.kt

Java

FirebaseAuth auth = FirebaseAuth.getInstance();
FirebaseUser user = auth.getCurrentUser();

String url = "http://www.example.com/verify?uid=" + user.getUid();
ActionCodeSettings actionCodeSettings = ActionCodeSettings.newBuilder()
        .setUrl(url)
        .setIOSBundleId("com.example.ios")
        // The default for this is populated with the current android package name.
        .setAndroidPackageName("com.example.android", false, null)
        .build();

user.sendEmailVerification(actionCodeSettings)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Email sent.");
                }
            }
        });
MainActivity.java

הגדרת קישורים דינמיים ב-Firebase

התכונה Firebase Auth משתמשת בקישורים דינמיים ב-Firebase כדי לשלוח קישור שאמור להיפתח באפליקציה לנייד. כדי להשתמש בתכונה הזו, צריך להגדיר קישורים דינמיים במסוף Firebase.

הפעלת קישורים דינמיים ב-Firebase:
1. במסוף Firebase, פותחים את הקטע Dynamic Links.
2. אם עדיין לא אישרתם את התנאים של Dynamic Links ויצרתם דומיין Dynamic Links, עליכם לעשות זאת עכשיו.
  
  אם כבר יצרתם דומיין של Dynamic Links, כדאי לרשום אותו. Dynamic Links בדרך כלל נראה כמו בדוגמה הבאה:
```
example.page.link
```
  יהיה צורך בערך הזה כשמגדירים את האפליקציה ל-Apple או ל-Android כך לעצור את הקישור הנכנס
הגדרת אפליקציות ל-Android:
1. אם בכוונתך לטפל בקישורים האלה מהאפליקציה ל-Android, יש לציין את שם החבילה ב-Android במסוף Firebase הגדרות הפרויקט. בנוסף, האלגוריתם SHA-1 ו-SHA-256 של האפליקציה צריך לספק אישור.
2. צריך גם להגדיר את מסנן Intent לקישור העומק את הקובץ AndroidManifest.xml.
3. מידע נוסף בנושא זה זמין קבלת הוראות בנוגע לקישורים דינמיים ל-Android.
הגדרת אפליקציות ל-iOS:
1. אם בכוונתך לטפל בקישורים האלה מאפליקציית iOS, יש לציין את מזהה החבילה של iOS במסוף Firebase הגדרות הפרויקט. בנוסף, מזהה App Store ומפתח Apple צריך לציין גם את מזהה הצוות.
2. צריך גם להגדיר את דומיין הקישור האוניברסלי של FDL גם דומיין משויך ביכולות האפליקציה שלך.
3. אם אתם מתכננים להפיץ את האפליקציה שלכם ל-iOS מגרסה 8 ומטה, עליך להגדיר את מזהה החבילה של iOS כסכימה מותאמת אישית לקבלת הודעות כתובות URL.
4. מידע נוסף בנושא זה זמין קבלת הוראות לקישורים דינמיים ל-iOS.

טיפול בפעולות אימייל באפליקציית אינטרנט

אפשר לציין אם ברצונך לטפל בקישור לקוד הפעולה מהאינטרנט של האפליקציה תחילה ואז הפניה אוטומטית לדף אינטרנט אחר או לאפליקציה אחרת לנייד לאחר השלמתה בהצלחה, בתנאי שהאפליקציה לנייד זמינה. כדי לעשות זאת, צריך להתקשר למספר setHandleCodeInApp(false) ActionCodeSettings.Builder לאובייקט. אומנם אין צורך במזהה חבילה של iOS או בשם חבילה של Android, אבל הזנתם תאפשר למשתמש כדי להפנות חזרה לאפליקציה שצוינה לאחר השלמת קוד פעולה באימייל.

כתובת ה-URL של האתר שמופיעה כאן היא זו שהוגדרה בתבניות של הפעולות באימייל . ברירת מחדל מוקצה לכל הפרויקטים. במאמר התאמה אישית של טיפול בהודעות אימייל מוסבר איך להתאים אישית את הטיפול בפעולות אימייל.

במקרה כזה, הקישור שבתוך פרמטר השאילתה continueUrl יהיה קישור FDL שהמטען הייעודי (Payload) שלו הוא URL שצוין ב-ActionCodeSettings לאובייקט. אפשר ליירט את הקישור הנכנס מהאפליקציה ולטפל בו ללא תלות נוספת, מומלץ להשתמש בספריית הלקוח של FDL כדי לנתח את קישור העומק.

בעת טיפול בפעולות אימייל כמו אימות אימייל, קוד הפעולה מ- צריך לנתח פרמטר שאילתה אחד (oobCode) מקישור העומק ואז להחיל אותו דרך applyActionCode כדי שהשינוי ייכנס לתוקף, כלומר אימייל לאימות.

טיפול בפעולות אימייל באפליקציה לנייד

אפשר לציין אם רוצים לטפל בקישור של קוד הפעולה בתוך האפליקציה לנייד תחילה, בתנאי שהיא מותקנת. עם אפליקציות ל-Android, אפשר גם לציין באמצעות הבוליאני installIfNotAvailable שהאפליקציה אם המכשיר תומך בכך והוא עדיין לא מותקן. אם המשתמש לחץ על הקישור ממכשיר שלא תומך בנייד של האפליקציה, ניתן לפתוח אותו מדף אינטרנט במקום זאת. כדי לעשות זאת, צריך להתקשר למספר setHandleCodeInApp(true) ActionCodeSettings.Builder לאובייקט. צריך לציין גם את שם החבילה ל-Android או את מזהה החבילה של iOS של האפליקציה לנייד.

כתובת ה-URL החלופית לאינטרנט שבה נעשה שימוש כאן, כשאין אפליקציה זמינה לנייד, היא הכתובת שהוגדרו בקטע 'תבניות פעולה באימייל'. כברירת מחדל, המערכת מקצה חשבון לכל פרויקט. פרטים נוספים מידע נוסף על התאמה אישית של מטפלים באימייל איך להתאים אישית את ה-handler של פעולות האימייל.

במקרה כזה, הקישור לאפליקציה לנייד שיישלח למשתמש יהיה קישור FDL המטען הייעודי (Payload) הוא כתובת ה-URL של קוד הפעולה, שמוגדרת במסוף, עם השאילתה הפרמטרים oobCode, mode, apiKey ו-continueUrl. הערך השני יהיה הערך המקורי של URL שצוין באובייקט ActionCodeSettings. אומנם אפשר ליירט את הקישור הנכנס מהאפליקציה ולטפל בו ללא צורך או תלויה, מומלץ להשתמש בספריית הלקוח של FDL כדי לנתח את קישור העומק את/ה. ניתן להחיל את קוד הפעולה ישירות מאפליקציה לנייד שדומה לאופן שבו הוא מטופל מתהליך האינטרנט המתואר התאמה אישית של מטפלי אימייל.