harmony 鸿蒙@ohos.app.ability.UIExtensionAbility (带界面扩展能力基类)

  • 2023-10-30
  • 浏览 (570)

@ohos.app.ability.UIExtensionAbility (带界面扩展能力基类)

UIExtensionAbility是特定场景下带界面扩展能力的基类,继承自ExtensionAbility,新增带界面扩展能力相关的属性和方法。不支持开发者直接继承该基类。

说明:

本模块首批接口从API version 10 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
本模块接口仅可在Stage模型下使用。

导入模块

import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility';

属性

系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore

名称 类型 可读 可写 说明
context UIExtensionContext 上下文。

UIExtensionAbility.onCreate

onCreate(): void

UIExtensionAbility创建时回调,执行初始化业务逻辑操作。

系统能力:SystemCapability.Ability.AbilityRuntime.Core

UIExtensionAbility.onSessionCreate

onSessionCreate(want: Want, session: UIExtensionContentSession): void

当UIExtensionAbility界面内容对象创建后调用。

系统能力:SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名 类型 必填 说明
want Want 当前UIExtensionAbility的Want类型信息,包括ability名称、bundle名称等。
session UIExtensionContentSession UIExtensionAbility界面内容相关信息。

UIExtensionAbility.onSessionDestroy

onSessionDestroy(session: UIExtensionContentSession): void

当UIExtensionAbility界面内容对象销毁后调用。

系统能力:SystemCapability.Ability.AbilityRuntime.Core

参数:

参数名 类型 必填 说明
session UIExtensionContentSession UIExtensionAbility界面内容相关信息。

UIExtensionAbility.onForeground

onForeground(): void;

UIExtensionAbility生命周期回调,当UIExtensionAbility从后台转到前台时触发。

系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore

UIExtensionAbility.onBackground

onBackground(): void;

UIExtensionAbility生命周期回调,当UIExtensionAbility从前台转到后台时触发。

系统能力:SystemCapability.Ability.AbilityRuntime.AbilityCore

UIExtensionAbility.onDestroy

onDestroy(): void|Promise<void>;

UIExtensionAbility生命周期回调,在销毁时回调,执行资源清理等操作。 在执行完onDestroy生命周期回调后,应用可能会退出,从而可能导致onDestroy中的异步函数未能正确执行,比如异步写入数据库。可以使用异步生命周期,以确保异步onDestroy完成后再继续后续的生命周期。

系统能力:SystemCapability.Ability.AbilityRuntime.Core

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述(仅对系统应用开放)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