流轉(zhuǎn)在 HarmonyOS 中泛指多設(shè)備分布式操作，也是 HarmonyOS 的亮點之一。

流轉(zhuǎn)按體驗可以分為跨端遷移和多端協(xié)同，這里主要跟大家講一下如何進行跨端遷移，以及我在項目開發(fā)過程中，所遇到的問題與解決方法。

具體概念這里就不做過多的贅述了，大家可以查閱官方文檔：

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/hop-overview-0000001092995092

開發(fā)步驟

在開發(fā)過程中，我們可以根據(jù)業(yè)務(wù)需求分為以下兩種場景：

• 同個 FA 之間的遷移（Ability1—Ability1）

• 不同 FA 之間的遷移（Ability1—Ability2）

下面給大家介紹一下以上兩種場景的具體的開發(fā)步驟。 ①同個 FA 之間的遷移

同個 FA 之間的遷移是指不同設(shè)備端安裝了同個 FA，官方文檔已經(jīng)有比較詳細的開發(fā)步驟，下面只給大家講一下需要注意的事項及我所遇到的問題避免大家踩坑。

我們在創(chuàng)建完一個 FA 之后，因為我們大部門的業(yè)務(wù)邏輯都是在 AbilitySlice，所以我們在 Ability 及 AbilitySlice 都要去實現(xiàn) IAbilityContinuation 接口。

并且將 Ability 中實現(xiàn)的 onStartContinuation()、onSaveData（IntentParams intentParams）、onRestoreData（IntentParams intentParams）的返回值，都設(shè)為 true。

publicclassMainAbilityextendsAbilityimplementsIAbilityContinuation{

@Override
publicbooleanonStartContinuation(){
returntrue;
}

@Override
publicbooleanonSaveData(IntentParamsintentParams){
returntrue;
}

@Override
publicbooleanonRestoreData(IntentParamsintentParams){
returntrue;
}
//省略部分代碼
...
}

在對應(yīng)的 FA 模塊的 config.json 中，配置對應(yīng)的權(quán)限，且在代碼中也需要動態(tài)申請。

"reqPermissions":[
{
"name":"ohos.permission.DISTRIBUTED_DATASYNC"},
{
"name":"ohos.permission.DISTRIBUTED_DEVICE_STATE_CHANGE"},
{
"name":"ohos.permission.GET_DISTRIBUTED_DEVICE_INFO"},
{
"name":"ohos.permission.GET_BUNDLE_INFO"}
]

if(canRequestPermission(SystemPermission.DISTRIBUTED_DATASYNC)){
//是否可以申請彈框授權(quán)(首次申請或者用戶未選擇禁止且不再提示)
requestPermissionsFromUser(
newString[]{SystemPermission.DISTRIBUTED_DATASYNC},PERMISSIONS_REQUEST_DISTRIBUTED);
}

定義相關(guān)參數(shù)、設(shè)置流轉(zhuǎn)任務(wù)管理服務(wù)回調(diào)函數(shù)、注冊流轉(zhuǎn)任務(wù)管理服務(wù)、管理流轉(zhuǎn)的目標設(shè)備，同時需要在流轉(zhuǎn)結(jié)束時解注冊流轉(zhuǎn)任務(wù)管理服務(wù)。

//流轉(zhuǎn)應(yīng)用包名
privateStringBUNDLE_NAME="XXX.XXX.XXX";
//注冊流轉(zhuǎn)任務(wù)管理服務(wù)后返回的Abilitytoken
privateintabilityToken;
//用戶在設(shè)備列表中選擇設(shè)備后返回的設(shè)備ID
privateStringselectDeviceId;
//獲取流轉(zhuǎn)任務(wù)管理服務(wù)管理類
privateIContinuationRegisterManagercontinuationRegisterManager;
//設(shè)置流轉(zhuǎn)任務(wù)管理服務(wù)設(shè)備狀態(tài)變更的回調(diào)
privateIContinuationDeviceCallbackcontinuationDeviceCallback=newIContinuationDeviceCallback(){
@Override
publicvoidonDeviceConnectDone(StringdeviceId,StringdeviceType){
selectDeviceId=deviceId;
continuationRegisterManager.updateConnectStatus(abilityToken,selectDeviceId,DeviceConnectState.CONNECTING.getState(),null);
...
}

@Override
publicvoidonDeviceDisconnectDone(Strings){
getUITaskDispatcher().asyncDispatch(()->{
continuationRegisterManager.updateConnectStatus(abilityToken,selectDeviceId,DeviceConnectState.DIS_CONNECTING.getState(),null);
});
unRegisterContinuation();
}
};
//設(shè)置注冊流轉(zhuǎn)任務(wù)管理服務(wù)回調(diào)
privateRequestCallbackrequestCallback=newRequestCallback(){
@Override
publicvoidonResult(intresult){
abilityToken=result;
}
};
...

