鴻蒙應(yīng)用開(kāi)發(fā)入門（七）：實(shí)現(xiàn)跨設(shè)備遷移

作者：zhonghongfa 2021-01-06 11:21:56

開(kāi)發(fā)

文章由鴻蒙社區(qū)產(chǎn)出，想要了解更多內(nèi)容請(qǐng)前往：51CTO和華為官方戰(zhàn)略合作共建的鴻蒙技術(shù)社區(qū)https://harmonyos.51cto.com/#zz

[[374071]]

想了解更多內(nèi)容，請(qǐng)?jiān)L問(wèn)：

51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)

https://harmonyos.51cto.com/#zz

6.2 跨設(shè)備遷移

1. 分布式任務(wù)調(diào)度概述

在HarmonyOS中，分布式任務(wù)調(diào)度平臺(tái)對(duì)搭載HarmonyOS的多設(shè)備構(gòu)筑的“超級(jí)虛擬終端”提供統(tǒng)一的組件管理能力，為應(yīng)用定義統(tǒng)一的能力基線、接口形式、數(shù)據(jù)結(jié)構(gòu)、服務(wù)描述語(yǔ)言，屏蔽硬件差異;支持遠(yuǎn)程啟動(dòng)、遠(yuǎn)程調(diào)用、業(yè)務(wù)無(wú)縫遷移等分布式任務(wù)。

2. 實(shí)現(xiàn)調(diào)度的約束與限制

1)遠(yuǎn)程調(diào)用PA/FA，開(kāi)發(fā)者需要在Intent中設(shè)置支持分布式的標(biāo)記(例如：Intent.FLAG_ABILITYSLICE_MULTI_DEVICE表示該應(yīng)用支持分布式調(diào)度)，否則將無(wú)法獲得分布式能力。

2)開(kāi)發(fā)者通過(guò)在config.json中的reqPermissions字段里添加權(quán)限申請(qǐng)：

(1)以獲取跨設(shè)備連接的能力和分布式數(shù)據(jù)傳輸?shù)臋?quán)限。

分布式數(shù)據(jù)傳輸?shù)臋?quán)限：

{"name": "ohos.permission.servicebus.ACCESS_SERVICE"}

三方應(yīng)用使用權(quán)限：

{"name": "ohos.permission.servicebus.DISTRIBUTED_DATASYNC"}

系統(tǒng)應(yīng)用使用權(quán)限：

{"name": "com.huawei.hwddmp.servicebus.BIND_SERVICE"}

(2)另外還有三個(gè)獲取分布式設(shè)備信息需要的權(quán)限：

{"name": "ohos.permission.DISTRIBUTED_DEVICE_STATE_CHANGE"}, 
 
{"name": "ohos.permission.GET_DISTRIBUTED_DEVICE_INFO" }, 
 
{ "name": "ohos.permission.GET_BUNDLE_INFO"}

注意：還需要在開(kāi)發(fā)的時(shí)候，要在Ability里主動(dòng)聲明，要用到的權(quán)限。

3)FA(Feature Ability，Page模板的Ability)的調(diào)用支持啟動(dòng)和遷移行為，在進(jìn)行調(diào)度時(shí)：

(1)當(dāng)啟動(dòng)FA時(shí)，需要開(kāi)發(fā)者在Intent中指定對(duì)端設(shè)備的deviceId、bundleName和abilityName。

(2)FA的遷移實(shí)現(xiàn)相同bundleName和abilityName的FA跨設(shè)備遷移，因此需要指定遷移設(shè)備的deviceId。

3. 實(shí)現(xiàn)場(chǎng)景介紹

下面以設(shè)備A(本地設(shè)備)和設(shè)備B(遠(yuǎn)端設(shè)備)為例，介紹下面我們要實(shí)現(xiàn)的場(chǎng)景：

1)設(shè)備A啟動(dòng)設(shè)備B的FA：在設(shè)備A上通過(guò)本地應(yīng)用提供的啟動(dòng)按鈕，啟動(dòng)設(shè)備B上對(duì)應(yīng)的FA。

