鴻蒙OS 跨設備遷移

跨設備遷移（下文簡稱“遷移”）支持將 Page 在同一用戶的不同設備間遷移，以便支持用戶無縫切換的訴求。以 Page 從設備 A 遷移到設備 B 為例，遷移動作主要步驟如下：

• 設備 A 上的 Page 請求遷移。
• HarmonyOS 處理遷移任務，并回調(diào)設備 A 上 Page 的保存數(shù)據(jù)方法，用于保存遷移必須的數(shù)據(jù)。
• HarmonyOS 在設備 B 上啟動同一個 Page，并回調(diào)其恢復數(shù)據(jù)方法。
  開發(fā)者可以參考以下詳細步驟開發(fā)具有遷移功能的 Page。

實現(xiàn) IAbilityContinuation 接口

onStartContinuation()
Page 請求遷移后，系統(tǒng)首先回調(diào)此方法，開發(fā)者可以在此回調(diào)中決策當前是否可以執(zhí)行遷移，比如，彈框讓用戶確認是否開始遷移。

onSaveData()
如果 onStartContinuation() 返回 true ，則系統(tǒng)回調(diào)此方法，開發(fā)者在此回調(diào)中保存必須傳遞到另外設備上以便恢復 Page 狀態(tài)的數(shù)據(jù)。

onRestoreData()
源側設備上 Page 完成保存數(shù)據(jù)后，系統(tǒng)在目標側設備上回調(diào)此方法，開發(fā)者在此回調(diào)中接受用于恢復 Page 狀態(tài)的數(shù)據(jù)。注意，在目標側設備上的 Page 會重新啟動其生命周期，無論其啟動模式如何配置。且系統(tǒng)回調(diào)此方法的時機在 onStart() 之前。

onCompleteContinuation()
目標側設備上恢復數(shù)據(jù)一旦完成，系統(tǒng)就會在源側設備上回調(diào) Page 的此方法，以便通知應用遷移流程已結束。開發(fā)者可以在此檢查遷移結果是否成功，并在此處理遷移結束的動作，例如，應用可以在遷移完成后終止自身生命周期。

onRemoteTerminated()
如果開發(fā)者使用 continueAbilityReversibly() 而不是 continueAbility()，則此后可以在源側設備上使用 reverseContinueAbility() 進行回遷。這種場景下，相當于同一個 Page（的兩個實例）同時在兩個設備上運行，遷移完成后，如果目標側設備上 Page 因任何原因終止，則源側 Page 通過此回調(diào)接收終止通知。

說明
一個應用可能包含多個 Page，僅支持遷移的 Page 需要實現(xiàn) IAbilityContinuation 接口。同時，此 Page 所包含的所有 AbilitySlice 也需要實現(xiàn)此接口。

請求遷移

實現(xiàn) IAbilityContinuation 的 Page 可以在其生命周期內(nèi)，調(diào)用 continueAbility() 或 continueAbilityReversibly() 請求遷移。兩者的區(qū)別是，通過后者發(fā)起的遷移此后可以進行回遷。

try {
    continueAbility();
} catch (IllegalStateException e) {
    // Maybe another continuation in progress.
    ...
}

以 Page 從設備 A 遷移到設備B為例，詳細的流程如下：

1.設備 A 上的 Page 請求遷移。
2.系統(tǒng)回調(diào)設備 A 上 Page 及其 AbilitySlice 棧中所有 AbilitySlice 實例的 IAbilityContinuation.onStartContinuation() 方法，以確認當前是否可以立即遷移。
3.如果可以立即遷移，則系統(tǒng)回調(diào)設備 A 上 Page 及其 AbilitySlice 棧中所有 AbilitySlice 實例的 IAbilityContinuation.onSaveData() 方法，以便保存遷移后恢復狀態(tài)必須的數(shù)據(jù)。
4.如果保存數(shù)據(jù)成功，則系統(tǒng)在設備 B 上啟動同一個 Page ，并恢復 AbilitySlice 棧，然后回調(diào) IAbilityContinuation.onRestoreData() 方法，傳遞此前保存的數(shù)據(jù)；此后設備 B 上此 Page 從 onStart() 開始其生命周期回調(diào)。
6.系統(tǒng)回調(diào)設備 A 上 Page 及其 AbilitySlice 棧中所有 AbilitySlice 實例的 IAbilityContinuation.onCompleteContinuation() 方法，通知數(shù)據(jù)恢復成功與否。

請求回遷

使用 continueAbilityReversibly() 請求遷移并完成后，源側設備上已遷移的 Page 可以發(fā)起回遷，以便使用戶活動重新回到此設備。

try {
    reverseContinueAbility();
} catch (IllegalStateException e) {
    // Maybe another continuation in progress.
    ...
}

以Page從設備A遷移到設備B后并請求回遷為例，詳細的流程如下：

1.設備 A 上的 Page 請求回遷。
2.系統(tǒng)回調(diào)設備 B 上 Page 及其 AbilitySlice 棧中所有 AbilitySlice 實例的 IAbilityContinuation.onStartContinuation() 方法，以確認當前是否可以立即遷移。
3.如果可以立即遷移，則系統(tǒng)回調(diào)設備 B 上 Page 及其 AbilitySlice 棧中所有 AbilitySlice 實例的 IAbilityContinuation.onSaveData() 方法，以便保存回遷后恢復狀態(tài)必須的數(shù)據(jù)。
4.如果保存數(shù)據(jù)成功，則系統(tǒng)在設備 A 上 Page 恢復 AbilitySlice 棧，然后回調(diào) IAbilityContinuation.onRestoreData() 方法，傳遞此前保存的數(shù)據(jù)。
5.如果數(shù)據(jù)恢復成功，則系統(tǒng)終止設備 B 上 Page 的生命周期。