鸿蒙HarmonyOS应用开发——跨端迁移_openharmony 跨端迁移包括哪些(1)// 将数据显示当前页面 th

// 将数据显示当前页面 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[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; } }