appexecfwk_standard/README_zh.md

包管理子系统

简介

包管理子系统负责应用安装包的管理，提供安装包的信息查询、安装、更新、卸载和包信息存储等能力。具体功能如下：

包管理子系统架构如下图所示：

部件内子模块职责

子模块名称	职责
包管理接口模块	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/bundlemanager/bundle_framework
├── 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工具的能够支持的命令信息

• 示例

# 显示帮助信息
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包

• 示例

# 安装一个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 -u	通过指定包名和用户卸载应用
bm uninstall -n -m	通过指定包名卸载应用的一个模块

• 示例

# 卸载一个hap
bm uninstall -n com.ohos.app
# 卸载一个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	查询指定用户下指定包名的详细信息

• 示例

# 显示所有已安装的包名
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	清除指定用户下包名的数据目录

• 示例

# 清理该应用下的缓存数据
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	使能指定用户和包名的应用

• 示例

# 使能该应用
bm enable -n com.ohos.app

禁用命令

-u未指定情况下，默认为当前活跃用户。

命令	描述
bm disable -h	显示disable支持的命令信息
bm disable -n	禁用指定包名的应用
bm disable -n -a	禁用指定包名下的元能力模块
bm disable -n -u	禁用指定用户和包名下的应用

• 示例

# 禁用该应用
bm disable -n com.ohos.app

获取udid命令

命令	描述
bm get -h	显示get支持的命令信息
bm get -u	获取设备的udid

• 示例

# 获取设备的udid
bm get -u

相关仓

包管理子系统

appexecfwk_standard

developtools_packing_tool