鸿蒙设备合作伙伴,鸿蒙应用开发入门（七）：实现跨设备迁移

最新推荐文章于 2024-06-07 14:31:24 发布
最新推荐文章于 2024-06-07 14:31:24 发布
阅读量855 收藏 1
点赞数
文章标签： 鸿蒙设备合作伙伴

6.2 跨设备迁移

1. 分布式任务调度概述

在HarmonyOS中，分布式任务调度平台对搭载HarmonyOS的多设备构筑的“超级虚拟终端”提供统一的组件管理能力，为应用定义统一的能力基线、接口形式、数据结构、服务描述语言，屏蔽硬件差异；支持远程启动、远程调用、业务无缝迁移等分布式任务。

2. 实现调度的约束与限制

1)远程调用PA/FA，开发者需要在Intent中设置支持分布式的标记(例如：Intent.FLAG_ABILITYSLICE_MULTI_DEVICE表示该应用支持分布式调度)，否则将无法获得分布式能力。

2)开发者通过在config.json中的reqPermissions字段里添加权限申请：

(1)以获取跨设备连接的能力和分布式数据传输的权限。

分布式数据传输的权限：

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

三方应用使用权限：

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

系统应用使用权限：

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

(2)另外还有三个获取分布式设备信息需要的权限：

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

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

{ "name": "ohos.permission.GET_BUNDLE_INFO"}

注意：还需要在开发的时候，要在Ability里主动声明，要用到的权限。

3)FA(Feature Ability，Page模板的Ability)的调用支持启动和迁移行为，在进行调度时：

(1)当启动FA时，需要开发者在Intent中指定对端设备的deviceId、bundleName和abilityName。

(2)FA的迁移实现相同bundleName和abilityName的FA跨设备迁移，因此需要指定迁移设备的deviceId。

3. 实现场景介绍

下面以设备A(本地设备)和设备B(远端设备)为例，介绍下面我们要实现的场景：

1)设备A启动设备B的FA：在设备A上通过本地应用提供的启动按钮，启动设备B上对应的FA。

2)设备A的FA迁移至设备B：设备A上通过本地应用提供的迁移按钮，将设备A的业务无缝迁移到设备B中。

3)设备A的FA迁移至设备B，还可以实现主动撤回迁移。

4. 具体实现前先了解要用的接口

1)启动远程FA

startAbility(Intent intent)接口提供启动指定设备上FA和PA的能力，Intent中指定待启动FA的设备deviceId、bundleName和abilityName。

2)迁移FA

continueAbility(String deviceId)接口提供将本地FA迁移到指定设备上的能力，continueAbilityReversibly(String deviceId) 接口提供将本地FA迁移到指定设备上的能力，这种迁移可撤回， reverseContinueAbility()接口提供撤回迁移的能力。

5. 实战远程启动FA页面

1)编程实现上面场景的界面：

ability_main.xml

xmlns:ohos="http://schemas.huawei.com/res/ohos"

ohos:height="match_parent"

ohos:width="match_parent"

ohos:orientation="vertical">

ohos:id="$+id:migration_btn_01"

ohos:height="match_content"

ohos:width="300vp"

ohos:text="1.启动远程设备的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"

/>

ohos:id="$+id:migration_btn_02"

ohos:height="match_content"

ohos:width="300vp"

ohos:text="2.迁移到远程设备"

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"

/>

ohos:id="$+id:migration_btn_03"

ohos:height="match_content"

ohos:width="300vp"

ohos:text="3.可迁回的迁移远程设备"

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_bg.xml

ohos:shape="rectangle">

MigrationAbility和MigrationBackAbility

// 调用AbilitySlice模板实现一个用于控制基础功能的FA

// Ability和AbilitySlice类均需要实现IAbilityContinuation及其方法，才可以实现FA迁移。AbilitySlice的代码示例如下

public class SampleSlice extends AbilitySlice implements IAbilityContinuation {

@Override

public void onStart(Intent intent) {

super.onStart(intent);

super.setUIContent(layout);

}

ability_migration.xml

xmlns:ohos="http://schemas.huawei.com/res/ohos"

ohos:height="match_parent"

ohos:width="match_parent"

ohos:background_element="#00ffff"

ohos:orientation="vertical">

ohos:id="$+id:text_title"

ohos:height="match_content"

ohos:width="250vp"

ohos:background_element="#0088bb"

ohos:layout_alignment="horizontal_center"

ohos:text="下面是一个可编辑的文本框"

ohos:text_size="50"

ohos:padding="5vp"

ohos:top_margin="30vp"

/>

ohos:id="$+id:textfield_back"

ohos:height="250vp"

ohos:width="250vp"

ohos:hint="请输入..."

ohos:layout_alignment="horizontal_center"

ohos:background_element="#ffffff"

ohos:text_color="#888888"

ohos:text_size="20fp"

ohos:padding="5vp"

/>

ohos:id="$+id:migration_button"

ohos:height="match_content"

ohos:width="match_content"

ohos:text="点击迁移"

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"

/>

ability_migration_back.xml比ability_migration.xml多一个迁回按钮，另外主页上点击按钮跳转等，略...

2)使用分布式能力要求开发者在Ability对应的config.json中声明多设备协同访问的权限：