2)設(shè)備A的FA遷移至設(shè)備B：設(shè)備A上通過(guò)本地應(yīng)用提供的遷移按鈕，將設(shè)備A的業(yè)務(wù)無(wú)縫遷移到設(shè)備B中。

3)設(shè)備A的FA遷移至設(shè)備B，還可以實(shí)現(xiàn)主動(dòng)撤回遷移。

4. 具體實(shí)現(xiàn)前先了解要用的接口

1)啟動(dòng)遠(yuǎn)程FA

startAbility(Intent intent)接口提供啟動(dòng)指定設(shè)備上FA和PA的能力，Intent中指定待啟動(dòng)FA的設(shè)備deviceId、bundleName和abilityName。

2)遷移FA

continueAbility(String deviceId)接口提供將本地FA遷移到指定設(shè)備上的能力，continueAbilityReversibly(String deviceId) 接口提供將本地FA遷移到指定設(shè)備上的能力，這種遷移可撤回， reverseContinueAbility()接口提供撤回遷移的能力。

5. 實(shí)戰(zhàn)遠(yuǎn)程啟動(dòng)FA頁(yè)面

1)編程實(shí)現(xiàn)上面場(chǎng)景的界面：

ability_main.xml

<?xml version="1.0" encoding="utf-8"?> 
<DirectionalLayout 
    xmlns:ohos="http://schemas.huawei.com/res/ohos" 
    ohos:height="match_parent" 
    ohos:width="match_parent" 
    ohos:orientation="vertical"> 
 
    <Button 
        ohos:id="$+id:migration_btn_01" 
        ohos:height="match_content" 
        ohos:width="300vp" 
        ohos:text="1.啟動(dòng)遠(yuǎn)程設(shè)備的FA" 
        ohos:text_size="20fp" 
        ohos:text_color="#ffffff" 
        ohos:background_element="$graphic:button_bg" 
        ohos:layout_alignment="horizontal_center" 
        ohos:top_padding="8vp" 
        ohos:bottom_padding="8vp" 
        ohos:left_padding="40vp" 
        ohos:right_padding="40vp" 
        ohos:top_margin="20vp" 
        /> 
 
    <Button 
        ohos:id="$+id:migration_btn_02" 
        ohos:height="match_content" 
        ohos:width="300vp" 
        ohos:text="2.遷移到遠(yuǎn)程設(shè)備" 
        ohos:text_size="20fp" 
        ohos:text_color="#ffffff" 
        ohos:background_element="$graphic:button_bg" 
        ohos:layout_alignment="horizontal_center" 
        ohos:top_padding="8vp" 
        ohos:bottom_padding="8vp" 
        ohos:left_padding="40vp" 
        ohos:right_padding="40vp" 
        ohos:top_margin="20vp" 
        /> 
 
 
    <Button 
        ohos:id="$+id:migration_btn_03" 
        ohos:height="match_content" 
        ohos:width="300vp" 
        ohos:text="3.可遷回的遷移遠(yuǎn)程設(shè)備" 
        ohos:text_size="20fp" 
        ohos:text_color="#ffffff" 
        ohos:background_element="$graphic:button_bg" 
        ohos:layout_alignment="horizontal_center" 
        ohos:top_padding="8vp" 
        ohos:bottom_padding="8vp" 
        ohos:left_padding="40vp" 
        ohos:right_padding="40vp" 
        ohos:top_margin="20vp" 
        /> 
</DirectionalLayou

button_bg.xml

<?xml version="1.0" encoding="utf-8"?> 
<shape  xmlns:ohos="http://schemas.huawei.com/res/ohos" 
        ohos:shape="rectangle"> 
    <solid ohos:color="#007DFF"/> 
    <corners ohos:radius="40"/> 
</

MigrationAbility和MigrationBackAbility

// 調(diào)用AbilitySlice模板實(shí)現(xiàn)一個(gè)用于控制基礎(chǔ)功能的FA 
// Ability和AbilitySlice類均需要實(shí)現(xiàn)IAbilityContinuation及其方法，才可以實(shí)現(xiàn)FA遷移。AbilitySlice的代碼示例如下 
public class SampleSlice extends AbilitySlice implements IAbilityContinuation { 
    @Override 
    public void onStart(Intent intent) { 
        super.onStart(intent); 
        
        super.setUIContent(layout); 
    }

ability_migration.xml

<?xml version="1.0" encoding="utf-8"?> 
<DirectionalLayout 
    xmlns:ohos="http://schemas.huawei.com/res/ohos" 
    ohos:height="match_parent" 
    ohos:width="match_parent" 
    ohos:background_element="#00ffff" 
    ohos:orientation="vertical"> 
 
