返回发烧友论坛
发 帖  

[文章]HarmonyOS教程一基于分布式调度的能力，实现远程FA的启动

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

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

2. 搭建HarmonyOS环境      
我们首先需要完成HarmonyOS开发环境搭建，可参照如下步骤进行。
  • 安装DevEco Studio，详情请参考下载和安装软件。
  • 设置DevEco Studio开发环境，DevEco Studio开发环境需要依赖于网络环境，需要连接上网络才能确保工具的正常使用，可以根据如下两种情况来配置开发环境：
    • 如果可以直接访问Internet，只需进行下载HarmonyOS SDK操作。
    • 如果网络不能直接访问Internet，需要通过代理服务器才可以访问，请参考配置开发环境。
  • 开发者可以参考以下链接，完成设备调试的相关配置：
    • 使用真机进行调试
    • 使用模拟器进行调试

3. 申请所需要的权限      
在entrysrcmainconfig.json中申请以下4个权限：
  • ohos.permission.DISTRIBUTED_DEVICE_STATE_CHANGE：用于允许监听分布式组网内的设备状态变化。
  • ohos.permission.GET_DISTRIBUTED_DEVICE_INFO：用于允许获取分布式组网内的设备列表和设备信息。
  • ohos.permission.GET_BUNDLE_INFO：用于查询其他应用的信息。
  • ohos.permission.DISTRIBUTED_DATASYNC：用于允许不同设备间的数据交换。
    示例代码如下：

  1. module": {
  2. ......
  3.    "reqPermissions": [
  4.     {
  5.        "name": "ohos.permission.DISTRIBUTED_DEVICE_STATE_CHANGE"
  6.      },
  7.      {
  8.        "name": "ohos.permission.GET_DISTRIBUTED_DEVICE_INFO"
  9.      },
  10.      {
  11.        "name": "ohos.permission.GET_BUNDLE_INFO"
  12.      },
  13.      {
  14.        "name": "ohos.permission.DISTRIBUTED_DATASYNC"
  15.      }
  16.   ]
  17. }
复制代码

此外，还需要在实现Ability的代码中显式声明需要使用多设备协同访问的权限，示例代码如下：
  1. public class MainAbility extends Ability {
  2. [url=home.php?mod=space&uid=2735960]@Override[/url]
  3. public void onStart(Intent intent) {
  4.     requestPermissionsFromUser(new String[]{"ohos.permission.DISTRIBUTED_DATASYNC"},0);
  5.     super.onStart(intent);  
  6.     super.setMainRoute(MainAbilitySlice.class.getName());
  7.   }
  8. }
复制代码

4. 实现一个Button，响应点击事件
在MainAbilitySlice.java中开发一个页面，并在页面上绘制一个Button，示例代码如下：
  1. @Override
  2. public void onStart(Intent intent) {
  3.     super.onStart(intent);
  4.     DirectionalLayout layout = new DirectionalLayout(this);
  5.     ComponentContainer.LayoutConfig config = new ComponentContainer.LayoutConfig(ComponentContainer.LayoutConfig.MATCH_PARENT,  
  6.         ComponentContainer.LayoutConfig.MATCH_PARENT);
  7.     layout.setLayoutConfig(config);
  8.     Button btn = new Button(getContext());
  9.     ShapeElement buttonBg = new ShapeElement();
  10.     buttonBg.setRgbColor(new RgbColor(0, 125, 255));
  11.     buttonBg.setCornerRadius(25);
  12.     btn.setBackground(buttonBg);
  13.     ComponentContainer.LayoutConfig btnConfig = new ComponentContainer.LayoutConfig(ComponentContainer.LayoutConfig.MATCH_PARENT,  
  14.         ComponentContainer.LayoutConfig.MATCH_CONTENT);
  15.     btn.setLayoutConfig(btnConfig);
  16.     btn.setTextSize(50);
  17.     btn.setPadding(10, 10, 10, 10);
  18.     btn.setText("Start Remote FA");
  19.     layout.addComponent(btn);
  20.     btn.setClickedListener(component -> {
  21.        // 处理按钮响应，详情请见第3步，获取设备列表。
  22.     });
  23.     super.setUIContent(layout);
  24. }
复制代码

5. 获取设备列表   
在远程启动FA按钮的响应里面实现设备列表的获取，使用DeviceManager.getDeviceList(int flag)获取设备列表，flag通过传入DeviceInfo.FLAG_GET_ONLINE_DEVICE查询所有分布式网络中的在线设备，通过解析返回的DeviceInfo列表对象，获取待被远程启动的FA的设备的deviceId。示例代码如下：
  1. btn.setClickedListener(component -> {
  2. // 处理按钮响应，获取在线设备列表      
  3. List<DeviceInfo> deviceInfoList =  
  4. DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE);
  5.     for (DeviceInfo deviceInfo : deviceInfoList) {  
  6.         // 远程启动FA，详情请见第4步
  7.     }
  8. });
复制代码

