鸿蒙HarmonyOS应用开发——跨端迁移

2024-03-26 19:44

本文主要是介绍鸿蒙HarmonyOS应用开发——跨端迁移,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

在用户使用设备的过程中,当使用情境发生变化时(例如从室内走到户外或者周围有更适合的设备等),之前使用的设备可能已经不适合继续当前的任务,此时,用户可以选择新的设备来继续当前的任务,原设备可按需决定是否退出任务,这个就是跨端迁移的场景。常见的跨端迁移场景实例:在平板上播放的视频,迁移到智慧屏继续播放,从而获得更佳的观看体验;平板上的视频应用退出。在应用开发层面,跨端迁移指在A端运行的UIAbility迁移到B端上,完成迁移后,B端UIAbility继续任务,而A端UIAbility可按需决定是否退出。

跨端迁移的核心任务是将应用的当前状态(包括页面控件、状态变量等)无缝迁移到另一设备,从而在新设备上无缝接续应用体验。这意味着用户在一台设备上进行的操作可以在另一台设备的相同应用中快速切换并无缝衔接。

主要功能包括:

  • 支持用户自定义数据存储及恢复。

  • 支持页面路由信息和页面控件状态数据的存储及恢复。

  • 支持应用兼容性检测。

  • 支持应用根据实际使用场景动态设置迁移状态(默认迁移状态为 ACTIVE 激活状态)。例如,编辑类应用在编辑文本的页面下才需要迁移,其他页面不需要迁移,则可以通过setMissionContinueState进行控制。

  • 支持应用动态选择是否进行页面栈恢复(默认进行页面栈信息恢复)。例如,应用希望自定义迁移到其他设备后显示的页面,则可以通过SUPPORT_CONTINUE_PAGE_STACK_KEY进行控制。

  • 支持应用动态选择迁移成功后是否退出迁移源端应用(默认迁移成功后退出迁移源端应用)。可以通过SUPPORT_CONTINUE_SOURCE_EXIT_KEY进行控制。

说明:
开发者可以开发具有迁移能力的应用,迁移的触发由系统应用完成。

运作机制

  1. 在源端,通过UIAbilityonContinue()回调,开发者可以保存待接续的业务数据。例如,在浏览器应用中完成跨端迁移,开发者需要使用 onContinue()回调保存页面URL等业务内容,而系统将自动保存页面状态,如当前浏览进度。
  2. 分布式框架提供了跨设备应用界面、页面栈以及业务数据的保存和恢复机制,它负责将数据从源端发送到对端。
  3. 在对端,同一UIAbility可以通过 onCreate()/onNewWant()接口来恢复业务数据。

约束限制

  • 跨端迁移要求在同一UIAbility之间进行,也就是需要相同的bundleNameabilityName和签名信息。
  • 为了获得最佳体验,使用wantParam传输的数据需要控制在100KB以下。
  • 当前部分ArkUI组件支持迁移后,将特定状态恢复到对端设备。