    <Text 
        ohos:id="$+id:text_title" 
        ohos:height="match_content" 
        ohos:width="250vp" 
        ohos:background_element="#0088bb" 
        ohos:layout_alignment="horizontal_center" 
        ohos:text="下面是一個(gè)可編輯的文本框" 
        ohos:text_size="50" 
        ohos:padding="5vp" 
        ohos:top_margin="30vp" 
        /> 
 
    <TextField 
        ohos:id="$+id:textfield_back" 
        ohos:height="250vp" 
        ohos:width="250vp" 
        ohos:hint="請(qǐng)輸入..." 
        ohos:layout_alignment="horizontal_center" 
        ohos:background_element="#ffffff" 
        ohos:text_color="#888888" 
        ohos:text_size="20fp" 
        ohos:padding="5vp" 
        /> 
    <Button 
        ohos:id="$+id:migration_button" 
        ohos:height="match_content" 
        ohos:width="match_content" 
        ohos:text="點(diǎn)擊遷移" 
        ohos:text_size="20fp" 
        ohos:text_color="#ffffff" 
        ohos:background_element="$graphic:button_bg" 
        ohos:top_padding="8vp" 
        ohos:bottom_padding="8vp" 
        ohos:left_padding="50vp" 
        ohos:right_padding="50vp" 
        ohos:layout_alignment="horizontal_center" 
        ohos:top_margin="30vp" 
        /> 
</DirectionalLayou

ability_migration_back.xml比ability_migration.xml多一個(gè)遷回按鈕，另外主頁(yè)上點(diǎn)擊按鈕跳轉(zhuǎn)等，略...

2)使用分布式能力要求開(kāi)發(fā)者在Ability對(duì)應(yīng)的config.json中聲明多設(shè)備協(xié)同訪問(wèn)的權(quán)限：

(1)三方應(yīng)用部署權(quán)限、分布式數(shù)據(jù)傳輸?shù)臋?quán)限、系統(tǒng)應(yīng)用使用權(quán)限的申請(qǐng)。

{ 
    "reqPermissions": [ 
        {"name": "ohos.permission.DISTRIBUTED_DATASYNC"}, 
        {"name": "ohos.permission.servicebus.ACCESS_SERVICE"}, 
        {"name": "com.huawei.hwddmp.servicebus.BIND_SERVICE"}      
    ] 
}

(2)聲明分布式獲取設(shè)備列表及設(shè)備信息的權(quán)限，如下所示：

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

(3)對(duì)于三方應(yīng)用還要求在實(shí)現(xiàn)Ability的代碼中顯式聲明需要使用的權(quán)限。

public class SampleSlice extends AbilitySlice implements IAbilityContinuation { 
    @Override 
    public void onStart(Intent intent) { 
        // 開(kāi)發(fā)者顯示聲明需要使用的權(quán)限 
        requestPermissionsFromUser(new String[]{"ohos.permission.DISTRIBUTED_DATASYNC", 
                                                "ohos.permission.servicebus.ACCESS_SERVICE", 
                                                "com.huawei.hwddmp.servicebus.BIND_SERVICE"}, 0); 
        super.onStart(intent);         
    } 
}

3) 為啟動(dòng)遠(yuǎn)程FA的按鈕添加點(diǎn)擊事件，獲取設(shè)備信息，實(shí)現(xiàn)啟動(dòng)遠(yuǎn)程FA的能力。

