# **包管理子系统**
## 简介
包管理子系统负责应用安装包的管理，提供安装包的信息查询、安装、更新、卸载和包信息存储等能力。具体功能如下：
包管理子系统架构如下图所示：
## 部件内子模块职责
| 子模块名称 | 职责 |
| ---------------- | ------------------------------------------------------------ |
| 包管理接口模块 | 1.对外提供的安装更新卸载及通知接口；
2.对外提供的包/组件信息/权限信息查询接口；
3.对外提供的应用权限查询接口；
4.对外提供的清除数据的接口； |
| 扫描模块 | 1.预置应用的扫描；
2.已安装三方应用的扫描；
3.包配置文件的解析； |
| 安全管理模块 | 1.安装过程中的签名校验；
2.安装过程中应用所申请权限的授予；
3.应用运行中权限的校验； |
| DBMS模块 | 1.获取指定设备ability信息； |
| 安装管理模块 | 1.安装、更新、卸载逻辑处理及结果通知； |
| 包信息管理模块 | 1.包信息、组件信息的存储及同步； |
| 设备状态监听模块 | 1.监听设备的上下线； |
| Installd模块 | 特权进程：
1）用于创建、删除等目录操作；
2）用于创建、删除等文件操作；
3）用于设备目录的沙箱uid/gid等操作 |
| DFX | 1.包管理维测工具 |
## 目录
```
foundation/appexecfwk/standard
├── kits
│ └── appkit # Appkit实现的核心代码
├── common
│ └── log # 日志组件目录
├── interfaces
│ └── innerkits # 内部接口存放目录
├── services
│ └── bundlemgr # 包管理服务框架代码
│ └── dbms # 分布式包管理服务框架代码
├── test # 测试目录
└── tools # bm命令存放目录
```
### bm工具命令
bm是用来方便开发者调试的一个工具。bm工具被hdc工具封装，进入hdc shell命令后，就可以使用bm工具。
| 命令 | 描述 |
| ------- | ---------- |
| help | 帮助命令，显示bm支持的命令信息 |
| install | 安装命令，用来安装应用|
| uninstall | 卸载命令，用来卸载应用|
| dump | 查询命令，用来查询应用的相关信息|
| clean | 清理命令，用来清理应用的缓存和数据 |
| enable | 使能命令，用来使能应用 |
| disable | 禁用命令，用来禁用应用 |
| get | 获取udid命令，用来获取设备的udid |
#### 帮助命令
| 命令 | 描述 |
| ------- | ---------- |
| bm help | 显示bm工具的能够支持的命令信息 |
* 示例
```Bash
# 显示帮助信息
bm help
```
#### 安装命令
命令可以组合，下面列出部分命令。
| 命令 | 描述 |
| ----------------------------------- | -------------------------- |
| bm install -h | 显示install支持的命令信息 |
| bm install -p | 安装hap包，支持指定路径和多个hap同时安装 |
| bm install -p -u |给指定用户安装一个hap包 |
| bm install -r -p | 覆盖安装一个hap包 |
| bm install -r -p -u | 给指定用户覆盖安装一个hap包 |
* 示例
```Bash
# 安装一个hap
bm install -p /data/app/ohosapp.hap
# 覆盖安装一个hap
bm install -p /data/app/ohosapp.hap -r
```
#### 卸载命令
命令可以组合，下面列出部分命令。-u未指定情况下，默认为所有用户。
| 命令 | 描述 |
| ----------------------------- | ------------------------ |
| bm uninstall -h | 显示uninstall支持的命令信息 |
| bm uninstall -n | 通过指定包名卸载应用 |
| bm uninstall -n -k | 通过指定包名卸载应用时保留数据目录 |
| bm uninstall -n -u | 通过指定包名和用户卸载应用 |
| bm uninstall -n -m | 通过指定包名卸载应用的一个模块 |
* 示例
```Bash
# 卸载一个hap
bm uninstall -n com.ohos.app
# 卸载一个hap，保留数据目录
bm uninstall -n com.ohos.app -k
# 卸载一个hap下面的ability
bm uninstall -n com.ohos.app -m com.ohos.app.MainAbility
```
#### 查询命令
命令可以组合，下面列出部分命令。-u未指定情况下，默认为所有用户。
| 命令 | 描述 |
| ---------- | -------------------------- |
| bm dump -h | 显示dump支持的命令信息 |
| bm dump -a | 查询系统已经安装的所有应用 |
| bm dump -i | 查询系统已经安装的所有应用的详细信息 |
| bm dump -n | 查询指定包名的详细信息 |
| bm dump -n -s | 查询指定包名下的快捷方式信息 |
| bm dump -n -d | 跨设备查询包信息 |
| bm dump -n -u | 查询指定用户下指定包名的详细信息 |
* 示例
```Bash
# 显示所有已安装的包名
bm dump -a
# 显示该应用的详细信息
bm dump -n com.ohos.app
```
#### 清理命令
-u未指定情况下，默认为当前活跃用户。
| 命令 | 描述 |
| ---------- | -------------------------- |
| bm clean -h | 显示clean支持的命令信息 |
| bm clean -n -c | 清除指定包名的缓存数据 |
| bm clean -n -d | 清除指定包名的数据目录 |
| bm clean -n -c -u | 清除指定用户下包名的缓存数据 |
| bm clean -n -d -u | 清除指定用户下包名的数据目录 |
* 示例
```Bash
# 清理该应用下的缓存数据
bm clean -n com.ohos.app -c
# 清理该应用下的用户数据
bm clean -n com.ohos.app -d
```
#### 使能命令
-u未指定情况下，默认为当前活跃用户。
| 命令 | 描述 |
| ---------- | -------------------------- |
| bm enable -h | 显示enable支持的命令信息 |
| bm enable -n | 使能指定包名的应用 |
| bm enable -n -a | 使能指定包名下的元能力模块 |
| bm enable -n -u | 使能指定用户和包名的应用 |
* 示例
```Bash
# 使能该应用
bm enable -n com.ohos.app
```
#### 禁用命令
-u未指定情况下，默认为当前活跃用户。
| 命令 | 描述 |
| ---------- | -------------------------- |
| bm disable -h | 显示disable支持的命令信息 |
| bm disable -n | 禁用指定包名的应用 |
| bm disable -n -a | 禁用指定包名下的元能力模块 |
| bm disable -n -u | 禁用指定用户和包名下的应用 |
* 示例
```Bash
# 禁用该应用
bm disable -n com.ohos.app
```
#### 获取udid命令
| 命令 | 描述 |
| ---------- | -------------------------- |
| bm get -h | 显示get支持的命令信息 |
| bm get -u | 获取设备的udid |
* 示例
```Bash
# 获取设备的udid
bm get -u
```
## 相关仓
包管理子系统
**appexecfwk_standard**
developtools_packing_tool