跨任务链返回（仅对系统应用开放）

介绍

本示例为一个仿桌面应用测试demo，使用@ohos.app.ability.ServiceExtensionAbility接口中ServiceExtensionContext类的startRecentAbility能力（系统能力：SystemCapability.Ability.AbilityRuntime.Core），实现了跨任务链返回的功能。

效果预览

EntryAbility	SecondAbility

使用说明

1.基于CrossChainBack工程（com.acts.abilityabacktoabilityb），对该工程编译产生的hap包进行手动签名。（仅CrossChainBack工程可实现跨任务链返回功能）。

2.安装签名成功后的hap包，启动仿桌面（Launcher）。

3.点击应用主界面上的应用图标，可以启动应用。

4.长按应用图标弹出菜单，点击打开，可以正常启动应用。

5.本应用包含：EntryAbility页面（页面中显示有"EntryAbility"文本）和SecondAbility页面（页面中显示有"SecondAbility"文本）。

6.在EntryAbility页面上点击StartSecondAbility按钮，打开SecondAbility，此时点击返回键，回到EntryAbility页面而不是桌面。

工程目录

entry/src/main/ets/
|---entryability
|  |---EntryAbility.ts                         
|---logger
|  |---Logger.ts
|---pages
|  |---Index.ets                               // EntryAbilit页面
|  |---IndexSecond.ets                         // SecondAbility页面
|---secondability
|  |---SecondAbility.ts
|---serviceability
|  |---ServiceAbility.ts                       // 后台拉起SecondAbility

具体实现

• 拉起任务至前台显示的功能接口封装在LauncherAbilityManager，源码参考：LauncherAbilityManager.ts。
  • 跨任务链返回：在ServiceExtensionAbility，使用ServiceExtensionContext.startRecentAbility(),将Want中将"ABILITY_BACK_TO_OTHER_MISSION_STACK"(返回当前任务链字段)设置为"true",以实现返回至打开ServiceExtensionAbility的ability的功能。
  • 接口参考：@ohos.app.ability.wantConstant、@ohos.app.ability.ServiceExtensionAbility

相关权限

ohos.permission.START_ABILITIES_FROM_BACKGROUND

依赖

本测试demo需要安装在仿桌面应用上进行测试。launcher应用地址：Launcher

约束与限制

1.本示例仅支持标准系统上运行，支持设备：RK3568。

2.本示例已适配API version 9版本SDK，版本号：3.2.11.9。

3.本示例需要使用DevEco Studio 3.1 Beta2 (Build Version: 3.1.0.400 构建 2023年4月7日)才可编译运行。

4.本示例使用了ServiceExtensionAbility，需要在签名证书UnsgnedReleasedProfileTemplate.json中配置"app-privilege-capabilities": ["AllowAppUsePrivilegeExtension"]，否则安装失败。具体操作指南可参考应用特权配置指南。

5.本示例所配置的权限为system_basic级别(相关权限级别可通过权限定义列表查看)，需要手动配置对应级别的权限签名(具体操作可查看自动化签名方案)。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/SystemFeature/ApplicationModels/TestRely/LauncherTest/CrossChainBack/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master