Harmony OS 分布式操作（跨设备拉起以及Ability迁移） 精华

"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"}
    ]
1.
2.
3.
4.
5.
6.

public class MainAbility extends Ability {
    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        super.setMainRoute(MainAbilitySlice.class.getName());
//        申请权限
        requestPermissionsFromUser(new String[]{"ohos.permission.DISTRIBUTED_DATASYNC"}, 0);
    }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.

public class CommonTools {
//    获取软总线上的设备ID
    public static String getDeviceId(){
//        将在线设备获取下来存入List（不包括本机）
        List<DeviceInfo> deviceList = DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE);
/*      
        获取软总线中本机的设备ID(需要添加参数 context)
        KvManagerConfig kvManagerConfig = new KvManagerConfig(context);
        kvManagerConfig.getUserInfo().getUserId();
*/
        if (deviceList.isEmpty()){
            return null;
        }
        int deviceNum = deviceList.size();
//        ArrayList 类是一个可以动态修改的数组，没有固定大小的限制，可以添加或删除元素。
        List<String> deviceIds = new ArrayList<>(deviceNum);
        List<String> deviceNames = new ArrayList<>(deviceNum);
//        forEach() 方法用于调用数组的每个元素，并将元素传递给回调函数
        deviceList.forEach((device) ->{
            deviceIds.add(device.getDeviceId());
            deviceNames.add(device.getDeviceName());
        });
//        因为只开了两个虚拟设备，直接选用了列表里第0个device（即远端设备）作为要启动的远程设备
        String deviceIdStr = deviceIds.get(0);
        return deviceIdStr;
    }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.

private Component.ClickedListener myClickedListener = new Component.ClickedListener() {
        @Override
        public void onClick(Component component) {
            int component_id = component.getId();
            switch (component_id){
                case ResourceTable.Id_main_start_fa_btn:{
                    Intent startFaDe = new Intent();
//                    此时deviceId已经获取到了，调用上边写好获取在线设备Id的方法
                    Operation op = new Intent.OperationBuilder()
                            .withDeviceId(deviceId)
                            .withBundleName("com.example.myconnect")
                            .withAbilityName("com.example.myconnect.RemoteAbility")
                            .withFlags(Intent.FLAG_ABILITYSLICE_MULTI_DEVICE)
                            .build();
                    startFaDe.setOperation(op);
                    startFaDe.setParam("msg","我跨设备拉起你这个FA了");
                    startAbility(startFaDe);
                    break;
                }
                case ResourceTable.Id_main_migration_btn:{
                    Intent openSubMigrationPage = new Intent();
                    openSubMigrationPage.setElement(new ElementName(
//                            是否跨设备，空字符串表示不跨设备，否则传设备ID
                            "",
//                            包名
                            "com.example.myconnect",
//                            跳转到哪一个Ability
                            "com.example.myconnect.MigrationAbility"
                    ));
                    startAbility(openSubMigrationPage);
                    break;
                }
            }
        }
    };

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.

//（implements）要实现 IAbilityContinuation接口才能实现迁移
public class MigrationAbilitySlice extends AbilitySlice implements IAbilityContinuation {
    private Button btn;
    private Button back_btn;
    private TextField textField;
    private String msg;
    private String deviceId;
    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        super.setUIContent(ResourceTable.Layout_ability_migration);
//        获取在线设备Id
        deviceId = CommonTools.getDeviceId();
//        找到布局中的三个组件（一个Text以及两个Button）
        textField = findComponentById(ResourceTable.Id_migration_textfield);
        btn = findComponentById(ResourceTable.Id_migration_migration_btn);
        back_btn = findComponentById(ResourceTable.Id_migration_migration_back_btn);
//        对两个Button进行监听，重写onClick方法
        btn.setClickedListener(myClickedlistener);
        back_btn.setClickedListener(myClickedlistener);
//        在这个地方对应后边onRestoreData()方法，在这个地方设置Text的文本而不是在onRestoreData方法中设置文本，
//        因为迁移操作属于子线程，要在子线程中改变主线程里的UI组件可能会出问题
        textField.setText(msg);

    }

    Component.ClickedListener myClickedlistener = new Component.ClickedListener() {
        @Override
        public void onClick(Component component) {
            if (deviceId != null){
                switch (component.getId()){
                    case ResourceTable.Id_migration_migration_btn:{
/*
                          单纯迁移
                          continueAbility(deviceId);
 */
//                        迁移
                        continueAbilityReversibly(deviceId);
                        break;
                    }
                    case ResourceTable.Id_migration_migration_back_btn:{
//                        迁回
                        reverseContinueAbility();
                        break;
                    }
                }
            }
        }
    };

    @Override
    public void onActive() {
        super.onActive();
    }

    @Override
    public void onForeground(Intent intent) {
        super.onForeground(intent);
    }
    //    开始迁移时的回调函数，返回true才会执行下边onSaveData回调
    @Override
    public boolean onStartContinuation() {
        return true;
    }
    //    将发起迁移页面上的数据保存时回调，返回true才会接着执行onRestoreData
    @Override
    public boolean onSaveData(IntentParams intentParams) {
        String m = textField.getText();
        intentParams.setParam("msg",m);
        return true;
    }
    //    在远端恢复数据时回调，返回ture才会执行（远端）
    @Override
    public boolean onRestoreData(IntentParams intentParams) {
        msg = intentParams.getParam("msg").toString();
        return true;
    }
    //    迁移完成之后才会执行（本机）
    @Override
    public void onCompleteContinuation(int i) {

    }
}

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.

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

    }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.