鸿蒙OS开发文档 鸿蒙OS ohos.aafwk.ability概述

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

提供总体 HarmonyOS 应用程序开发模型的高级类。

HarmonyOS 应用程序是使用HarmonyOS的核心组件 Ability 定义的。该能力有三种类型的模板,包括网页,服务和数据。

  • 能力使用页面模板表示与用户界面的能力,并且必须包括 AbilitySlice,其是用于页面显示的最小单位。例如,您可以使用这些功能来拍照和查看地图。
  • 能力使用本服务模板表示在后台运行一个没有用户界面的能力。例如,您可以使用这些功能在后台启用音乐播放和地图导航。
  • 能力使用数据模板代表应用程序间的数据操作和访问一个没有用户界面的能力。例如,您可以使用这些功能来搜索联系人并访问图像,音频片段和视频片段。

界面摘要

接口描述
AbilityForm.OnAcquiredCallback提供在客户端上获取或销毁由供应商创建的 AbilityForm 实例时调用的回调方法。
AbilityLifecycleCallbacks提供用于侦听应用程序中功能的所有生命周期更改的回调。
IAbilityConnection提供连接或断开使用“服务”模板的远程功能时调用的回调方法。
IAbilityContinuation启用在分布式系统中实施迁移的Ability。
IDataAbilityObserver注册观察者以监视指定的数据。
ILifecycle生成一个Lifecycle对象。
ILifecycleObserver将类标识为 ILifecycleObserver。
LifecycleStateObserver观察特定的生命周期事件并响应生命周期更改。

课程总结

描述
Ability能力是 HarmonyOS 应用程序可以提供的功能的抽象。
Ability.LayoutParamsHelper帮助您使用 Intent 设置应用程序启动窗口的布局参数。
Ability.WindowAttributeHelper帮助您使用 Intent 设置当前应用程序的窗口属性。
AbilityForm显示有关另一种能力的简要信息。
AbilityPackage用户用来初始化每个 hap 的基类。
AbilitySlice作为使用 Page 模板的Ability的基本单位,AbilitySlice 为服务逻辑和 UI 显示提供了带有载体的功能。
AbilitySliceAnimator自定义 AbilitySlice实例之间的过渡动画。
DataAbilityHelper帮助应用程序访问数据。
DataAbilityOperation在数据库上执行操作。
DataAbilityOperation.builder创建一个 DataAbilityOperation。
DataAbilityResult保存数据运算结果。
DattaUriUtils一个实用程序类,用于处理使用可数据性方案的 Uri 对象。
DeviceConfigInfo提供有关您可以通过调用 IAbilityManager.getDeviceConfigInfo()获得的应用程序的设备配置要求的信息。
intentAbility使用服务模板的功能的基类,该模板用于处理工作线程中的后台任务,以避免在主线程中运行耗时的任务,从而确保应用程序的响应能力。
Lifecycle提供一个类供您观察 Ability 或 AbilitySlice 的生命周期。
LifecycleObserver观察并响应生命周期更改。
LocalRemoteObject这是用于启动本地服务的 LocalRemoteObject 抽象。
MemoryInfo封装正在运行的应用程序的内存使用信息。
OnclickListener提供在 AbilityForm 供应商处注册的用于侦听单击事件的回调方法。
PathMatcher使用数据模板存储和匹配数据库和文件路径。
ProcessErrorInfo处理错误状态信息。
RunningProcessInfo封装正在运行的应用程序的进程信息。
SystemMemoryInfo 提供您可以通过调用IAbilityManager.getSystemMemoryInfo(ohos.aafwk.ability.SystemMemoryInfo)获得的系统内存信息。
ViewListener一个基类,用于提供在 AbilityForm 供应商处注册的回调方法,以侦听单击或触摸事件。
ViewStatus从供应商处获取 AbilityForm 客户端的查看状态。

枚举摘要

枚举描述
ContinuationState枚举已实现 IAbilityContinuation 且处于可逆迁移过程的 Ability 的迁移状态,该过程允许将能力迁移回去。
Lifecycle.Event指示生命周期事件。

例外摘要

例外描述
AbilitySliceRuntimeException描述在 AbilitySlice 中发生运行时异常时引发的异常。
DataAbilityRemoteException描述进程退出异常。
DataAbilityDeadException描述远程进程退出异常。
OperationExecuteException描述使用数据模板的功能中的操作执行异常发生时引发的异常。
ProfileMissingConfigException描述概要文件缺少必要配置时引发的异常。