代码拉取完成，页面将自动刷新
UIExtensionAbility是特定场景下带界面扩展能力的基类，继承自ExtensionAbility，新增带界面扩展能力相关的属性和方法。不支持开发者直接继承该基类。
说明：
本模块首批接口从API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
本模块接口仅可在Stage模型下使用。
import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility';
系统能力：SystemCapability.Ability.AbilityRuntime.AbilityCore
| 名称 | 类型 | 只读 | 必填 | 说明 |
|---|---|---|---|---|
| context | UIExtensionContext | 否 | 是 | UIExtensionAbility的上下文。 |
onCreate(): void
UIExtensionAbility创建时回调，执行初始化业务逻辑操作。
系统能力：SystemCapability.Ability.AbilityRuntime.Core
示例：
import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility';
const TAG: string = '[testTag] UIExtAbility';
export default class UIExtAbility extends UIExtensionAbility {
onCreate() {
console.info(TAG, `onCreate`);
}
}
onSessionCreate(want: Want, session: UIExtensionContentSession): void
当UIExtensionAbility界面内容对象创建后调用。
系统能力：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| want | Want | 是 | 当前UIExtensionAbility的Want类型信息，包括ability名称、bundle名称等。 |
| session | UIExtensionContentSession | 是 | UIExtensionAbility界面内容相关信息。 |
示例：
import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility';
import Want from '@ohos.app.ability.Want';
import UIExtensionContentSession from '@ohos.app.ability.UIExtensionContentSession';
const TAG: string = '[testTag] UIExtAbility';
export default class UIExtAbility extends UIExtensionAbility {
onSessionCreate(want: Want, session: UIExtensionContentSession) {
console.info(TAG, `onSessionCreate, want: ${JSON.stringify(want)}`);
}
}
onSessionDestroy(session: UIExtensionContentSession): void
当UIExtensionAbility界面内容对象销毁后调用。
系统能力：SystemCapability.Ability.AbilityRuntime.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| session | UIExtensionContentSession | 是 | UIExtensionAbility界面内容相关信息。 |
示例：
import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility';
import UIExtensionContentSession from '@ohos.app.ability.UIExtensionContentSession';
const TAG: string = '[testTag] UIExtAbility';
export default class UIExtAbility extends UIExtensionAbility {
onSessionDestroy(session: UIExtensionContentSession) {
console.info(TAG, `onSessionDestroy`);
}
}
onForeground(): void
UIExtensionAbility生命周期回调，当UIExtensionAbility从后台转到前台时触发。
系统能力：SystemCapability.Ability.AbilityRuntime.AbilityCore
示例：
import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility';
const TAG: string = '[testTag] UIExtAbility';
export default class UIExtAbility extends UIExtensionAbility {
onForeground() {
console.info(TAG, `onForeground`);
}
}
onBackground(): void
UIExtensionAbility生命周期回调，当UIExtensionAbility从前台转到后台时触发。
系统能力：SystemCapability.Ability.AbilityRuntime.AbilityCore
示例：
import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility';
const TAG: string = '[testTag] UIExtAbility';
export default class UIExtAbility extends UIExtensionAbility {
onBackground() {
console.info(TAG, `onBackground`);
}
}
onDestroy(): void | Promise<void>
返回值：
| 类型 | 说明 |
|---|---|
| Promise<void> | Promise对象。无返回结果的Promise对象。 |
UIExtensionAbility生命周期回调，在销毁时回调，执行资源清理等操作。 在执行完onDestroy生命周期回调后，应用可能会退出，从而可能导致onDestroy中的异步函数未能正确执行，比如异步写入数据库。可以使用异步生命周期，以确保异步onDestroy完成后再继续后续的生命周期。
系统能力：SystemCapability.Ability.AbilityRuntime.Core
示例：
import UIExtensionAbility from '@ohos.app.ability.UIExtensionAbility';
const TAG: string = '[testTag] UIExtAbility';
export default class UIExtAbility extends UIExtensionAbility {
onDestroy() {
console.info(TAG, `onDestroy`);
}
}
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手