开发步骤

  1. 需要申请ohos.permission.DISTRIBUTED_DATASYNC权限。

  2. 同时需要在应用首次启动时弹窗向用户申请授权,使用方式请参见 向用户申请授权 。

  3. 在 module.json5配置文件 的abilities标签中配置跨端迁移标签continuable

   {"module": {// ..."abilities": [{// ..."continuable": true, // 配置UIAbility支持迁移}]}}

说明:
根据需要配置应用启动模式类型,配置详情请参照UIAbility组件启动模式。

  1. 在源端UIAbility中实现 onContinue() 回调。

UIAbility实例触发迁移时,onContinue() 回调在源端被调用,开发者可以在该接口中保存迁移数据,实现应用兼容性检测,决定是否支持此次迁移。

  • 保存迁移数据:开发者可以将要迁移的数据通过键值对的方式保存在wantParam参数中。
  • 应用兼容性检测:开发者可以通过从wantParam参数中获取对端应用的版本号与 源端应用版本号做兼容性校验。开发者可以在触发迁移时从onContinue()回调中wantParam.version获取到迁移对端应用的版本号与迁移源端应用版本号做兼容校验。
  • 迁移决策:开发者可以通过 onContinue() 回调的返回值决定是否支持此次迁移。
   import UIAbility from '@ohos.app.ability.UIAbility';import AbilityConstant from '@ohos.app.ability.AbilityConstant';export default class EntryAbility extends UIAbility {onContinue(wantParam: Record<string, Object>):AbilityConstant.OnContinueResult {let version = wantParam.version;let targetDevice = wantParam.targetDevice;console.info(`onContinue version = ${version}, targetDevice: ${targetDevice}`); // 准备迁移数据// 获取源端版本号let versionSrc: number = -1; // 请填充具体获取版本号的代码// 兼容性校验if (version !== versionSrc) {// 在兼容性校验不通过时返回MISMATCHreturn AbilityConstant.OnContinueResult.MISMATCH;}// 将要迁移的数据保存在wantParam的自定义字段(例如data)中const continueInput = '迁移的数据';wantParam['data'] = continueInput;return AbilityConstant.OnContinueResult.AGREE;}}
  1. 源端设备UIAbility实例在冷启动和热启动情况下分别会调用不同的接口来恢复数据和加载UI。
    在对端设备的UIAbility中,需要实现 onCreate()/onNewWant()接口来恢复迁移数据。

通过在 onCreate() / onNewWant() 回调中检查launchReason,可以判断此次启动是否有迁移触发。开发者可以从want中获取之前保存的迁移数据,并在数据恢复后调用restoreWindowStage()来触发页面恢复,包括页面栈信息。

   import UIAbility from '@ohos.app.ability.UIAbility';import AbilityConstant from '@ohos.app.ability.AbilityConstant';import Want from '@ohos.app.ability.Want';export default class EntryAbility extends UIAbility {storage : LocalStorage = new LocalStorage();onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {console.info('EntryAbility onCreate')if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) {// 将上述的保存的数据取出恢复let continueInput = '';if (want.parameters != undefined) {continueInput = JSON.stringify(want.parameters.data);console.info(`continue input ${continueInput}`)}// 将数据显示当前页面this.context.restoreWindowStage(this.storage);}}onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {console.info('EntryAbility onNewWant')if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) {// get user data from want paramslet continueInput = '';if (want.parameters != undefined) {continueInput = JSON.stringify(want.parameters.data);console.info(`continue input ${continueInput}`);}this.context.restoreWindowStage(this.storage);}}}

可选配置迁移能力

动态配置迁移能力

从API version 10开始,提供了支持动态配置迁移能力的功能。即应用可以根据实际使用场景,在需要迁移时开启应用迁移能力;在业务不需要迁移时则可以关闭迁移能力。

开发者可以通过调用 setMissionContinueState() 接口对迁移能力进行设置。默认状态下,应用的迁移能力为ACTIVE状态,即迁移能力开启,可以迁移。

设置迁移能力的时机

迁移能力的改变可以根据实际业务需求和代码实现,发生在应用生命周期的绝大多数时机。本文介绍常用的几种配置方式。

UIAbilityonCreate() 回调中调用接口,可以在应用创建时设置应用的迁移状态。

// EntryAbility.ets
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';export default class EntryAbility extends UIAbility {onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {// ...this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => {console.info(`setMissionContinueState: ${JSON.stringify(result)}`);});// ...}
}

在页面的onPageShow()回调中调用接口,可以设置单个页面出现时应用的迁移状态。

// PageName.ets
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import common from '@ohos.app.ability.common';
@Entry
@Component
struct PageName {private context = getContext(this) as common.UIAbilityContext;build() {// ...}// ...onPageShow(){// 进入该页面时,将应用设置为可迁移状态this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => {console.info(`setMissionContinueState ACTIVE result: ${JSON.stringify(result)}`);});}
}

在某个组件的触发事件中设置应用迁移能力。

// PageName.ets
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import common from '@ohos.app.ability.common';@Entry
@Component
struct PageName {private context = getContext(this) as common.UIAbilityContext;build() {// ...Button() {// ...}.onClick(()=>{// 点击该按钮时,将应用设置为可迁移状态this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => {console.info(`setMissionContinueState ACTIVE result: ${JSON.stringify(result)}`);});})}
}

保证迁移连续性

由于迁移加载时,对端拉起的应用可能执行过自己的迁移状态设置命令(例如,冷启动时对端在 onCreate() 中设置了 INACTIVE ;热启动时对端已打开了不可迁移的页面,迁移状态为 INACTIVE 等情况)。为了保证迁移过后的应用依然具有可以迁移回源端的能力,应在  onCreate()/ onNewWant() 的迁移调用判断中,将迁移状态设置为 ACTIVE 。

// EntryAbility.ets
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';export default class EntryAbility extends UIAbility {// ...onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {// ...// 调用原因为迁移时,设置状态为可迁移,应对冷启动情况this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => {console.info(`setMissionContinueState INACTIVE result: ${JSON.stringify(result)}`);});}onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {// ...// 调用原因为迁移时,设置状态为可迁移,应对热启动情况if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) {this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => {console.info(`setMissionContinueState ACTIVE result: ${JSON.stringify(result)}`);});}}// ...
}

按需迁移页面栈

支持应用动态选择是否进行页面栈恢复(默认进行页面栈信息恢复)。如果应用不想使用系统默认恢复的页面栈,则可以设置不进行页面栈迁移,而需要在onWindowStageRestore()设置迁移后进入的页面,参数定义见SUPPORT_CONTINUE_PAGE_STACK_KEY。

应用在源端的页面栈中存在Index和Second路由,而在对端恢复时不需要按照源端页面栈进行恢复,需要恢复到指定页面。

例如,UIAbility迁移不需要自动迁移页面栈信息。

// EntryAbility.ets
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import wantConstant from '@ohos.app.ability.wantConstant';
import window from '@ohos.window';export default class EntryAbility extends UIAbility {// ...onContinue(wantParam: Record<string, Object>) {console.info(`onContinue version = ${wantParam.version}, targetDevice: ${wantParam.targetDevice}`);wantParam[wantConstant.Params.SUPPORT_CONTINUE_PAGE_STACK_KEY] = false;return AbilityConstant.OnContinueResult.AGREE;}onWindowStageRestore(windowStage: window.WindowStage) {// 若不需要自动迁移页面栈信息,则需要在此处设置应用迁移后进入的页面windowStage.loadContent('pages/Index', (err, data) => {if (err.code) {return;}});}
}

按需退出

支持应用动态选择迁移成功后是否退出迁移源端应用(默认迁移成功后退出迁移源端应用)。如果应用不想让系统自动退出迁移源端应用,则可以设置不退出,参数定义见SUPPORT_CONTINUE_SOURCE_EXIT_KEY。

示例:UIAbility设置迁移成功后,源端不需要退出迁移应用。

import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import wantConstant from '@ohos.app.ability.wantConstant';export default class EntryAbility extends UIAbility {// ...onContinue(wantParam: Record<string, Object>) {console.info(`onContinue version = ${wantParam.version}, targetDevice: ${wantParam.targetDevice}`);wantParam[wantConstant.Params.SUPPORT_CONTINUE_SOURCE_EXIT_KEY] = false;return AbilityConstant.OnContinueResult.AGREE;}
}

验证指导

为方便开发者验证已开发的可迁移应用,当前OpenHarmony提供了一个全局任务中心demo作为迁移的入口。下面介绍通过安装全局任务中心来验证迁移的方式。

1. 编译安装全局任务中心

配置环境

public-SDK不支持开发者使用所有的系统API,例如:全局任务中心使用的**@ohos.distributedDeviceManager**不包括在public_SDK中。因此为了正确编译安装全局任务中心,开发者需要替换full-SDK,具体操作可参见 替换指南。

说明
本文中的截图仅为参考,具体的显示界面请以实际使用的DevEco Studio和SDK的版本为准。

编译工程文件

​ a.新建OpenHarmony 空的工程,找到对应的文件夹替换下载文件

​ b.自动签名,编译安装。

​ DevEco的自动签名模板默认签名权限为normal级。而本应用设计到ohos.permission.MANAGE_MISSIONS权限为system_core级别。自动生成的签名无法获得足够的权限,所以需要将权限升级为system_core级别,然后签名。

​ c.系统权限设置(以api10目录为例): 将Sdk目录下的openharmony\api版本(如:10)\toolchains\lib\UnsgnedReleasedProfileTemplate.json文件中的”apl”:“normal_core”改为”apl”:“system_core”。

  1. 点击file->Project Structure。

  1. 点击Signing Configs 点击OK。

  1. 连接开发板运行生成demo。

2. 设备组网

  1. 打开A,B两设备的计算器。
  2. 点击右上角箭头选择B设备。
  3. 在B设备选择信任设备,弹出PIN码。
  4. 在A设备输入PIN码。
  5. 已组网成功,验证方法:在A设备输入数字,B设备同步出现则证明组网成功。

3. 发起迁移

  1. 在B设备打开多设备协同权限的应用,A设备打开全局任务中心demo,A设备出现A设备名称(即:本机:OpenHarmony 3.2)和B设备名称(OpenHarmony 3.2)。

  1. 点击B设备名称,然后出现B设备的应用。

  1. 最后将应用拖拽到A设备名称处,A设备应用被拉起,B设备应用退出。

为了能让大家更好的学习鸿蒙(HarmonyOS NEXT)开发技术,这边特意整理了《鸿蒙开发学习手册》(共计890页),希望对大家有所帮助:https://qr21.cn/FV7h05

《鸿蒙开发学习手册》:

如何快速入门:https://qr21.cn/FV7h05

  1. 基本概念
  2. 构建第一个ArkTS应用
  3. ……

开发基础知识:https://qr21.cn/FV7h05

  1. 应用基础知识
  2. 配置文件
  3. 应用数据管理
  4. 应用安全管理
  5. 应用隐私保护
  6. 三方应用调用管控机制
  7. 资源分类与访问
  8. 学习ArkTS语言
  9. ……

基于ArkTS 开发:https://qr21.cn/FV7h05

  1. Ability开发
  2. UI开发
  3. 公共事件与通知
  4. 窗口管理
  5. 媒体
  6. 安全
  7. 网络与链接
  8. 电话服务
  9. 数据管理
  10. 后台任务(Background Task)管理
  11. 设备管理
  12. 设备使用信息统计
  13. DFX
  14. 国际化开发
  15. 折叠屏系列
  16. ……

鸿蒙开发面试真题(含参考答案):https://qr18.cn/F781PH

鸿蒙开发面试大盘集篇(共计319页):https://qr18.cn/F781PH

1.项目开发必备面试题
2.性能优化方向
3.架构方向
4.鸿蒙开发系统底层方向
5.鸿蒙音视频开发方向
6.鸿蒙车载开发方向
7.鸿蒙南向开发方向

这篇关于鸿蒙HarmonyOS应用开发——跨端迁移的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!


原文地址:
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.chinasem.cn/article/849644

相关文章

Android开发中gradle下载缓慢的问题级解决方法

《Android开发中gradle下载缓慢的问题级解决方法》本文介绍了解决Android开发中Gradle下载缓慢问题的几种方法,本文给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧... 目录一、网络环境优化二、Gradle版本与配置优化三、其他优化措施针对android开发中Gradle下载缓慢的问

MobaXterm远程登录工具功能与应用小结

《MobaXterm远程登录工具功能与应用小结》MobaXterm是一款功能强大的远程终端软件,主要支持SSH登录,拥有多种远程协议,实现跨平台访问,它包括多会话管理、本地命令行执行、图形化界面集成和... 目录1. 远程终端软件概述1.1 远程终端软件的定义与用途1.2 远程终端软件的关键特性2. 支持的

使用Go语言开发一个命令行文件管理工具

《使用Go语言开发一个命令行文件管理工具》这篇文章主要为大家详细介绍了如何使用Go语言开发一款命令行文件管理工具,支持批量重命名,删除,创建,移动文件,需要的小伙伴可以了解下... 目录一、工具功能一览二、核心代码解析1. 主程序结构2. 批量重命名3. 批量删除4. 创建文件/目录5. 批量移动三、如何安

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

《Android悬浮窗开发示例((动态权限请求|前台服务和通知|悬浮窗创建)》本文介绍了Android悬浮窗的实现效果,包括动态权限请求、前台服务和通知的使用,悬浮窗权限需要动态申请并引导... 目录一、悬浮窗 动态权限请求1、动态请求权限2、悬浮窗权限说明3、检查动态权限4、申请动态权限5、权限设置完毕后

在不同系统间迁移Python程序的方法与教程

《在不同系统间迁移Python程序的方法与教程》本文介绍了几种将Windows上编写的Python程序迁移到Linux服务器上的方法,包括使用虚拟环境和依赖冻结、容器化技术(如Docker)、使用An... 目录使用虚拟环境和依赖冻结1. 创建虚拟环境2. 冻结依赖使用容器化技术(如 docker)1. 创

SQL Server数据库迁移到MySQL的完整指南

《SQLServer数据库迁移到MySQL的完整指南》在企业应用开发中,数据库迁移是一个常见的需求,随着业务的发展,企业可能会从SQLServer转向MySQL,原因可能是成本、性能、跨平台兼容性等... 目录一、迁移前的准备工作1.1 确定迁移范围1.2 评估兼容性1.3 备份数据二、迁移工具的选择2.1

基于Python开发PPTX压缩工具

《基于Python开发PPTX压缩工具》在日常办公中,PPT文件往往因为图片过大而导致文件体积过大,不便于传输和存储,所以本文将使用Python开发一个PPTX压缩工具,需要的可以了解下... 目录引言全部代码环境准备代码结构代码实现运行结果引言在日常办公中,PPT文件往往因为图片过大而导致文件体积过大,

5分钟获取deepseek api并搭建简易问答应用

《5分钟获取deepseekapi并搭建简易问答应用》本文主要介绍了5分钟获取deepseekapi并搭建简易问答应用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需... 目录1、获取api2、获取base_url和chat_model3、配置模型参数方法一:终端中临时将加

使用DeepSeek API 结合VSCode提升开发效率

《使用DeepSeekAPI结合VSCode提升开发效率》:本文主要介绍DeepSeekAPI与VisualStudioCode(VSCode)结合使用,以提升软件开发效率,具有一定的参考价值... 目录引言准备工作安装必要的 VSCode 扩展配置 DeepSeek API1. 创建 API 请求文件2.

将sqlserver数据迁移到mysql的详细步骤记录

《将sqlserver数据迁移到mysql的详细步骤记录》:本文主要介绍将SQLServer数据迁移到MySQL的步骤,包括导出数据、转换数据格式和导入数据,通过示例和工具说明,帮助大家顺利完成... 目录前言一、导出SQL Server 数据二、转换数据格式为mysql兼容格式三、导入数据到MySQL数据