Button btn1 = (Button) findComponentById(ResourceTable.Id_migration_btn_01); 
btn1.setClickedListener(new Component.ClickedListener() { 
    @Override 
    public void onClick(Component component) { 
        // 調(diào)用DeviceManager的getDeviceList接口，通過(guò)FLAG_GET_ONLINE_DEVICE標(biāo)記獲得在線設(shè)備列表 
        List<DeviceInfo> onlineDevices = DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE); 
        // 判斷組網(wǎng)設(shè)備是否為空 
        if (onlineDevices.isEmpty()) { 
            return; 
        } 
        int numDevices = onlineDevices.size(); 
 
        ArrayList<String> deviceIds = new ArrayList<>(numDevices); 
        ArrayList<String> deviceNames = new ArrayList<>(numDevices); 
        onlineDevices.forEach((device) -> { 
            deviceIds.add(device.getDeviceId()); 
            deviceNames.add(device.getDeviceName()); 
        }); 
        // 我們這里只有兩個(gè)設(shè)備，所以選擇首個(gè)設(shè)備作為目標(biāo)設(shè)備 
        // 開(kāi)發(fā)者也可按照具體場(chǎng)景，通過(guò)別的方式進(jìn)行設(shè)備選擇 
        String selectDeviceId = deviceIds.get(0); 
         
        //獲取設(shè)備ID，最好放到工具類里，很多地方要用！ 
 
        if(selectDeviceId!=null){ 
            Intent intent2 = new Intent(); 
            Operation operation = new Intent.OperationBuilder() 
                    .withDeviceId(selectDeviceId) 
                    .withBundleName("cn.ybzy.hmsdemo") 
                    .withAbilityName("cn.ybzy.hmsdemo.RemoteAbility") 
                    .withFlags(Intent.FLAG_ABILITYSLICE_MULTI_DEVICE) 
                    .build(); 
            intent2.setOperation(operation); 
            // 通過(guò)AbilitySlice包含的startAbility接口實(shí)現(xiàn)跨設(shè)備啟動(dòng)FA 
            startAbility(intent2); 
        } 
    } 
});

6. 實(shí)戰(zhàn)將設(shè)備A運(yùn)行時(shí)的FA遷移到設(shè)備B，實(shí)現(xiàn)業(yè)務(wù)在設(shè)備間無(wú)縫遷移。

MigrationAbility

public class MigrationAbility extends Ability implements IAbilityContinuation  { 
    @Override 
    public void onStart(Intent intent) { 
        super.onStart(intent); 
        super.setMainRoute(MigrationAbilitySlice.class.getName()); 
    } 
 
    @Override 
    public boolean onStartContinuation() { 
        return true; 
    } 
 
    @Override 
    public boolean onSaveData(IntentParams intentParams) { 
        return true; 
    } 
 
    @Override 
    public boolean onRestoreData(IntentParams intentParams) { 
        return true; 
    } 
 
    @Override 
    public void onCompleteContinuation(int i) { 
 
    } 
}

MigrationAbilitySlice

public class MigrationAbilitySlice extends AbilitySlice implements IAbilityContinuation { 
    TextField textField; 
    String textStr = "請(qǐng)輸入數(shù)據(jù)..."; 
    @Override 
    public void onStart(Intent intent) { 
        super.onStart(intent); 
        super.setUIContent(ResourceTable.Layout_ability_migration); 
        textField = (TextField)findComponentById(ResourceTable.Id_textfield_migration); 
        textField.setText(textStr); 
        Button btn = (Button) findComponentById(ResourceTable.Id_migration_button); 
        btn.setClickedListener(new Component.ClickedListener() { 
            @Override 
            public void onClick(Component component) { 
                String deviceId = getDeviceId(); 
                if(deviceId!=null){ 
                    continueAbility(deviceId); 
                } 
            } 
        }); 
 
    } 
 
    private String getDeviceId(){ 
        // 調(diào)用DeviceManager的getDeviceList接口，通過(guò)FLAG_GET_ONLINE_DEVICE標(biāo)記獲得在線設(shè)備列表 
        List<DeviceInfo> onlineDevices = DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE); 
        // 判斷組網(wǎng)設(shè)備是否為空 
        if (onlineDevices.isEmpty()) { 
            return null; 
        } 
        int numDevices = onlineDevices.size(); 
 
