一, 前言
此帖子是对参加HDC2021 Codelabs趣味闯关赛的总结,此Demo是基于Codelabs里Java电影卡片基础上开发的,添加了平行视界,服务流转功能知识点, 先说一下。
闯关赛题要求就是上面介绍的,我是24号才去参加Codelabs挑战赛的, 23号一直呆在Harmony应用与服务开发教室听课, 晚上听到参加了Codelabs挑战赛的小伙伴说, 闯关赛有些难度,特别是平行视界功能,之前没有接触过,23号时小伙伴也没有完成闯关赛,音乐会结束后我们回到酒店,打开电脑来研究起来,我开始是过了一遍Codelabs的平行视界Sample, 然后按照小伙伴说的,先弄一个电影服务卡片,然后点击卡片进到电影列表,点击电影列表某一项,平行视界显示详情,在详情页可以流转. 说到服务卡片, 我们都知道用JS来写比较快,要简单些, 由于我们的目的是要弄懂平行视界, 就直接用了Codelabs里的JS电影卡片,想加上平行视界, 看了N遍平行视界Sample, 修改了多次JS电影卡片,最终还是不能实现平行视界,当时已经是零晨3点多了,我和小伙伴说,看来今晚我们搞不定了,会不会是平视视界不支持JS Ability的, 先睡觉了. 第二天到了Codelabs挑战现场问了一下平行视界支持JS界面吗? 说不行,目前只支持Java的,无语了. 其实实现简单的平行视界, 也就是两个配置文件,一行Java代码都不用写, 首先配置一下config.json文件, 然后添加easygo.json文件,配置一下左边显示哪个Ability, 右边显示哪个Ability就可以了,下面来简单介绍一下开发过程。
二, 实现效果
B站视频:https://www.bilibili.com/video/BV1N34y1Z7Gj/
三, 工程搭建
打开Codelabs网站找到Java电影卡片, 点击参考到gitee下载这个Sample的源代码, 上面也说了, 这个实例是基于Java电影卡片基础上, 加入平行视界和服务流转功能, 下载完成后, 解压出来, 打开DevEco Studio开发工具, 点击File -> Open找到刚才解压出来的MovieCardDemo电影卡片实例。
四, 新增和修改文件介绍
先说一下项目要简单支持平行视界, 主要就是两个配置文件:
1. config.json配置支持平行视界, 在module下添加:
- "metaData": {
- "customizeData": [
- {
- "name": "EasyGoClient",
- "value": "true"
- }
- ]
- }
2. 添加easygo.json文件支持平行视界:
- {
- "easyGoVersion": "1.0",
- "client": "com.army.study", // 与config.json文件的bundleName一致
- "logicEntities": [
- {
- "head": {
- "function": "magicwindow",
- "required": "true"
- },
- "body": {
- "mode": "1",
- "abilityPairs": [
- {
- "from": "com.huawei.cookbook.MainAbility", // 显示在平行视界左边页面
- "to": "com.huawei.cookbook.MoviesDetailAbility" // 显示在平行视界右边页面
- }
- ],
- "UX": {
- "isDraggable": "true",
- "supportRotationUxCompat": "true",
- "supportDraggingToFullScreen": "ALL"
- }
- }
- }
- ]
- }
设备选择对话框DeviceDialog是封装好的一个类, 来自Codelabs平行视界代码里。
- package com.huawei.cookbook;
- import com.huawei.cookbook.slice.MoviesDetailAbilitySlice;
- import ohos.aafwk.ability.continuation.*;
- import ohos.app.Context;
- import ohos.hiviewdfx.HiLog;
- import ohos.hiviewdfx.HiLogLabel;
- public class DeviceDialog {
- private static final HiLogLabel LABEL_LOG = new HiLogLabel(3, 0xD001100, "chuangguan");
- // context Object
- private final Context context;
- // 获取流转任务管理服务管理类
- private final IContinuationRegisterManager continuationRegisterManager;
- // Ability token returned after the transfer task management service is registered
- private int abilityToken;
- // Device ID returned after a user selects a device in the device list
- private String selectDeviceId;
- // 设置流转任务管理服务设备状态变更的回调
- private final IContinuationDeviceCallback callback = new IContinuationDeviceCallback() {
- @Override
- public void onDeviceConnectDone(String str, String str1) {
- // Set the device ID after the user selects the device
- selectDeviceId = str;
- continuationRegisterManager.updateConnectStatus(abilityToken, selectDeviceId,
- DeviceConnectState.CONNECTED.getState(), null);
- returnDeviceId();
- }
- @Override
- public void onDeviceDisconnectDone(String str) {
- }
- };
- // 设置注册流转任务管理服务回调
- private final RequestCallback requestCallback = new RequestCallback() {
- @Override
- public void onResult(int result) {
- abilityToken = result;
- }
- };
- /**
- * Initialize the DeviceDialog, set the transfer task management service management class,
- * and register the transfer task management service management class.
- *
- * @param continuationRegisterManager continuationRegisterManager
- * @param slice slice
- * @since 2021-09-10
- */
- public DeviceDialog(IContinuationRegisterManager continuationRegisterManager, Context slice) {
- this.continuationRegisterManager = continuationRegisterManager;
- this.context = slice;
- // 注册
- registerManager();
- }
- // 注册流转任务管理服务管理类
- private void registerManager() {
- // 增加过滤条件
- ExtraParams params = new ExtraParams();
- String[] devTypes = new String[]{ExtraParams.DEVICETYPE_SMART_PAD, ExtraParams.DEVICETYPE_SMART_PHONE};
- params.setDevType(devTypes);
- continuationRegisterManager.register(context.getBundleName(), params, callback, requestCallback);
- }
- /**
- * 打开设备选择框
- *
- * @since 2021-09-10
- */
- public void showDeviceList() {
- // 设置过滤设备类型
- ExtraParams params = new ExtraParams();
- String[] devTypes = new String[]{ExtraParams.DEVICETYPE_SMART_PAD, ExtraParams.DEVICETYPE_SMART_PHONE};
- params.setDevType(devTypes);
- // 注册
- continuationRegisterManager.register(context.getBundleName(), params, callback, requestCallback);
- // 显示选择设备列表
- continuationRegisterManager.showDeviceList(abilityToken, params, null);
- }
- // Return the device ID
- private void returnDeviceId() {
- HiLog.info(LABEL_LOG, "deviceid::" + selectDeviceId);
- MoviesDetailAbilitySlice.setDeviceId(selectDeviceId);
- }
- /**
- * 断开流转任务管理服务
- *
- * @since 2021-09-10
- */
- public void clearRegisterManager() {
- // 解注册流转任务管理服务
- continuationRegisterManager.unregister(abilityToken, null);
- // 断开流转任务管理服务连接
- continuationRegisterManager.disconnect();
- }
- }
提示对话框Utils公共类:
- public static void creatToastDialog(Context context, String message) {
- Component component = LayoutScatter.getInstance(context)
- .parse(ResourceTable.Layout_layout_toast, null, false);
- Component componentText = component.findComponentById(ResourceTable.Id_msg_toast);
- if (componentText instanceof Text) {
- ((Text) componentText).setText(message);
- }
- new ToastDialog(context)
- .setComponent(component)
- .setSize(DirectionalLayout.LayoutConfig.MATCH_CONTENT, DirectionalLayout.LayoutConfig.MATCH_CONTENT)
- .setAlignment(LayoutAlignment.CENTER).show();
- }
下来说一下关于服务流转的代码, MoviesDetailAbility和MoviesDetailAbilitySlice都实现IAbilityContinuation接口, 并且实现接口里的方法:
- public class MoviesDetailAbility extends Ability implements IAbilityContinuation {
- @Override
- public void onStart(Intent intent) {
- super.onStart(intent);
- super.setMainRoute(MoviesDetailAbilitySlice.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) {
- }
- }
- public class MoviesDetailAbilitySlice extends AbilitySlice implements IAbilityContinuation {
- // 此处省略原来的代码
- @Override
- public boolean onStartContinuation() {
- return true;
- }
- @Override
- public boolean onSaveData(IntentParams saveData) {
- saveData.setParam("remoteMovieId", movieId);
- return true;
- }
- @Override
- public boolean onRestoreData(IntentParams restoreData) {
- this.movieId = Long.parseLong(restoreData.getParam("remoteMovieId").toString());
- return true;
- }
- @Override
- public void onCompleteContinuation(int i) {
- isCirculation = false;
- }
- }
要实现服务流转, 首先要在config.json权限申请, module下添加:
- "reqPermissions": [
- {
- "name": "ohos.permission.DISTRIBUTED_DATASYNC",
- "reason": "$string:entry_MoviesDetailAbility",
- "usedScene":
- {
- "ability": [
- "com.huawei.cookbook.MainAbility",
- "com.huawei.cookbook.MoviesDetailAbility"
- ],
- "when": "always"
- }
- },
- {
- "name": "ohos.permission.GET_DISTRIBUTED_DEVICE_INFO",
- "reason": "$string:entry_MoviesDetailAbility",
- "usedScene":
- {
- "ability": [
- "com.huawei.cookbook.MainAbility",
- "com.huawei.cookbook.MoviesDetailAbility"
- ],
- "when": "always"
- }
- }
- ]
同时也在应用入口提供显示权限申请:
- @Override
- public void onStart(Intent intent) {
- super.onStart(intent);
- super.setMainRoute(MainAbilitySlice.class.getName());
- // 声明跨端迁移访问的权限
- requestPermissionsFromUser(new String[]{"ohos.permission.DISTRIBUTED_DATASYNC"}, 0);
- addActionRoute(ACTION_DETAIL, MoviesDetailAbilitySlice.class.getName());
- initData();
- initMyHandler();
- }
到此就介绍完了, 大家是不是感觉到, 我就是一个搬运工, 在不同的Sample上, 合并成为一个, 这个Demo确实是这样, 把不同的知识点集合在一起, 形成一个符合要求的应用, 下来我打算再写一个一样需求的应用, 但是从创建空白项目开始, 把列表显示, 详情, 服务卡片, 平行视界, 服务流转体验出来, 大家有空也一起根据需求撸出来吧!!! 下面图片是当时HDC2021 Codelabs闯关赛原图。