基于PA的跨設(shè)備遷移功能及PageAbility代碼示例工程完全解
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
一、跨設(shè)備遷移
是什么：是一種基于Ability框架下的Page Ability的能力
遷移動(dòng)作主要步驟：
- 源側(cè)設(shè)備上的Page請求遷移
- 源側(cè)設(shè)備回調(diào)保存數(shù)據(jù)方法
- 目標(biāo)側(cè)設(shè)備啟動(dòng)Page，回調(diào)恢復(fù)數(shù)據(jù)方法
請求遷移的兩種方法
- continue Ability()
- continueAbilityReversibly()
區(qū)別在于：continueAbility()不能進(jìn)行回遷，continueAbilityReversibly()可以進(jìn)行回遷
實(shí)現(xiàn)IAbilityContinuation接口
- onStartContinuation()
- onSaveData()
- onRestoreData()
- onCompleteContinuation()
- onFailedContinuation()
- onRemoteTerminated()
文字描述不夠清晰和直接，故用表的形式進(jìn)行輸出
A作為源側(cè)向目標(biāo)側(cè)B進(jìn)行遷移其回調(diào)方法的順序是：
二、PageAbility代碼示例工程
本示例演示了同一Page Ability內(nèi)和不同Page間的AbilitySlice導(dǎo)航，以及Page Ability的跨端遷移。
(一)項(xiàng)目演示
因?yàn)槭纠a的字真的小得讓人眼瞎，所以就調(diào)大了一點(diǎn)
跨設(shè)備遷移
同PA不同Page間的導(dǎo)航
(二)工程目錄及其Slice直接的關(guān)系
(三)同一PA導(dǎo)航與不同Page
同Page
Page內(nèi)的AbilitySlice實(shí)例是以堆棧存放的，其頁內(nèi)導(dǎo)航的數(shù)據(jù)傳遞是通過intent傳遞的，源頁面調(diào)用方法setParam()，其值是鍵值對。在跳轉(zhuǎn)頁面通過getParam進(jìn)行接收(intent.getParam(key：“XX”))
目標(biāo)頁面向源頁面?zhèn)鬟f數(shù)據(jù)，構(gòu)建intent實(shí)例(返回?cái)?shù)據(jù)的載體)-賦值給intent類型的resultIntent變量-調(diào)用方法setParam()(鍵值對的形式)-調(diào)用方法setResult()指定實(shí)例作為參數(shù)-在原頁面調(diào)用PresentForResult()(請求碼非負(fù)整數(shù)作為第三個(gè)參數(shù)用于標(biāo)識某一次頁面導(dǎo)航)-重寫方法onResult(處理返回?cái)?shù)據(jù))-
不同Page
- 顯式：在觸發(fā)事件中構(gòu)造Intent.OperationBuilder的實(shí)例-分別鏈?zhǔn)秸{(diào)用
- Operation operation=new Intent.OperationBuilder()
- withBundleName（getBundleName（））
- .getAbilityName（目標(biāo)Ability.class.getName()）
- .build();
為了把目標(biāo)Page的包名和類名都封裝在需要傳遞的Intent類型的實(shí)例navigation中，需要調(diào)用navigation的方法setOperation并指定才創(chuàng)建的Intent類型的實(shí)例operation為其參數(shù)。最后用startAbility且把navigation作為參數(shù)。
從目標(biāo)頁面跳轉(zhuǎn)到源頁面且處理數(shù)據(jù)，需要在目標(biāo)調(diào)用getAbility.setParam并設(shè)置響應(yīng)碼(是用來標(biāo)識一次響應(yīng))。之后在原頁面把startAbility變更為startAbilityForResult(響應(yīng)碼)-把回調(diào)方法onResult替換為onAbilityResult(響應(yīng)碼)，
(四)跨設(shè)備遷移
- 設(shè)備A上的Page請求遷移。
- 系統(tǒng)回調(diào)設(shè)備A上Page及其AbilitySlice棧中所有AbilitySlice實(shí)例的IAbilityContinuation.onStartContinuation()方法，以確認(rèn)當(dāng)前是否可以立即遷移。
- 如果可以立即遷移，則系統(tǒng)回調(diào)設(shè)備A上Page及其AbilitySlice棧中所有AbilitySlice實(shí)例的IAbilityContinuation.onSaveData()方法，以便保存遷移后恢復(fù)狀態(tài)必須的數(shù)據(jù)。
- 如果保存數(shù)據(jù)成功，則系統(tǒng)在設(shè)備B上啟動(dòng)同一個(gè)Page，并恢復(fù)AbilitySlice棧，然后回調(diào)IAbilityContinuation.onRestoreData()方法，傳遞此前保存的數(shù)據(jù);此后設(shè)備B上此Page從onStart()開始其生命周期回調(diào)。
- 系統(tǒng)回調(diào)設(shè)備A上Page及其AbilitySlice棧中所有AbilitySlice實(shí)例的IAbilityContinuation.onCompleteContinuation()方法，通知數(shù)據(jù)恢復(fù)成功與否。
- 遷移過程中發(fā)生異常，系統(tǒng)回調(diào)設(shè)備A上Page及其AbilitySlice棧中所有AbilitySlice實(shí)例的IAbilityContinuation.onFailedContinuation()方法，通知遷移過程中發(fā)生異常，并不是所有異常都會(huì)回調(diào)FA此方法，僅局限于該接口枚舉的異常。
總結(jié)
跨設(shè)備遷移是基于分布式流轉(zhuǎn)操作的。是很有趣和很值得研究的功能
同Page，不同Page，不同設(shè)備。三種情況下Page生命周期需要搞懂，需要分清楚Page生命周期回調(diào)方法，與跨設(shè)備遷移中實(shí)現(xiàn)IAbilityContinuation接口的回調(diào)方法。一定注意源側(cè)與目標(biāo)側(cè)的方法調(diào)用的順序。
對于基礎(chǔ)的Ability與Slice的關(guān)系、Slice與Layout(xml)的關(guān)系、Intent的理解得到了提升。
51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)
