openharmony 鸿蒙 js-apis-bundleManager-abilityInfo

2025-06-12 浏览 (1)

AbilityInfo

Ability信息,可以通过bundleManager.getBundleInfoForSelf获取Ability信息,其中参数bundleFlags至少包含GET_BUNDLE_INFO_WITH_HAP_MODULE和GET_BUNDLE_INFO_WITH_ABILITY。

说明: 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import { bundleManager } from '@kit.AbilityKit';

AbilityInfo

系统能力: SystemCapability.BundleManager.BundleFramework.Core

名称类型只读可选说明
bundleNamestring是否应用Bundle名称。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
moduleNamestring是否Ability所属的模块名称。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
namestring是否Ability名称。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
labelstring是否Ability对用户显示的名称的资源描述符,如:"label": "$string: mainability_description"。从API version 20开始,如果是通过bundleManager.getAbilityInfo获取Ability信息,该字段为Ability对用户显示的名称。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
labelIdnumber是否Ability的标签资源id。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
descriptionstring是否Ability的描述。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
descriptionIdnumber是否Ability的描述资源id。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
iconstring是否Ability的图标资源描述符,如"icon": "$media:icon"。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
iconIdnumber是否Ability的图标资源id。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
processstring是否Ability的进程名称。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
exportedboolean是否判断Ability是否可以被其他应用调用,取值为true表示Ability可以被其他应用调用,取值为false表示Ability不可以被其他应用调用。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
typebundleManager.AbilityType是否Ability类型。
模型约束: 此接口仅可在FA模型下使用。
orientationbundleManager.DisplayOrientation是否Ability的显示模式。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
launchTypebundleManager.LaunchType是否Ability的启动模式。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
permissionsArray<string>是否被其他应用Ability调用时需要申请的权限集合。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
readPermissionstring是否读取Ability数据所需的权限。
模型约束: 此接口仅可在FA模型下使用。
writePermissionstring是否向Ability写数据所需的权限。
模型约束: 此接口仅可在FA模型下使用。
uristring是否获取Ability的统一资源标识符(URI)。
模型约束: 此接口仅可在FA模型下使用。
deviceTypesArray<string>是否Ability支持的设备类型。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
applicationInfoApplicationInfo是否应用程序的配置信息,通过调用getBundleInfoForSelf接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY和GET_BUNDLE_INFO_WITH_APPLICATION获取。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
metadataArray<Metadata>是否Ability的元信息,通过调用getBundleInfoForSelf接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY和GET_BUNDLE_INFO_WITH_METADATA获取。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
enabledboolean是否Ability是否可用,取值为true表示Ability可用,取值为false表示Ability不可用。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
supportWindowModesArray<bundleManager.SupportWindowMode>是否Ability支持的窗口模式。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
windowSizeWindowSize是否Ability窗口尺寸。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
excludeFromDock12+boolean是否判断Ability是否可以在dock区域隐藏图标,取值为true表示可以隐藏,取值为false不可以隐藏。
原子化服务API: 从API version 12开始,该接口支持在原子化服务中使用。
skills12+Array<Skill>是否Ability的Skills信息。
原子化服务API: 从API version 12开始,该接口支持在原子化服务中使用。
appIndex12+number是否应用包的分身索引标识,仅在分身应用中生效。
orientationId14+number是否Ability的显示模式资源id。当orientationId不为0时表示当前显示模式为自定义配置,需要使用orientationId去资源管理获取对应的资源,当orientationId为0时表示未配置资源。
原子化服务API: 从API version 14开始,该接口支持在原子化服务中使用。

WindowSize

描述窗口尺寸。


原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.BundleManager.BundleFramework.Core

名称类型只读可选说明
maxWindowRationumber是否表示自由窗口状态下窗口的最大宽高比;取值范围0-1,例如:0.12。
minWindowRationumber是否表示自由窗口状态下窗口的最小宽高比;取值范围0-1,例如:0.5。
maxWindowWidthnumber是否表示自由窗口状态下窗口的最大宽度,宽度单位为vp。
minWindowWidthnumber是否表示自由窗口状态下窗口的最小宽度,宽度单位为vp。
maxWindowHeightnumber是否表示自由窗口状态下窗口的最大高度,宽度单位为vp。
minWindowHeightnumber是否表示自由窗口状态下窗口的最小高度,宽度单位为vp。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Ability Kit(程序框架服务)

harmony 鸿蒙AbilityBase

harmony 鸿蒙AbilityBase_Element

harmony 鸿蒙AbilityRuntime

harmony 鸿蒙bundle

harmony 鸿蒙OH_NativeBundle_ApplicationInfo

harmony 鸿蒙OH_NativeBundle_ElementName

harmony 鸿蒙ability_base_common.h

harmony 鸿蒙ability_runtime_common.h

harmony 鸿蒙application_context.h

  • 所属分类: 后端技术
  • 本文标签: 鸿蒙 软件
  • 版权声明: 本文链接 https://seaxiang.com/blog/Obvrde