@Override
publicvoidonStart(Intentintent){
...
continuationRegisterManager=getContinuationRegisterManager();
}

@Override
publicvoidonStop(){
super.onStop();
//解注冊流轉(zhuǎn)任務(wù)管理服務(wù)
continuationRegisterManager.unregister(abilityToken,null);
//斷開流轉(zhuǎn)任務(wù)管理服務(wù)連接
continuationRegisterManager.disconnect();
}

在 Api5 的時候 IContinuationDeviceCallback 的回調(diào)接口跟官方文檔有些出入，當你選擇設(shè)備后會在 onDeviceConnectDone 返回你所選擇的設(shè)備 ID 及設(shè)備類型。

注冊流轉(zhuǎn)服務(wù)之后我們便可以調(diào)起系統(tǒng)流轉(zhuǎn)選擇設(shè)備彈窗，可以通過 ExtraParams 對設(shè)備進行過濾，如不需要過濾，可不傳。

ExtraParamsparams=newExtraParams();
String[]devTypes=newString[]{ExtraParams.DEVICETYPE_SMART_PHONE,ExtraParams.DEVICETYPE_SMART_WATCH,ExtraParams.DEVICETYPE_SMART_PAD};
params.setDevType(devTypes);
registerContinuation();
//顯示選擇設(shè)備列表
continuationRegisterManager.showDeviceList(abilityToken,params,newRequestCallback(){
@Override
publicvoidonResult(intresult){
}
});

選擇完設(shè)備之后會通過上述的 IContinuationDeviceCallback 的 onDeviceConnectDone 方法進行回調(diào)。

之后通過 continueAbility 方法傳入目標設(shè)備的 DeviceID，將運行的 FA 遷移到目標設(shè)備，實現(xiàn)業(yè)務(wù)在設(shè)備間無縫遷移。

//設(shè)置流轉(zhuǎn)任務(wù)管理服務(wù)設(shè)備狀態(tài)變更的回調(diào)
privateIContinuationDeviceCallbackcontinuationDeviceCallback=newIContinuationDeviceCallback(){
@Override
publicvoidonDeviceConnectDone(StringdeviceId,StringdeviceType){
selectDeviceId=deviceId;
getUITaskDispatcher().asyncDispatch(()->{
continuationRegisterManager.updateConnectStatus(abilityToken,selectDeviceId,DeviceConnectState.CONNECTING.getState(),null);
});
if(selectDeviceId!=null){
continueAbility(selectDeviceId);
}
...
}

@Override
publicvoidonDeviceDisconnectDone(Strings){
...
unRegisterContinuation();
}

};

在 FA 遷移中我覺得最主要的部分就是狀態(tài)和數(shù)據(jù)的傳遞，要讓用戶體驗到”無縫“的用戶體驗，需要通過實現(xiàn) IAbilityContinuation 接口來實現(xiàn)數(shù)據(jù)的傳遞。

主要代碼如下：

@Override
publicbooleanonSaveData(IntentParamssaveData){
//根據(jù)業(yè)務(wù)需求，在這里去設(shè)置需要傳遞的數(shù)據(jù)
saveData.setParam("continueParam",continueParam);
returntrue;
}
@Override
publicbooleanonRestoreData(IntentParamsrestoreData){
//遠端FA遷移傳來的狀態(tài)數(shù)據(jù)，開發(fā)者可以按照自身業(yè)務(wù)對這些數(shù)據(jù)進行處理
Objectdata=restoreData.getParam("continueParam");
getUITaskDispatcher().asyncDispatch(()->{

});
returntrue;
}