6. 远程启动FA
构建用于远程启动FA的Intent，并远程启动FA。其中的BUNDLE_NAME和ABILITY_NAME为全局变量，表示需要启动的远程FA的BundleName（包名称）和AbilityName（待启动的Ability名称）。示例代码如下：
  1. // 远程启动FA
  2. Intent remoteIntent = new Intent();
  3. // 指定待启动FA的bundleName和abilityName
  4. // 例如：BUNDLE_NAME = "com.huawei.codelab"
  5. //       ABILITY_NAME = "com.huawei.codelab.MainAbility"
  6. // 设置分布式标记，表明当前涉及分布式能力
  7. Operation operation = new Intent.OperationBuilder().withDeviceId(deviceInfo.getDeviceId())
  8.     .withBundleName(BUNDLE_NAME)
  9.     .withAbilityName(ABILITY_NAME)
  10.     .withFlags(Intent.FLAG_ABILITYSLICE_MULTI_DEVICE)
  11.     .build();
  12. remoteIntent.setOperation(operation);
  13. try {
  14.     // 目标设备是否包含指定FA
  15.     List<AbilityInfo> abilityInfoList = getBundleManager().queryAbilityByIntent(remoteIntent, 0, 0);
  16.     if (abilityInfoList != null && !abilityInfoList.isEmpty()) {
  17.         startAbility(remoteIntent);
  18.     }
  19. } catch (RemoteException e) {
  20.     // 处理异常
  21. }
复制代码


7. 恭喜你     
通过对本教程的学习，你已经学会如何运用分布式调度的能力远程启动FA。

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

示例代码如下：
在MainAbility.java中完成如下代码：
  1. import ohos.aafwk.ability.Ability;
  2. import ohos.aafwk.content.Intent;

  4. public class MainAbility extends Ability {
  5. @Override
  6. public void onStart(Intent intent) {
  7.     requestPermissionsFromUser(new String[]{"ohos.permission.DISTRIBUTED_DATASYNC"},0);
  8.     super.onStart(intent);
  9.     super.setMainRoute(MainAbilitySlice.class.getName());  
  10.   }
  11. }

  13. 在MainAbilitySlice.java中完成如下代码：


  16. import ohos.aafwk.ability.AbilitySlice;
  17. import ohos.aafwk.content.Intent;
  18. import ohos.aafwk.content.Operation;
  19. import ohos.agp.colors.RgbColor;
  20. import ohos.agp.components.Button;
  21. import ohos.agp.components.ComponentContainer;
  22. import ohos.agp.components.DirectionalLayout;
  23. import ohos.agp.components.element.ShapeElement;
  24. import ohos.bundle.AbilityInfo;
  25. import ohos.distributedschedule.interwork.DeviceInfo;
  26. import ohos.distributedschedule.interwork.DeviceManager;
  27. import ohos.rpc.RemoteException;

  29. import java.util.List;

  31. public class MainAbilitySlice extends AbilitySlice {
  32.     //远程启动FA的BundleName ，请自行填写
  33.     private static final String BUNDLE_NAME = "com.huawei.codelab";
  34.     // 远程启动FA的AbilityName，请自行填写
  35.     private static final String ABILITY_NAME = "com.huawei.codelab.MainAbility";

  37.     @Override
  38.     public void onStart(Intent intent) {
  39.         super.onStart(intent);
  40.         DirectionalLayout layout = new DirectionalLayout(this);
  41.         ComponentContainer.LayoutConfig config = new ComponentContainer.LayoutConfig(
  42.             ComponentContainer.LayoutConfig.MATCH_PARENT,  
  43.             ComponentContainer.LayoutConfig.MATCH_PARENT);
  44.         layout.setLayoutConfig(config);
  45.         Button btn = new Button(getContext());
  46.         ShapeElement buttonBg = new ShapeElement();
  47.         buttonBg.setRgbColor(new RgbColor(0, 125, 255));
  48.         buttonBg.setCornerRadius(25);
  49.         btn.setBackground(buttonBg);
  50.         ComponentContainer.LayoutConfig btnConfig = new ComponentContainer.LayoutConfig(
  51.             ComponentContainer.LayoutConfig.MATCH_PARENT,  
  52.             ComponentContainer.LayoutConfig.MATCH_CONTENT);
  53.         btn.setLayoutConfig(btnConfig);
  54.         btn.setTextSize(50);
  55.         btn.setPadding(10, 10, 10, 10);
  56.         btn.setText("Start Remote FA");
  57.         layout.addComponent(btn);
  58.         btn.setClickedListener(component -> {
  59.             // 处理按钮响应，获取在线设备列
  60.             List<DeviceInfo> deviceInfoList = DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE);
  61.             for (DeviceInfo deviceInfo : deviceInfoList) {
  62.                 // 远程启动FA
  63.                 Intent remoteIntent = new Intent();
  64.                 Operation operation = new Intent.OperationBuilder()
  65.                     .withDeviceId(deviceInfo.getDeviceId())
  66.                     .withBundleName(BUNDLE_NAME)
  67.                     .withAbilityName(ABILITY_NAME)
  68.                     .withFlags(Intent.FLAG_ABILITYSLICE_MULTI_DEVICE)
  69.                     .build();
  70.                 remoteIntent.setOperation(operation);
  71.                 try {
  72.                     List<AbilityInfo> abilityInfoList = getBundleManager().queryAbilityByIntent(remoteIntent, 0, 0);
  73.                     if (abilityInfoList != null && !abilityInfoList.isEmpty()) {
  74.                         startAbility(remoteIntent);
  75.                     }
  76.                 } catch (RemoteException e) {
  77.                     // 处理异常
  78.                 }
  79.             }
  80.         });
  81.         super.setUIContent(layout);
  82.     }
  83. }
复制代码

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


举报

回帖

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容图片侵权或者其他问题，请联系本站作侵删。 侵权投诉
链接复制成功，分享给好友