流轉在 HarmonyOS 中泛指多設備分布式操作，也是 HarmonyOS 的亮點之一。

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

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

開發步驟

在開發過程中，我們可以根據業務需求分為以下兩種場景：

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

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

并且將 Ability 中實現的 onStartContinuation()、onSaveData（IntentParams intentParams）、onRestoreData（IntentParams intentParams）的返回值，都設為 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)){
//是否可以申請彈框授權(首次申請或者用戶未選擇禁止且不再提示)
requestPermissionsFromUser(
newString[]{SystemPermission.DISTRIBUTED_DATASYNC},PERMISSIONS_REQUEST_DISTRIBUTED);
}

定義相關參數、設置流轉任務管理服務回調函數、注冊流轉任務管理服務、管理流轉的目標設備，同時需要在流轉結束時解注冊流轉任務管理服務。

//流轉應用包名
privateStringBUNDLE_NAME="XXX.XXX.XXX";
//注冊流轉任務管理服務后返回的Abilitytoken
privateintabilityToken;
//用戶在設備列表中選擇設備后返回的設備ID
privateStringselectDeviceId;
//獲取流轉任務管理服務管理類
privateIContinuationRegisterManagercontinuationRegisterManager;
//設置流轉任務管理服務設備狀態變更的回調
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();
}
};
//設置注冊流轉任務管理服務回調
privateRequestCallbackrequestCallback=newRequestCallback(){
@Override
publicvoidonResult(intresult){
abilityToken=result;
}
};
...

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

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

注冊流轉服務之后我們便可以調起系統流轉選擇設備彈窗，可以通過 ExtraParams 對設備進行過濾，如不需要過濾，可不傳。

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

之后通過 continueAbility 方法傳入目標設備的 DeviceID，將運行的 FA 遷移到目標設備，實現業務在設備間無縫遷移。

//設置流轉任務管理服務設備狀態變更的回調
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){
//根據業務需求，在這里去設置需要傳遞的數據
saveData.setParam("continueParam",continueParam);
returntrue;
}
@Override
publicbooleanonRestoreData(IntentParamsrestoreData){
//遠端FA遷移傳來的狀態數據，開發者可以按照自身業務對這些數據進行處理
Objectdata=restoreData.getParam("continueParam");
getUITaskDispatcher().asyncDispatch(()->{

});
returntrue;
}

首先我們先在選擇設備成功后的回調 IContinuationDeviceCallback 初始化分布式環境。

//設置流轉任務管理服務設備狀態變更的回調
privateIContinuationDeviceCallbackcontinuationDeviceCallback=newIContinuationDeviceCallback(){
@Override
publicvoidonDeviceConnectDone(StringdeviceId,StringdeviceType){
selectDeviceId=deviceId;
//省略部分代碼
...
try{
//初始化分布式環境
DeviceManager.initDistributedEnvironment(selectDeviceId,newIInitCallback(){
@Override
publicvoidonInitSuccess(Stringsuccess){

}

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

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

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

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

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

結語

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