HarmonyOS实战开发：WindowExtensionAbility（仅对系统应用开放）

最新推荐文章于 2024-07-25 15:38:56 发布

蜀道衫QAQ

最新推荐文章于 2024-07-25 15:38:56 发布

阅读量819

点赞数 16

分类专栏：鸿蒙文章标签： harmonyos 华为鸿蒙鸿蒙系统 android

本文链接：https://blog.csdn.net/2401_84194030/article/details/138168585

版权

鸿蒙专栏收录该内容

449 篇文章 5 订阅

订阅专栏

本文详细介绍了华为鸿蒙系统中的WindowExtensionAbility组件，它如何与UIExtensionComponent协同工作，实现跨应用界面的拉起和嵌入，以及开发步骤和生命周期回调。此外，还提到了与HarmonyOS和OpenHarmony开发相关的技术点，如DevEcoStudio工具和各种组件的使用。

摘要由CSDN通过智能技术生成

WindowExtensionAbility是一种ExtensionAbility组件，用于提供界面组合扩展能力，允许系统应用进行跨应用的界面拉起和嵌入。

WindowExtensionAbility必须和UIExtensionComponent一起配合使用，并根据需求处理被拉起应用的业务。WindowExtensionAbility支持以连接形式运行，系统应用必须添加UIExtensionComponent组件启动WindowExtensionAbility服务。

每个ExtensionAbility都有自己的Context，WindowExtensionAbility通过 WindowExtensionContext提供相关能力。本文描述中称被启动的WindowExtensionAbility为提供方，称启动WindowExtensionAbility的UIExtensionComponent组件为使用方。

说明：

本接口为系统接口，如果三方开发者想要实现应用进行跨应用的界面拉起和嵌入，请参考full-SDK替换指南将SDK替换为full-SDK。

设置一个嵌入式UIAbility

WindowExtensionAbility提供了onConnect()、onDisconnect()和onWindowReady()生命周期回调，根据需要重写对应的回调方法。

onWindowReady：当该Ability的应用窗口创建成功时触发该回调。
onConnect：当窗口扩展组件AbilityComponent连接该Ability时回调。
onDisconnect：当窗口扩展组件AbilityComponent断开与该Ability的连接时回调。

开发步骤

开发者在实现一个嵌入式应用时，需要在DevEco Studio工程中手动新建一个WindowExtensionAbility，具体步骤如下。

在工程Module对应的ets目录下，右键选择“New > Directory”，新建一个目录并命名为WindowExtAbility。
在WindowExtAbility目录，右键选择“New > ts File”，新建一个.ts文件并命名为WindowExtAbility.ts。

打开WindowExtAbility.ts文件，导入WindowExtensionAbility的依赖包，自定义类继承WindowExtensionAbility并实现onWindowReady()、onConnect()和onDisconnect()生命周期回调。

 import Extension from '@ohos.application.WindowExtensionAbility'
 import Want from '@ohos.app.ability.Want';
 import window from '@ohos.window';

 export default class WindowExtAbility extends Extension {
     onWindowReady(window: window.Window) {
         window.loadContent('WindowExtAbility/pages/index1').then(() => {
             window.getProperties().then((pro) => {
                 console.info("WindowExtension " + JSON.stringify(pro));
             })
             window.show();
         })
     }

     onConnect(want: Want) {
         console.info('JSWindowExtension onConnect ' + want.abilityName);
     }

     onDisconnect(want: Want) {
         console.info('JSWindowExtension onDisconnect ' + want.abilityName);
     }
 }复制到剪贴板错误复制

在工程Module对应的module.json5配置文件中注册WindowExtensionAbility，type标签需要设置为“window”，srcEntry标签表示当前ExtensionAbility组件所对应的代码路径。

{
  "module": {
    "extensionAbilities": [
         {
             "name": "WindowExtAbility",
             "srcEntry": "./ets/WindowExtAbility/WindowExtAbility.ts",
             "icon": "$media:icon",
             "description": "WindowExtension",
             "type": "window",
             "exported": true,
         }
     ],
  }
}

拉起一个嵌入式UIAbility

系统应用可以通过AbilityComponent容器加载创建好的WindowExtensionAbility。

开发步骤

开发者在连接一个嵌入式应用时，需要在DevEco Studio工程中相应的pages界面中加入AbilityComponent控件。
在AbilityComponent控件中写入正确的bundleName和abilityName。
设置好宽高。示例代码如下：

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        AbilityComponent({ abilityName: "WindowExtAbility", bundleName: "com.example.WindowExtAbility"})
          .width(500)
          .height(500)
      }
      .width('100%')
    }
    .height('100%')
    .backgroundColor(0x64BB5c)
  }
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料