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

自由的羽毛 发表于 2024-8-7 13:45:16

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

在用户使用设备的过程中，当使用情境发生变革时（比方从室内走到户外大概附近有更得当的设备等），之前使用的设备可能已经不得当继续当前的使命，此时，用户可以选择新的设备来继续当前的使命，原设备可按需决定是否退出使命，这个就是跨端迁移的场景。常见的跨端迁移场景实例：在平板上播放的视频，迁移到智慧屏继续播放，从而得到更佳的观看体验；平板上的视频应用退出。在应用开发层面，跨端迁移指在A端运行的UIAbility迁移到B端上，完成迁移后，B端UIAbility继续使命，而A端UIAbility可按需决定是否退出。
跨端迁移的焦点使命是将应用的当前状态（包罗页面控件、状态变量等）无缝迁移到另一设备，从而在新设备上无缝接续应用体验。这意味着用户在一台设备上进行的操作可以在另一台设备的雷同应用中快速切换并无缝衔接。
重要功能包罗：


[*] 支持用户自定义数据存储及规复。
[*] 支持页面路由信息和页面控件状态数据的存储及规复。
[*] 支持应用兼容性检测。
[*] 支持应用根据现实使用场景动态设置迁移状态（默认迁移状态为 ACTIVE 激活状态）。比方，编辑类应用在编辑文本的页面下才需要迁移，其他页面不需要迁移，则可以通过setMissionContinueState进行控制。
[*] 支持应用动态选择是否进行页面栈规复（默认进行页面栈信息规复）。比方，应用希望自定义迁移到其他设备后显示的页面，则可以通过SUPPORT_CONTINUE_PAGE_STACK_KEY进行控制。
[*] 支持应用动态选择迁移成功后是否退出迁移源端应用（默认迁移成功后退出迁移源端应用）。可以通过SUPPORT_CONTINUE_SOURCE_EXIT_KEY进行控制。
   阐明：
开发者可以开发具有迁移能力的应用，迁移的触发由系统应用完成。
运作机制

https://i-blog.csdnimg.cn/blog_migrate/8d1fccdd64d0a4d9e3db8571eb621270.png

[*]在源端，通过UIAbility的 onContinue()回调，开发者可以生存待接续的业务数据。比方，在浏览器应用中完成跨端迁移，开发者需要使用 onContinue()回调生存页面URL等业务内容，而系统将主动生存页面状态，如当前浏览进度。
[*]分布式框架提供了跨设备应用界面、页面栈以及业务数据的生存和规复机制，它负责将数据从源端发送到对端。
[*]在对端，同一UIAbility可以通过 onCreate()/onNewWant()接口来规复业务数据。
约束限定



[*]跨端迁移要求在同一UIAbility之间进行，也就是需要雷同的bundleName、abilityName和签名信息。
[*]为了得到最佳体验，使用wantParam传输的数据需要控制在100KB以下。
[*]当前部门ArkUI组件支持迁移后，将特定状态规复到对端设备。
开发步调


[*] 需要申请ohos.permission.DISTRIBUTED_DATASYNC权限。
[*] 同时需要在应用初次启动时弹窗向用户申请授权，使用方式请参见 向用户申请授权 。
[*] 在 module.json5设置文件 的abilities标签中设置跨端迁移标签continuable。
   {
   "module": {
       // ...
       "abilities": [
         {
         // ...
         "continuable": true, // 配置UIAbility支持迁移
         }
       ]
   }
   }

   阐明：
根据需要设置应用启动模式范例，设置详情请参照UIAbility组件启动模式。

[*]在源端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) {
         // 在兼容性校验不通过时返回MISMATCH
         return AbilityConstant.OnContinueResult.MISMATCH;
       }

       // 将要迁移的数据保存在wantParam的自定义字段（例如data）中
       const continueInput = '迁移的数据';
       wantParam['data'] = continueInput;

       return AbilityConstant.OnContinueResult.AGREE;
   }
   }

[*]源端设备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 params
          let 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状态，即迁移能力开启，可以迁移。
设置迁移能力的时机
迁移能力的改变可以根据现实业务需求和代码实现，发生在应用生命周期的绝大多数时机。本文先容常用的几种设置方式。
在UIAbility的 onCreate() 回调中调用接口，可以在应用创建时设置应用的迁移状态。
// 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 = 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 = false;
    return AbilityConstant.OnContinueResult.AGREE;
}
}
验证指导

