HarmonyOS中如何進(jìn)行跨端遷移

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

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

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

開(kāi)發(fā)步驟

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

• 同個(gè) FA 之間的遷移（Ability1—Ability1）

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

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

publicclassMainAbilityextendsAbilityimplementsIAbilityContinuation{

@Override
publicbooleanonStartContinuation(){
returntrue;
}

@Override
publicbooleanonSaveData(IntentParamsintentParams){
returntrue;
}

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

"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)){
//是否可以申請(qǐng)彈框授權(quán)(首次申請(qǐng)或者用戶(hù)未選擇禁止且不再提示)
requestPermissionsFromUser(
newString[]{SystemPermission.DISTRIBUTED_DATASYNC},PERMISSIONS_REQUEST_DISTRIBUTED);
}

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

//流轉(zhuǎn)應(yīng)用包名
privateStringBUNDLE_NAME="XXX.XXX.XXX";
//注冊(cè)流轉(zhuǎn)任務(wù)管理服務(wù)后返回的Abilitytoken
privateintabilityToken;
//用戶(hù)在設(shè)備列表中選擇設(shè)備后返回的設(shè)備ID
privateStringselectDeviceId;
//獲取流轉(zhuǎn)任務(wù)管理服務(wù)管理類(lèi)
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è)置注冊(cè)流轉(zhuǎn)任務(wù)管理服務(wù)回調(diào)
privateRequestCallbackrequestCallback=newRequestCallback(){
@Override
publicvoidonResult(intresult){
abilityToken=result;
}
};
...

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

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

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

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){
}
});

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

//設(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();
}

};

主要代碼如下：

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

});
returntrue;
}

首先我們先在選擇設(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();
}
...
}
....
};

之前我們是通過(guò) continueAbility() 方法進(jìn)行跳轉(zhuǎn)，而現(xiàn)在我們需要通過(guò) Intent 方法進(jìn)行跳轉(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();
//通過(guò)IntentParams傳遞參數(shù)
...
startAbility(intent);

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

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

結(jié)語(yǔ)

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