        ArrayList<String> deviceIds = new ArrayList<>(numDevices); 
        ArrayList<String> deviceNames = new ArrayList<>(numDevices); 
        onlineDevices.forEach((device) -> { 
            deviceIds.add(device.getDeviceId()); 
            deviceNames.add(device.getDeviceName()); 
        }); 
        // 我們這里只有兩個(gè)設(shè)備，所以選擇首個(gè)設(shè)備作為目標(biāo)設(shè)備 
        // 開(kāi)發(fā)者也可按照具體場(chǎng)景，通過(guò)別的方式進(jìn)行設(shè)備選擇 
        String selectDeviceId = deviceIds.get(0); 
        return selectDeviceId; 
    } 
 
    @Override 
    public boolean onStartContinuation() { 
        return true; 
    } 
 
    @Override 
    public boolean onSaveData(IntentParams intentParams) { 
        intentParams.setParam("data",textField.getText()); 
        return true; 
    } 
 
    @Override 
    public boolean onRestoreData(IntentParams intentParams) { 
        textStr = intentParams.getParam("data").toString(); 
        return true; 
    } 
 
    @Override 
    public void onCompleteContinuation(int i) { 
 
    } 
 
    @Override 
    public void onRemoteTerminated() { 
 
    } 
}

此外，不同于啟動(dòng)行為，F(xiàn)A的遷移還涉及到狀態(tài)數(shù)據(jù)的傳遞。為此，繼承的IAbilityContinuation接口為開(kāi)發(fā)者提供遷移過(guò)程中特定事件的管理能力。通過(guò)自定義遷移事件相關(guān)的行為，最終實(shí)現(xiàn)對(duì)Ability的遷移。主要以較為常用的兩個(gè)事件，包括遷移發(fā)起端完成遷移的回調(diào)onCompleteContinuation(int result)以及接收到遠(yuǎn)端遷移行為傳遞數(shù)據(jù)的回調(diào)onRestoreData(IntentParams restoreData)。其他還包括遷移到遠(yuǎn)端設(shè)備的FA關(guān)閉的回調(diào)onRemoteTerminated()、用于本地遷移發(fā)起時(shí)保存狀態(tài)數(shù)據(jù)的回調(diào)onSaveData(IntentParams saveData)和本地發(fā)起遷移的回調(diào)onStartContinuation()。

7. 請(qǐng)求回遷

Button btn1 = (Button) findComponentById(ResourceTable.Id_migration_button_back); 
btn1.setClickedListener(new Component.ClickedListener() { 
    @Override 
    public void onClick(Component component) { 
        String deviceId = DeviceUtils.getDeviceId(); 
        if(deviceId!=null){ 
            continueAbilityReversibly(deviceId);  //可撤回遷移 
        } 
    } 
}); 
 
Button btn2 = (Button) findComponentById(ResourceTable.Id_migration_button_back2); 
btn2.setClickedListener(new Component.ClickedListener() { 
    @Override 
    public void onClick(Component component) { 
        reverseContinueAbility();  //撤回遷移 
    } 
});

1)設(shè)備A上的Page請(qǐng)求回遷。

2)系統(tǒng)回調(diào)設(shè)備B上Page及其AbilitySlice棧中所有AbilitySlice實(shí)例的IAbilityContinuation.onStartContinuation()方法，以確認(rèn)當(dāng)前是否可以立即遷移。

3)如果可以立即遷移，則系統(tǒng)回調(diào)設(shè)備B上Page及其AbilitySlice棧中所有AbilitySlice實(shí)例的IAbilityContinuation.onSaveData()方法，以便保存回遷后恢復(fù)狀態(tài)必須的數(shù)據(jù)。

4)如果保存數(shù)據(jù)成功，則系統(tǒng)在設(shè)備A上Page恢復(fù)AbilitySlice棧，然后回調(diào)IAbilityContinuation.onRestoreData()方法，傳遞此前保存的數(shù)據(jù)。

5)如果數(shù)據(jù)恢復(fù)成功，則系統(tǒng)終止設(shè)備B上Page的生命周期。

想了解更多內(nèi)容，請(qǐng)?jiān)L問(wèn)：

51CTO和華為官方合作共建的鴻蒙技術(shù)社區(qū)

https://harmonyos.51cto.com/#zz