1# 元能力子系统 2 3## 简介 4 5**元能力子系统**实现对Ability的运行及生命周期进行统一的调度和管理，应用进程能够支撑多个Ability，Ability具有跨应用进程间和同一进程内调用的能力。Ability管理服务统一调度和管理应用中各Ability，并对Ability的生命周期变更进行管理。 6 7 8 9**元能力子系统架构图说明：** 10 11- **Ability Kit**为Ability的运行提供基础的运行环境支撑。Ability是系统调度应用的最小单元，是能够完成一个独立功能的组件，一个应用可以包含一个或多个Ability。 12 13- **Ability管理服务（AbilityManagerService）**：用于协调各Ability运行关系、及对生命周期进行调度的系统服务。 14 - 连接管理模块（AbilityConnectManager）是Ability管理服务对Service类型Ability连接管理的模块。 15 - 数据管理模块（DataAbilityManager）是Ability管理服务对Data类型Ability管理的模块。 16 - App管理服务调度模块（AppScheduler）提供Ability管理服务对用户程序管理服务进行调度管理的能力。 17 - Ability调度模块（AbilityScheduler）提供对Ability进行调度管理的能力。 18 - 生命周期调度模块（LifecycleDeal）是Ability管理服务对Ability的生命周期事件进行管理调度的模块。 19 20- Ability框架模型结构具有两种框架形态： 21 22 - 第一种形态为FA模型。API 8及其更早版本的应用程序只能使用FA模型进行开发。 FA模型将Ability分为FA（Feature Ability）和PA（Particle Ability）两种类型，其中FA支持Page Ability，PA支持Service Ability、Data Ability、以及FormAbility。 23 - 第二种形态为Stage模型。从API 9开始，Ability框架引入了Stage模型作为第二种应用框架形态，Stage模型将Ability分为Ability和ExtensionAbility两大类，其中ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等等一系列ExtensionAbility，以便满足更多的使用场景。 24 25 Stage模型的设计，主要是为了方便开发者更加方便地开发出分布式环境下的复杂应用。下表给出了两种模型在设计上的差异： 26 27 | 对比 | FA模型 | Stage模型 | 28 | -------------- | ------------------------------------------------------------ | -------------------------------------------------------- | 29 | 开发方式 | 提供类Web的 api，UI开发与Stage模型一致。 | 提供面向对象的开发方式，UI开发与FA模型一致。 | 30 | 引擎实例 | 每个进程内的每个Ability独享一个JS VM引擎实例。 | 每个进程内的多个Ability实例共享一个JS VM引擎实例。 | 31 | 进程内对象共享 | 不支持。 | 支持。 | 32 | 包描述文件 | 使用config.json描述HAP包和组件信息，组件必须使用固定的文件名。 | 使用module.json描述HAP包和组件信息，可以指定入口文件名。 | 33 | 组件 | 提供PageAbility(页面展示)，ServiceAbility(服务)，DataAbility(数据分享), FormAbility(卡片)。 | 提供Ability(页面展示)、Extension(基于场景的服务扩展)。 | 34 35 除了上述设计上的差异外，对于开发者而言，两种模型的主要区别在于： 36 37 * Ability类型存在差异； 38 39  40 41 * Ability生命周期存在差异； 42 43  44 45 46## 目录 47 48``` 49foundation/ability #元能力子系统 50├── ability_runtime #ability_runtime元能力运行时部件 51│ ├── frameworks 52│ │ ├── js 53│ │ │ └── napi # ability_runtime的napi代码实现 54│ │ └── native # ability_runtime的核心代码实现 55│ ├── interfaces 56│ │ ├── inner_api # ability_runtime的系统内部件间接口 57│ │ └── kits 58│ │ └── native # ability_runtime的对外接口 59│ ├── services 60│ │ ├── abilitymgr # Ability管理服务框架代码 61│ │ ├── appmgr # App管理服务框架代码 62│ │ ├── common # 服务公共组件目录 63│ │ ├── dataobsmgr # DataAbilityObserver管理服务框架代码 64│ │ └── uripermmgr # UriPermission管理服务框架代码 65│ ├── test # 测试目录 66│ └── tools # aa命令工具代码目录 67│ 68├── ability_base # ability_base元能力基础部件 69│ 70├── ability_lite # ability_lite轻量化元能力部件 71│ 72├── dmsfwk # dmsfwk分布式组件管理部件 73│ 74├── dmsfwk_lite # dmsfwk_lite轻量化分布式组件管理部件 75│ 76├── form_fwk # form_fwk卡片运行时部件 77│ 78├── idl_tool # idl工具部件 79 80``` 81 82## 使用说明 83### 启动Abiltiy 84启动新的ability(callback形式) 85 86* startAbility参数描述 87 88| 名称 | 读写属性 | 类型 | 必填 | 描述 | 89| --------- | -------- | --------------------- | ---- | ------------------- | 90| parameter | 读写 | StartAbilityParameter | 是 | 表示被启动的Ability | 91| callback | 只读 | AsyncCallback | 是 | 被指定的回调方法 | 92 93- StartAbilityParameter类型说明 94 95| 名称 | 读写属性 | 类型 | 必填 | 描述 | 96| ------------------- | -------- | ------ | ---- | ---------------------------------- | 97| want | 读写 | want | 是 | 表示需要包含有关目标启动能力的信息 | 98| abilityStartSetting | 只读 | string | 否 | 指示启动能力中使用的特殊启动设置 | 99 100- want类型说明 101 102| 名称 | 读写属性 | 类型 | 必填 | 描述 | 103| ------------ | -------- | -------------------- | ---- | ------------------------------- | 104| deviceId | 读写 | string | 否 | 设备id | 105| bundleName | 读写 | string | 否 | Bundle名 | 106| abilityName | 读写 | string | 否 | Ability 名 | 107| uri | 读写 | string | 否 | 请求中URI的描述 | 108| type | 读写 | string | 否 | Want中类型的说明 | 109| flags | 读写 | number | 否 | Want中标志的选项，必填 | 110| action | 读写 | string | 否 | Want中对操作的描述 | 111| parameters | 读写 | {[key: string]: any} | 否 | Want中WantParams对象的描述 | 112| entities | 读写 | string | 否 | 对象中实体的描述 | 113| moduleName9+ | 读写 | string | 否 | Ability所属的模块（module）名称 | 114 115* 返回值 116 117 void 118 119* 示例 120 121 更多开发指导可参考[**示例文档**](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/application-models/Readme-CN.md) 122 123 124## **aa命令** 125 126**aa help** 127 128| 命令 | 描述 | 129| ------- | ------------------ | 130| aa help | 显示aa命令帮助信息 | 131 132**aa start** 133 134| 命令 | 描述 | 135| -------------------------------------------------------------- | ------------------------ | 136| aa start [-d <device>] -a <ability-name> -b <bundle-name> [-D] | 启动ability，设备ID 可空 | 137 138``` 139示例： 140aa start -d 12345 -a com.ohos.app.MainAbility -b com.ohos.app -D 141``` 142 143**aa dump** 144 145| 命令 | 描述 | 146| ---------- | --------------------- | 147| aa dump -a | 打印栈中的Ability信息 | 148 149**aa force-stop** 150 151| 命令 | 描述 | 152| -------------------------------------------------------------- | ------------------------ | 153| aa force-stop <bundle-name> | 强制停止application | 154 155``` 156示例： 157aa force-stop com.ohos.app 158``` 159 160## 相关仓 161元能力子系统 162 163[ability_base](https://gitee.com/openharmony/ability_ability_base) 164 165[ability_lite](https://gitee.com/openharmony/ability_ability_lite) 166 167[**ability_runtime**](https://gitee.com/openharmony/ability_ability_runtime) 168 169[dmsfwk](https://gitee.com/openharmony/ability_dmsfwk) 170 171[dmsfwk_lite](https://gitee.com/openharmony/ability_dmsfwk_lite) 172 173[form_fwk](https://gitee.com/openharmony/ability_form_fwk) 174 175[idl_tool](https://gitee.com/openharmony/ability_idl_tool)
