電子郵件動作中的狀態

傳送密碼的電子郵件動作時，您可以透過延續網址來傳遞狀態重設或驗證使用者的電子郵件這樣一來，使用者應用程式會在動作完成後返回應用程式。此外，您還可以指定是否直接從行動應用程式處理電子郵件動作連結而不是網頁

這在下列常見情境中非常實用：

使用者 (目前並未登入) 可能嘗試存取要求使用者必須登入。然而，使用者可能忘記並因此觸發重設密碼流程。結尾流程時，使用者會預期返回應用程式的某個部分嘗試存取的內容
應用程式只能提供已驗證帳戶的存取權。適用對象舉例來說，電子報應用程式可能會要求使用者先驗證電子郵件地址訂閱。使用者會經過電子郵件驗證流程，並預期完成訂閱程序
一般而言，使用者啟動密碼重設或電子郵件驗證流程時預期會在應用程式中完成流程的 Apple 應用程式。包括可以透過繼續網址傳遞狀態

能夠透過繼續網址傳遞狀態是一項強大的功能， Firebase 驗證功能提供可大幅提升使用者體驗的功能。

在電子郵件動作中傳遞狀態/繼續網址

為了安全傳遞繼續網址，網址的網域必須符合在 Firebase 控制台中加入許可清單在「驗證」驗證部分中，將該網域新增至「Sign-in method」分頁下會列出「Authorized domain」(授權網域) 清單 (如果尚未顯示)。

傳送時必須提供 ActionCodeSettings 例項並要求重設密碼電子郵件或驗證電子郵件這個介面使用參數

參數	類型	說明
`url`	字串	設定不同意義的連結 (狀態/繼續網址) 不同的情境：在網頁動作小工具中處理連結時，這就是深層連結 `continueUrl` 查詢參數中的連結。如果直接在應用程式中處理連結，則這是 `continueUrl` 查詢參數動態連結。
`iOSBundleId`	字串	設定軟體包 ID。如果發生以下情況，系統將嘗試在 Apple 應用程式中開啟連結已安裝您必須在 Play 管理中心註冊應用程式。如果答案為「否」軟體包 ID 已提供，這個欄位的值會設為應用程式的主要套件。
`androidPackageName`	字串	設定 Android 套件名稱。系統將嘗試在的 Android 應用程式 (如果有的話)
`androidInstallApp`	bool	指定是否要安裝裝置支援 Android 應用程式且應用程式尚未安裝如果這個欄位不含 packageName，系統會擲回錯誤，指出 packageName 必須是與這個欄位搭配使用
`androidMinimumVersion`	字串	此流程支援的應用程式最低版本。如果已指定 minVersion，且已安裝舊版應用程式。系統會引導使用者前往 Play 商店升級應用程式。Android 應用程式必須先在控制台註冊
`handleCodeInApp`	bool	用來在行動應用程式或網頁上開啟電子郵件動作連結連結。預設值為 false。如果設為 true，動作代碼連結會以通用連結或 Android 應用程式連結的形式傳送，且會開啟。如果是 false，則程式碼會傳送到網頁小工具會重新導向至已安裝。
`dynamicLinkDomain`	字串	設定目前連結要使用的動態連結網域 (或子網域) (如果是使用 Firebase Dynamic Links 開啟)做為多重動態每個專案都可以設定連結網域明確選擇一種如未提供，第一個網域加以排序。