(1)三方应用部署权限、分布式数据传输的权限、系统应用使用权限的申请。

{

"reqPermissions": [

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

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

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

]

}

(2)声明分布式获取设备列表及设备信息的权限，如下所示：

{

"reqPermissions": [

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

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

{"name": "ohos.permission.GET_BUNDLE_INFO"}

]

}

(3)对于三方应用还要求在实现Ability的代码中显式声明需要使用的权限。

public class SampleSlice extends AbilitySlice implements IAbilityContinuation {

@Override

public void onStart(Intent intent) {

// 开发者显示声明需要使用的权限

requestPermissionsFromUser(new String[]{"ohos.permission.DISTRIBUTED_DATASYNC",

"ohos.permission.servicebus.ACCESS_SERVICE",

"com.huawei.hwddmp.servicebus.BIND_SERVICE"}, 0);

super.onStart(intent);

}

}

3) 为启动远程FA的按钮添加点击事件，获取设备信息，实现启动远程FA的能力。

Button btn1 = (Button) findComponentById(ResourceTable.Id_migration_btn_01);

btn1.setClickedListener(new Component.ClickedListener() {

@Override

public void onClick(Component component) {

// 调用DeviceManager的getDeviceList接口，通过FLAG_GET_ONLINE_DEVICE标记获得在线设备列表

List onlineDevices = DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE);

// 判断组网设备是否为空

if (onlineDevices.isEmpty()) {

return;

}

int numDevices = onlineDevices.size();

ArrayList deviceIds = new ArrayList<>(numDevices);

ArrayList deviceNames = new ArrayList<>(numDevices);

onlineDevices.forEach((device) -> {

deviceIds.add(device.getDeviceId());

deviceNames.add(device.getDeviceName());

});

// 我们这里只有两个设备，所以选择首个设备作为目标设备

// 开发者也可按照具体场景，通过别的方式进行设备选择

String selectDeviceId = deviceIds.get(0);

//获取设备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);

// 通过AbilitySlice包含的startAbility接口实现跨设备启动FA

startAbility(intent2);

}

}

});

6. 实战将设备A运行时的FA迁移到设备B，实现业务在设备间无缝迁移。

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 = "请输入数据...";

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

// 调用DeviceManager的getDeviceList接口，通过FLAG_GET_ONLINE_DEVICE标记获得在线设备列表

List onlineDevices = DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE);

// 判断组网设备是否为空

if (onlineDevices.isEmpty()) {

return null;

}

int numDevices = onlineDevices.size();

ArrayList deviceIds = new ArrayList<>(numDevices);

ArrayList deviceNames = new ArrayList<>(numDevices);

onlineDevices.forEach((device) -> {

deviceIds.add(device.getDeviceId());

deviceNames.add(device.getDeviceName());

});

// 我们这里只有两个设备，所以选择首个设备作为目标设备

// 开发者也可按照具体场景，通过别的方式进行设备选择

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

}

}

此外，不同于启动行为，FA的迁移还涉及到状态数据的传递。为此，继承的IAbilityContinuation接口为开发者提供迁移过程中特定事件的管理能力。通过自定义迁移事件相关的行为，最终实现对Ability的迁移。主要以较为常用的两个事件，包括迁移发起端完成迁移的回调onCompleteContinuation(int result)以及接收到远端迁移行为传递数据的回调onRestoreData(IntentParams restoreData)。其他还包括迁移到远端设备的FA关闭的回调onRemoteTerminated()、用于本地迁移发起时保存状态数据的回调onSaveData(IntentParams saveData)和本地发起迁移的回调onStartContinuation()。

7. 请求回迁

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)设备A上的Page请求回迁。

2)系统回调设备B上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onStartContinuation()方法，以确认当前是否可以立即迁移。

3)如果可以立即迁移，则系统回调设备B上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onSaveData()方法，以便保存回迁后恢复状态必须的数据。

4)如果保存数据成功，则系统在设备A上Page恢复AbilitySlice栈，然后回调IAbilityContinuation.onRestoreData()方法，传递此前保存的数据。

5)如果数据恢复成功，则系统终止设备B上Page的生命周期。

