1. 介绍

开发者在应用中集成分布式调度能力，通过调用指定能力的分布式接口，实现跨设备能力调度。根据Ability模板及意图的不同，分布式任务调度向开发者提供六种能力：启动远程FA（Feature Ability）、启动远程PA（Particle Ability）、关闭远程PA、连接远程PA、断开连接远程PA和FA跨设备迁移。分布式任务调度的详细介绍可以参考分布式任务调度。

🕮 说明实现远程启动FA，需要至少两个设备处于同一个分布式网络中，可以通过如下操作实现：1. 所有设备接入同一网络;2.所有设备登录相同华为帐号;3.所有设备上开启"设置->更多连接->多设备协同 "。

本教程以“基于分布式调度远程启动FA”为例，结合权限申请、Button事件响应、获取设备列表、远程启动FA的开发过程，让您快速了解分布式调度能力。

2. 申请所需要的权限

在entry\src\main\config.json中申请以下4个权限：

1. ohos.permission.DISTRIBUTED_DEVICE_STATE_CHANGE：用于允许监听分布式组网内的设备状态变化。
2. ohos.permission.GET_DISTRIBUTED_DEVICE_INFO：用于允许获取分布式组网内的设备列表和设备信息。
3. ohos.permission.GET_BUNDLE_INFO：用于查询其他应用的信息。
4. ohos.permission.DISTRIBUTED_DATASYNC：用于允许不同设备间的数据交换。

示例代码如下：

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

此外，还需要在实现Ability的代码中显式声明需要使用多设备协同访问的权限，示例代码如下：

public class MainAbility extends Ability { 
@Override 
public void onStart(Intent intent) { 
    requestPermissionsFromUser(new String[]{"ohos.permission.DISTRIBUTED_DATASYNC"},0); 
    super.onStart(intent);  
  } 
}

3. 实现一个Button，响应点击事件

在MainAbilitySlice.java中开发一个页面，并在页面上绘制一个Button，示例代码如下：

@Override 
public void onStart(Intent intent) { 
    super.onStart(intent); 
    DirectionalLayout layout = new DirectionalLayout(this); 
    ComponentContainer.LayoutConfig config = new ComponentContainer.LayoutConfig(ComponentContainer.LayoutConfig.MATCH_PARENT,  
        ComponentContainer.LayoutConfig.MATCH_PARENT); 
    layout.setLayoutConfig(config); 
    Button btn = new Button(getContext()); 
    ShapeElement buttonBg = new ShapeElement(); 
    buttonBg.setRgbColor(new RgbColor(0, 125, 255)); 
    buttonBg.setCornerRadius(25); 
    btn.setBackground(buttonBg); 
    ComponentContainer.LayoutConfig btnConfig = new ComponentContainer.LayoutConfig(ComponentContainer.LayoutConfig.MATCH_PARENT,  
        ComponentContainer.LayoutConfig.MATCH_CONTENT); 
    btn.setLayoutConfig(btnConfig); 
    btn.setTextSize(50); 
    btn.setPadding(10, 10, 10, 10); 
    btn.setText("Start Remote FA"); 
    layout.addComponent(btn); 
    btn.setClickedListener(component -> { 
       // 处理按钮响应，详情请见第3步，获取设备列表。 
    }); 
    super.setUIContent(layout); 
}

4. 获取设备列表

在远程启动FA按钮的响应里面实现设备列表的获取，使用DeviceManager.getDeviceList（int flag）获取设备列表，flag通过传入DeviceInfo.FLAG_GET_ONLINE_DEVICE查询所有分布式网络中的在线设备，通过解析返回的DeviceInfo列表对象，获取待被远程启动的FA的设备的deviceId。示例代码如下：

btn.setClickedListener(component -> { 
// 处理按钮响应，获取在线设备列表      
List<DeviceInfo> deviceInfoList =  
DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE); 
    for (DeviceInfo deviceInfo : deviceInfoList) {  
        // 远程启动FA，详情请见第4步 
    } 
});

5. 远程启动FA

构建用于远程启动FA的Intent，并远程启动FA。其中的BUNDLE_NAME和ABILITY_NAME为全局变量，表示需要启动的远程FA的BundleName（包名称）和AbilityName（待启动的Ability名称）。示例代码如下：