需要注意的是，在 onRestoreData 處理數(shù)據(jù)更新 UI 的時候，需要在 UI 線程中去更新，否則會報錯。 ②不同 FA 之間的遷移 在實際開發(fā)中可能會因為設(shè)備端的部分需求、UI 的不同，例如車機、手機、手表，從而開發(fā)了不同的 FA。

不同 FA 之間的遷移幾乎與同個 FA 之間遷移配置一致，只是我們的 AbilitySlice 不需要再實現(xiàn) IAbilityContinuation 接口來實現(xiàn)數(shù)據(jù)的同步，而是通過 Intent，具體實現(xiàn)如下。

首先我們先在選擇設(shè)備成功后的回調(diào) IContinuationDeviceCallback 初始化分布式環(huán)境。

//設(shè)置流轉(zhuǎn)任務(wù)管理服務(wù)設(shè)備狀態(tài)變更的回調(diào)
privateIContinuationDeviceCallbackcontinuationDeviceCallback=newIContinuationDeviceCallback(){
@Override
publicvoidonDeviceConnectDone(StringdeviceId,StringdeviceType){
selectDeviceId=deviceId;
//省略部分代碼
...
try{
//初始化分布式環(huán)境
DeviceManager.initDistributedEnvironment(selectDeviceId,newIInitCallback(){
@Override
publicvoidonInitSuccess(Stringsuccess){

}

@Override
publicvoidonInitFailure(Stringfailure,intresult){
}
});
}catch(RemoteExceptione){
e.printStackTrace();
}
...
}
....
};

之前我們是通過 continueAbility() 方法進行跳轉(zhuǎn)，而現(xiàn)在我們需要通過 Intent 方法進行跳轉(zhuǎn)。

Intentintent=newIntent();
Operationoperation=newIntent.OperationBuilder()
.withDeviceId(deviceId)
.withBundleName(bundleName)
.withAbilityName(abilityName)
.withFlags(Intent.FLAG_ABILITYSLICE_MULTI_DEVICE)
.build();
intent.setOperation(operation);
IntentParamsintentParams=newIntentParams();
//通過IntentParams傳遞參數(shù)
...
startAbility(intent);

在接收方，我們可以通過 onStart(Intent intent) 方法接受傳遞過來的參數(shù)，再根據(jù)自己的業(yè)務(wù)邏輯實現(xiàn)數(shù)據(jù)同步。 ③自定義設(shè)備選擇彈窗 在實際項目開發(fā)中我們也可以自定義流轉(zhuǎn)彈窗樣式，但并不推薦這種方式，經(jīng)測試發(fā)現(xiàn)只有在兩個設(shè)備通過藍牙連接的時候才能獲取到設(shè)備列表，只有在特定的場景。

例如手機與車機、手機與手表在實際使用過程中我們基本上是會保持藍牙連接的，通過這種方式實現(xiàn)流轉(zhuǎn)會更穩(wěn)定。但如果不能保持藍牙實時連接的場景則不推薦。

官方 API提供了 DeviceManager.getDeviceList() 來獲取遠端設(shè)備，具體代碼如下。

publicstaticListgetDeviceList(){
//調(diào)用DeviceManager的getDeviceList接口，通過FLAG_GET_ONLINE_DEVICE標記獲得在線設(shè)備列表
ListonlineDevices=DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE);
//判斷組網(wǎng)設(shè)備是否為空
if(onlineDevices==null){
LogUtil.e(TAG,"onlinedevicesisnull");
returnnewArrayList<>();
}
returnonlineDevices;
}

獲取到設(shè)備列表后，我們就可以自行實現(xiàn)頁面了，在上述的 showDeviceList() 彈出設(shè)備列表的位置替換成自己的彈窗即可。

結(jié)語

目前在 DevEco Studio 2.1 Release 以上版本已經(jīng)支持跨端遷移的模擬器了。

如果沒有顯示出來可以在 Settings-DevEco Labs 勾選 Enable Super Device。

以上過程是在實際開發(fā)過程中慢慢摸索得出，如有不對的地方，歡迎在評論區(qū)指出，共同探討（附下載）。

https://harmonyos.51cto.com/posts/9013