为方便开发者验证已开发的可迁移应用，当前OpenHarmony提供了一个全局使掷中央demo作为迁移的入口。下面先容通过安装全局使掷中央来验证迁移的方式。
1. 编译安装全局使掷中央

设置情况

public-SDK不支持开发者使用全部的系统API，比方：全局使掷中央使用的**@ohos.distributedDeviceManager**不包罗在public_SDK中。因此为了精确编译安装全局使掷中央，开发者需要替换full-SDK，详细操作可参见 替换指南。
   阐明：
本文中的截图仅为参考，详细的显示界面请以现实使用的DevEco Studio和SDK的版本为准。
编译工程文件

​ a.新建OpenHarmony 空的工程，找到对应的文件夹替换下载文件
https://i-blog.csdnimg.cn/blog_migrate/2934b5877d9012b75fdd749e74951454.png
​ 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”。

[*]点击file->Project Structure。
https://i-blog.csdnimg.cn/blog_migrate/d9ac3d68ea011d65327788d1fb14feb3.png

[*]点击Signing Configs 点击OK。
https://i-blog.csdnimg.cn/blog_migrate/fdb90df022d609edd70f2f90dbc23c45.png

[*]毗连开发板运行天生demo。
2. 设备组网


[*]打开A，B两设备的计算器。
[*]点击右上角箭头选择B设备。
[*]在B设备选择信任设备，弹出PIN码。
[*]在A设备输入PIN码。
[*]已组网成功，验证方法：在A设备输入数字，B设备同步出现则证明组网成功。
3. 发起迁移


[*]在B设备打开多设备协同权限的应用，A设备打开全局使掷中央demo，A设备出现A设备名称(即：本机:OpenHarmony 3.2)和B设备名称(OpenHarmony 3.2)。
https://i-blog.csdnimg.cn/blog_migrate/54f356c3b2d42d72bf228ee371f9bb13.png

[*]点击B设备名称，然后出现B设备的应用。
https://i-blog.csdnimg.cn/blog_migrate/7d4552a12819af9e07bbd9ea7d5d02ae.png

[*]最后将应用拖拽到A设备名称处，A设备应用被拉起，B设备应用退出。
https://i-blog.csdnimg.cn/blog_migrate/728587388943d6ad8ffe42f78676e12d.png
为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05
《鸿蒙开发学习手册》：

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


[*]根本概念
[*]构建第一个ArkTS应用
[*]……
https://i-blog.csdnimg.cn/blog_migrate/da60b8f42181f7f9d7276a5749b952ba.png
开发底子知识：https://qr21.cn/FV7h05


[*]应用底子知识
[*]设置文件
[*]应用数据管理
[*]应用安全管理
[*]应用隐私保护
[*]三方应用调用管控机制
[*]资源分类与访问
[*]学习ArkTS语言
[*]……
https://i-blog.csdnimg.cn/blog_migrate/399acf2dd0083550d646e7127303d2e6.png
基于ArkTS 开发：https://qr21.cn/FV7h05


[*]Ability开发
[*]UI开发
[*]公共事件与关照
[*]窗口管理
[*]媒体
[*]安全
[*]网络与链接
[*]电话服务
[*]数据管理
[*]后台使命(Background Task)管理
[*]设备管理
[*]设备使用信息统计
[*]DFX
[*]国际化开发
[*]折叠屏系列
[*]……
https://i-blog.csdnimg.cn/blog_migrate/52f2adda9e3bb6ab141e75301e2d7452.png
鸿蒙开发口试真题（含参考答案）：https://qr18.cn/F781PH

https://i-blog.csdnimg.cn/blog_migrate/c1f8cde7842aea94dbfea28766d56bda.png
鸿蒙开发口试大盘集篇（共计319页）：https://qr18.cn/F781PH

1.项目开发必备口试题
2.性能优化方向
3.架构方向
4.鸿蒙开发系统底层方向
5.鸿蒙音视频开发方向
6.鸿蒙车载开发方向
7.鸿蒙南向开发方向
https://i-blog.csdnimg.cn/blog_migrate/54d2bb79318ad66bb11729cd0e18fa32.png

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

查看完整版本: 鸿蒙HarmonyOS应用开发——跨端迁移