// 远程启动FA 
Intent remoteIntent = new Intent(); 
// 指定待启动FA的bundleName和abilityName 
// 例如：BUNDLE_NAME = "com.huawei.codelab" 
//       ABILITY_NAME = "com.huawei.codelab.MainAbility" 
// 设置分布式标记，表明当前涉及分布式能力 
Operation operation = new Intent.OperationBuilder().withDeviceId(deviceInfo.getDeviceId()) 
    .withBundleName(BUNDLE_NAME) 
    .withAbilityName(ABILITY_NAME) 
    .withFlags(Intent.FLAG_ABILITYSLICE_MULTI_DEVICE) 
    .build(); 
remoteIntent.setOperation(operation); 
try { 
    // 目标设备是否包含指定FA 
    List<AbilityInfo> abilityInfoList = getBundleManager().queryAbilityByIntent(remoteIntent, 0, 0); 
    if (abilityInfoList != null && !abilityInfoList.isEmpty()) { 
        startAbility(remoteIntent); 
    } 
} catch (RemoteException e) { 
    // 处理异常 
}

6. 完整示例

以手机为例，点击页面按钮，会拉起同一网络中的其余使用同一华为帐号登录的手机上的指定FA，此处需要至少两台手机进行验证。实现效果如下：

示例代码如下：

import ohos.aafwk.ability.AbilitySlice; 
import ohos.aafwk.content.Intent; 
import ohos.aafwk.content.Operation; 
import ohos.agp.colors.RgbColor; 
import ohos.agp.components.Button; 
import ohos.agp.components.ComponentContainer; 
import ohos.agp.components.DirectionalLayout; 
import ohos.agp.components.element.ShapeElement; 
import ohos.bundle.AbilityInfo; 
import ohos.distributedschedule.interwork.DeviceInfo; 
import ohos.distributedschedule.interwork.DeviceManager; 
import ohos.rpc.RemoteException; 
 
import java.util.List; 
 
public class MainAbilitySlice extends AbilitySlice { 
    //远程启动FA的BundleName ，请自行填写 
    private static final String BUNDLE_NAME = "com.huawei.codelab"; 
    // 远程启动FA的AbilityName，请自行填写 
    private static final String ABILITY_NAME = "com.huawei.codelab.MainAbility"; 
 
    @Override 
    public void onStart(Intent intent) { 
        super.onStart(intent); 
        DirectionalLayout layout = new DirectionalLayout(this); 
        ComponentContainer.LayoutConfig config = new ComponentContainer.LayoutConfig( 
            ComponentContainer.LayoutConfig.MATCH_PARENT,  
            ComponentContainer.LayoutConfig.MATCH_PARENT); 
        layout.setLayoutConfig(config); 
        Button btn = new Button(getContext()); 
        ShapeElement buttonBg = new ShapeElement(); 
        buttonBg.setRgbColor(new RgbColor(0, 125, 255)); 
        buttonBg.setCornerRadius(25); 
        btn.setBackground(buttonBg); 
        ComponentContainer.LayoutConfig btnConfig = new ComponentContainer.LayoutConfig( 
            ComponentContainer.LayoutConfig.MATCH_PARENT,  
            ComponentContainer.LayoutConfig.MATCH_CONTENT); 
        btn.setLayoutConfig(btnConfig); 
        btn.setTextSize(50); 
        btn.setPadding(10, 10, 10, 10); 
        btn.setText("Start Remote FA"); 
        layout.addComponent(btn); 
        btn.setClickedListener(component -> { 
            // 处理按钮响应，获取在线设备列 
            List<DeviceInfo> deviceInfoList = DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE); 
            for (DeviceInfo deviceInfo : deviceInfoList) { 
                // 远程启动FA 
                Intent remoteIntent = new Intent(); 
                Operation operation = new Intent.OperationBuilder() 
                    .withDeviceId(deviceInfo.getDeviceId()) 
                    .withBundleName(BUNDLE_NAME) 
                    .withAbilityName(ABILITY_NAME) 
                    .withFlags(Intent.FLAG_ABILITYSLICE_MULTI_DEVICE) 
                    .build(); 
                remoteIntent.setOperation(operation); 
                try { 
                    List<AbilityInfo> abilityInfoList = getBundleManager().queryAbilityByIntent(remoteIntent, 0, 0); 
                    if (abilityInfoList != null && !abilityInfoList.isEmpty()) { 
                        startAbility(remoteIntent); 
                    } 
                } catch (RemoteException e) { 
                    // 处理异常 
                } 
            } 
        }); 
        super.setUIContent(layout); 
    } 
}

🕮 说明以上代码仅demo演示参考使用，产品化的代码需要考虑数据校验和国际化。

@文章转载自HUAWEI Codelab