以下範例說明如何傳送會先以 Firebase 動態連結的形式在行動應用程式中開啟動態連結網域 example.page.link (iOS 應用程式 com.example.ios 或 Android 應用程式 com.example.android，且請前往如未安裝，最低版本為 12，則會安裝。深層連結將包含繼續網址酬載 https://www.example.com/?email=user@example.com。

final user = FirebaseAuth.instance.currentUser;

final actionCodeSettings = ActionCodeSettings(
  url: "http://www.example.com/verify?email=${user?.email}",
  iOSBundleId: "com.example.ios",
  androidPackageName: "com.example.android",
);

await user?.sendEmailVerification(actionCodeSettings);

設定 Firebase Dynamic Links

Firebase 驗證會使用 Firebase Dynamic Links 傳送要用在行動應用程式中開啟的連結為了使用這份功能，就需要在 Firebase 控制台中設定 Dynamic Links。

啟用 Firebase Dynamic Links：
1. 在 Firebase 控制台中開啟「Dynamic Links」部分。
2. 如果您尚未接受 Dynamic Links 條款並建立 Dynamic Links 網域，請立即採取相關行動。
3. 若您已建立 Dynamic Links 網域，請記下該網域。動態連結網域通常如下所示：
```
example.page.link
```
4. 將 Apple 或 Android 應用程式設為攔截傳入連結。
設定 Android 應用程式：
1. 如果您打算從 Android 應用程式處理這些連結，您必須在 Firebase 控制台中指定 Android 套件名稱專案設定。此外，應用程式的 SHA-1 和 SHA-256 所需憑證
2. 您也需要在 AndroidManifest.xml 檔案
3. 詳情請參閱取得 Android Dynamic Links 操作說明。
設定 Apple 應用程式：
1. 如果您打算從應用程式處理這些連結，請您必須在 Firebase 控制台中指定軟體包 ID 專案設定。此外，App Store ID 和 Apple Developer 您也需要指定團隊 ID。
2. 您也必須將 FDL 通用連結網域設為應用程式功能的關聯網域。
3. 如果您打算將應用程式發行到 iOS 8 以下版本，您需要將軟體包 ID 設定為網址。
4. 詳情請參閱取得 Apple 平台 Dynamic Links 操作說明。

處理網頁應用程式中的電子郵件動作

您可以指定是否要處理來自網路的動作代碼連結再重新導向至其他網頁或行動應用程式驗證完成後，前提是行動應用程式可供使用。方法是將 ActionCodeSettings 物件中的 handleCodeInApp 設為 false。雖然軟體包 ID 或 Android 套件名稱，只要提供這類名稱，使用者就能以在電子郵件動作程式碼完成時，重新導向至指定應用程式。

這裡使用的網址是電子郵件動作範本中設定的網址專區。已佈建所有專案的預設 ID。詳情請參閱自訂電子郵件處理常式，以瞭解更多資訊如何自訂電子郵件動作處理常式。

在這個範例中，continueURL 查詢參數中的連結會是 FDL 連結，其酬載是 ActionCodeSettings 中指定的 URL 物件。雖然您可以攔截及處理應用程式傳入的連結沒有額外的依附元件，建議使用 FDL 用戶端程式庫自動剖析深層連結

處理電子郵件動作 (例如電子郵件驗證) 時，您需要從深層連結中剖析 oobCode 查詢參數，然後套用並透過 applyActionCode 使變更生效，例如：待驗證電子郵件。

處理行動應用程式中的電子郵件動作

您可以指定是否要處理檔案中的動作程式碼連結。請先安裝行動應用程式Android 應用程式您也可以透過 androidInstallApp 指定如果裝置支援且尚未安裝應用程式，系統將進行安裝。已安裝。如果點擊連結的來源裝置不支援行動裝置就會改為從網頁開啟方法是將 ActionCodeSettings 物件中的 handleCodeInApp 設為 true。行動應用程式的 Android 套件名稱或軟體包 ID 這裡使用的備用網址，在沒有行動應用程式可用時，就會是電子郵件動作範本部分中設定的範本預設選項為所有專案都能使用詳情請參閱自訂電子郵件處理常式，以瞭解更多資訊如何自訂電子郵件動作處理常式。

在此情況下，傳送到使用者的行動應用程式連結會是 FDL 連結，且 payload 是動作程式碼網址，在主控台中設定，使用查詢 oobCode、mode、apiKey 和 continueUrl 參數。後者則是原本 URL 中指定的 ActionCodeSettings 物件。雖然您可以攔截及處理無需任何其他依附元件的應用程式傳入連結，並使用 FDL 用戶端程式庫剖析深層連結。動作程式碼可以直接從行動應用程式套用網路流程中的自訂電子郵件處理常式一節。