海豹不爱晒太阳
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
鸿蒙开发：应用组件跨设备交互（流转）【跨端迁移】
m0_70748845的博客
06-11 1624
在用户使用设备的过程中，当使用情境发生变化时（例如从室内走到户外或者周围有更适合的设备等），之前使用的设备可能已经不适合继续当前的任务，此时，用户可以选择新的设备来继续当前的任务，原设备可按需决定是否退出任务，这个就是跨端迁移的场景。常见的跨端迁移场景实例：在平板上播放的视频，迁移到智慧屏继续播放，从而获得更佳的观看体验；平板上的视频应用退出。在应用开发层面，跨端迁移指在A端运行的UIAbility迁移到B端上，完成迁移后，B端UIAbility继续任务，而A端UIAbility可按需决定是否退出。
华为Harmony鸿蒙开发笔记三：PageAbility跨设备迁移
y280903468的博客
12-26 1087
由于没有设备，模拟器又不支持启动多个，所以该功能没有实践，只贴代码，以后有机会再更新。 跨设备迁移，就是讲一个Ability（页面），从A设备，显示到B设备上的功能。 首先，讲需要迁移的Ability和它包含的Slice都实现IAbilityContinuation接口，并实现该接口的所有方法 package com.example.continuationdemo.slice; import com.example.continuationdemo.MyApplication; import c
鸿蒙OS流转之跨端迁移
最新发布
m0_64422261的博客
06-07 743
在实际项目开发中我们也可以自定义流转弹窗样式，但并不推荐这种方式，经测试发现只有在两个设备通过蓝牙连接的时候才能获取到设备列表，只有在特定的场景，例如手机与车机、手机与手表在实际使用过程中我们基本上是会保持蓝牙连接的，通过这种方式实现流转会更稳定。但如果不能保持蓝牙实时连接的场景则不推荐。1.官方API提供了DeviceManager.getDeviceList()来获取远端设备，具体代码如下。
HarmonyOS学习路之开发篇—流转（跨端迁移 一）
爱吃土豆丝的打工人的博客
07-10 1107
开发者在应用FA中通过调用流转任务管理服务、分布式任务调度的接口，实现跨端迁移。2. 设备A上的应用FA通过调用分布式任务调度的能力，向设备B的应用发起跨端迁移。应用FA需要自己管理流转状态，将流转状态从IDLE迁移到CONNECTING，并上报到流转任务管理服务。3. 应用自行退出。
鸿蒙，分布式任务调度，跨设备迁移FA
weixin_44753443的博客
07-06 461
鸿蒙，分布式任务调度，远程启动FA 权限的获取和声明式一样的 这里省略了https://blog.csdn.net/weixin_44753443/article/details/114086026 //实现迁移的接口IAbilityContinuation，这个接口不管是迁移的实现Ability还是它对应的AbilitySlice 都要实现 注意所有的重新方法返回true 否则会没反应 public class MigrationAbility extends Ability implements IA
鸿蒙开发之Service Ability
积跬步，至千里。
01-31 1395
鸿蒙开发之Service Ability基本概念创建Service注册Service启动Service停止Service连接Service生命周期 基本概念 基于Service模板的Ability（简称“Service”）主要用于后台运行任务（如执行音乐播放、文件下载等），但不提供用户交互界面。Service可由其他应用或Ability启动，即使用户切换到其他应用，Service仍将在后台继续运行。 1.Service是单实例的。在一个设备上，相同的Service只会存在一个实例。 2.如果多个Abi
book_鸿蒙入门HarmonyOS应用开发_书中源码.zip
02-07
【标题】"book_鸿蒙入门HarmonyOS应用开发_书中源码.zip" 提供了对鸿蒙操作系统（HarmonyOS）应用开发的基础教程资源，其中包含了一个名为 "book_HarmonyOS_demo-main" 的子文件。这个压缩包很可能是为初学者准备的...
HarmonyOS入门文档_鸿蒙学堂-0001.zip
06-12
《鸿蒙操作系统初探——HarmonyOS入门指南》 鸿蒙操作系统（HarmonyOS），作为华为自主开发的全新分布式操作系统，旨在打破设备间的壁垒，构建万物互联的新时代。本篇文章将深入浅出地介绍HarmonyOS的基础知识，...
华为鸿蒙：终端应用繁荣奇点将至，兼顾行业β与个股弹性.zip
12-16
鸿蒙操作系统，简称HarmonyOS，是华为公司自主研发的一款面向全场景的分布式操作系统，旨在打破设备之间的界限，实现跨平台、跨设备的无缝协同。自2019年首次发布以来，华为鸿蒙已经逐渐成为全球关注的焦点，尤其在...
HarmonyOS快速入门手册2.0.pdf
09-05
HarmonyOS 提供了用户程序框架、Ability 框架以及 UI 框架，支持应用开发过程中多终端的业务逻辑和界面逻辑进行复用，能够实现应用的一次开发、多端部署，提升了跨设备应用的开发效率。 统一 OS，弹性部署 HarmonyOS...
从零开始使用华为鸿蒙 OpenHarmony 开发游戏和表格渲染引擎.zip
02-07
华为鸿蒙系统，又称为 HarmonyOS，是一个面向全场景的分布式操作系统，它打破了单一设备的局限，支持多种设备间的无缝协同。开发者可以利用其开放的特性，为手机、平板、智能手表、智能家居等多种设备开发应用。特别...
鸿蒙HarmonyOS应用开发——跨端迁移_openharmony 跨端迁移包括哪些
2401_84182073的博客
04-14 720
/ 若不需要自动迁移页面栈信息，则需要在此处设置应用迁移后进入的页面。// 调用原因为迁移时，设置状态为可迁移，应对冷启动情况。// 调用原因为迁移时，设置状态为可迁移，应对热启动情况。// 进入该页面时，将应用设置为可迁移状态。// 点击该按钮时，将应用设置为可迁移状态。
鸿蒙HarmonyOS应用开发——跨端迁移
maniuT的博客
03-26 2720
在用户使用设备的过程中，当使用情境发生变化时（例如从室内走到户外或者周围有更适合的设备等），之前使用的设备可能已经不适合继续当前的任务，此时，用户可以选择新的设备来继续当前的任务，原设备可按需决定是否退出任务，这个就是跨端迁移的场景。常见的跨端迁移场景实例：在平板上播放的视频，迁移到智慧屏继续播放，从而获得更佳的观看体验；平板上的视频应用退出。在应用开发层面，跨端迁移指在A端运行的UIAbility迁移到B端上，完成迁移后，B端UIAbility继续任务，而A端UIAbility可按需决定是否退出。
2024年最全HarmonyOS 应用开发之跨端迁移保姆级教程~(1)，2024年最新2024年大厂HarmonyOS鸿蒙高级面试题分享
2401_84872471的博客
05-14 437
从API version 10开始，提供了支持动态配置迁移能力的功能。即应用可以根据实际使用场景，在需要迁移时开启应用迁移能力；在业务不需要迁移时则可以关闭迁移能力。开发者可以通过调用接口对迁移能力进行设置。默认状态下，应用的迁移能力为状态，即迁移能力开启，可以迁移。迁移能力的改变可以根据实际业务需求和代码实现，发生在应用生命周期的绝大多数时机。本文介绍常用的几种配置方式。在UIAbility的onCreate()回调中调用接口，可以在应用创建时设置应用的迁移状态。// …
【HarmonyOS NEXT】提供AAID、OAID的推荐使用场景和使用规则是什么
Mayism123的博客
03-22 882
需要设计app层级和设备层级的标识ID，ID的生成和变化需要与app和设备的生命周期相匹配，方便后续功能对ID的使用。希望提供HarmonyOS下所有官方ID的详细文档介绍，包括ID的生成规则、位数、触发ID变化的情况、建议ID使用的场景等。Asset本身不是ID，HarmonyOS NEXT不会直接提供卸载重装后不变的唯一设备ID供使用，但是提供对标iOS keychain的功能，可支持卸载重装后获取，需要您自己构建ID标识存储进去，即Asset Store Kit。
HarmonyOS 应用开发之跨端迁移保姆级教程~(1)，10年阿里开发架构师经验分享
2401_84166147的博客
04-15 749
当需要迁移的数据较大（100KB以上）时，也可以选择分布式文件进行数据迁移。支持应用动态选择迁移成功后是否退出迁移源端应用（默认迁移成功后退出迁移源端应用）。如果应用不想让系统自动退出迁移源端应用，则可以设置不退出，参数定义见 SUPPORT_CONTINUE_SOURCE_EXIT_KEY。如果应用不想使用系统默认恢复的页面栈，则可以设置不进行页面栈迁移，而需要在。应用在源端的页面栈中存在Index和Second路由，而在对端恢复时不需要按照源端页面栈进行恢复，需要恢复到指定页面。
鸿蒙神奇组件Ability的奇妙之旅
郭霖
08-12 1415
/ 今日科技快讯 /近日，小米雷军在北京园区带来了其年度演讲《我的梦想，我的选择》，同时发布了年度旗舰机小米MIX4等新品。雷军为小米首批用户每人赠送1999元红包，总计3.7亿元...
【HarmonyOS】1、HarmonyOS应用开发基础详解（持续更新）
Tellsea
06-21 2024
文章目录一、HarmonyOS应用基础详解1、读取文件内容（1）获取系统资源（2）获取element/string.json（3）获取element/color.json（4）获取profile下的文件内容（5）获取rawfile下的文件内容 一、HarmonyOS应用基础详解 1、读取文件内容 （1）获取系统资源 ResourceManager resourceManager = this.getResourceManager(); try { String title =
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值