diff --git a/README_zh.md b/README_zh.md index 936dd6219..4c4b81ff5 100644 --- a/README_zh.md +++ b/README_zh.md @@ -16,7 +16,6 @@ | 包管理接口模块 | 1.对外提供的安装更新卸载及通知接口；
2.对外提供的包/组件信息/权限信息查询接口；
3.对外提供的应用权限查询接口；
4.对外提供的清除数据的接口； | | 扫描模块 | 1.预置应用的扫描；
2.已安装三方应用的扫描；
3.包配置文件的解析； | | 安全管理模块 | 1.安装过程中的签名校验；
2.安装过程中应用所申请权限的授予；
3.应用运行中权限的校验； | -| DBMS模块 | 1.获取指定设备ability信息； | | 安装管理模块 | 1.安装、更新、卸载逻辑处理及结果通知； | | 包信息管理模块 | 1.包信息、组件信息的存储及同步； | | 设备状态监听模块 | 1.监听设备的上下线； | @@ -28,8 +27,6 @@ ``` foundation/bundlemanager/bundle_framework -├── bundle_tool # bm工具存放目录 -├── distributed_bundle_framework # 分布式包管理服务框架代码 ├── common │   └── log # 日志组件目录 ├── interfaces @@ -41,219 +38,14 @@ foundation/bundlemanager/bundle_framework └── test # 测试目录 ``` -### bm工具命令 -bm是用来方便开发者调试的一个工具。bm工具被hdc工具封装，进入hdc shell命令后，就可以使用bm工具。 -| 命令    | 描述       | -| ------- | ---------- | -| help | 帮助命令，显示bm支持的命令信息 | -| install | 安装命令，用来安装应用| -| uninstall | 卸载命令，用来卸载应用| -| dump | 查询命令，用来查询应用的相关信息| -| clean | 清理命令，用来清理应用的缓存和数据 | -| enable | 使能命令，用来使能应用 | -| disable | 禁用命令，用来禁用应用 | -| get | 获取udid命令，用来获取设备的udid | -| quickfix | 快速修复相关命令，用来执行补丁相关操作，如补丁安装、补丁查询 | -#### 帮助命令 -| 命令    | 描述       | -| ------- | ---------- | -| bm help | 显示bm工具的能够支持的命令信息 | - -* 示例 -```Bash -# 显示帮助信息 -bm help -``` -#### 安装命令 -命令可以组合，下面列出部分命令。 -| 命令                                | 描述                       | -| ----------------------------------- | -------------------------- | -| bm install -h | 显示install支持的命令信息 | -| bm install -p    | 安装应用，支持指定路径和多个hap、hsp同时安装 | -| bm install -p -u    |给指定用户安装一个应用 | -| bm install -r -p | 覆盖安装一个应用 | -| bm install -r -p -u | 给指定用户覆盖安装一个应用 | -| bm install -r -p -u -w | 安装时指定bm工具等待时间，最小的等待时长为180s，最大的等待时长为600s, 默认缺省为5s | -| bm install -s | 安装应用间共享库 | -| bm install -p -s | 同时安装使用方应用和其依赖的应用间共享库 | - -* 示例 -```Bash -# 安装一个hap -bm install -p /data/app/ohosapp.hap -# 覆盖安装一个hap -bm install -p /data/app/ohosapp.hap -r -# 安装一个应用间共享库 -bm install -s xxx.hsp -# 同时安装多个应用间共享库 -bm install -s xxx.hsp yyy.hsp -# 同时安装使用方应用和其依赖的应用间共享库 -bm install -p aaa.hap -s xxx.hsp yyy.hsp -``` -#### 卸载命令 -命令可以组合，下面列出部分命令。-u未指定情况下，默认为所有用户。 -| 命令                          | 描述                     | -| ----------------------------- | ------------------------ | -| bm uninstall -h | 显示uninstall支持的命令信息 | -| bm uninstall -n | 通过指定包名卸载应用 | -| bm uninstall -n -u | 通过指定包名和用户卸载应用 | -| bm uninstall -n -m | 通过指定包名卸载应用的一个模块 | -| bm uninstall -s -n | 卸载指定的shared bundle | -| bm uninstall -s -n -v | 卸载指定的shared bundle的指定版本 | - -* 示例 -```Bash -# 卸载一个应用 -bm uninstall -n com.ohos.app -# 卸载应用的一个模块 -bm uninstall -n com.ohos.app -m com.ohos.app.MainAbility -# 卸载一个shared bundle -bm uninstall -s -n com.ohos.example -# 卸载一个shared bundle的指定版本 -bm uninstall -s -n com.ohos.example -v 100001 -``` -#### 查询命令 -命令可以组合，下面列出部分命令。-u未指定情况下，默认为所有用户。 -| 命令       | 描述                       | -| ---------- | -------------------------- | -| bm dump -h | 显示dump支持的命令信息 | -| bm dump -a | 查询系统已经安装的所有应用 | -| bm dump -n | 查询指定包名的详细信息 | -| bm dump -n -s | 查询指定包名下的快捷方式信息 | -| bm dump -n -d | 跨设备查询包信息 | -| bm dump -n -u | 查询指定用户下指定包名的详细信息 | -| bm dump-shared -h | 显示dump-shared支持的命令信息 | -| bm dump-shared -a | 查询系统中已安装所有共享库 | -| bm dump-shared -n | 查询指定共享库包名的详细信息 | -| bm dump-dependencies -h | 显示bm dump-dependencies支持的命令信息 | -| bm dump-dependencies -n -m | 查询指定应用指定模块依赖的共享库信息 | - -* 示例 -```Bash -# 显示所有已安装的包名 -bm dump -a -# 显示该应用的详细信息 -bm dump -n com.ohos.app -# 显示所有已安装共享库包名 -bm dump-shared -a -# 显示该共享库的详细信息 -bm dump-shared -n com.ohos.lib -# 显示指定应用指定模块依赖的共享库信息 -bm dump-dependencies -n com.ohos.app -m entry -``` -#### 清理命令 --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 -``` - -#### 快速修复命令 -| 命令       | 描述                       | -| ---------- | -------------------------- | -| bm quickfix -h | 显示quickfix支持的命令信息 | -| bm quickfix -a -f | 执行补丁安装命令 | -| bm quickfix -q -b | 根据包名查询补丁包信息 | - -* 示例 -```Bash -# 根据包名查询补丁包信息 -bm quickfix -q -b -``` - -#### 获取overlay应用的Overlay信息命令 -| 命令       | 描述                       | -| ---------- | -------------------------- | -| bm dump-overlay -h | 显示dump-overlay支持的命令信息 | -| bm dump-overlay -b | 获取指定应用的所有OverlayModuleInfo信息 | -| bm dump-overlay -b -m | 根据指定的包名和module名查询OverlayModuleInfo信息 | -| bm dump-overlay -b -t | 根据指定的包名和目标module名查询OverlayModuleInfo信息 | - -* 示例 -```Bash -* 示例 -# 根据包名来获取overlay应用com.ohos.app中的所有OverlayModuleInfo信息 -bm dump-overlay -b com.ohos.app - -# 根据包名和module来获取overlay应用com.ohos.app中overlay module为entry的所有OverlayModuleInfo信息 -bm dump-overlay -b com.ohos.app -m entry - -# 根据包名和module来获取overlay应用com.ohos.app中目标module为feature的所有OverlayModuleInfo信息 -bm dump-overlay -b com.ohos.app -m feature -``` - -#### 获取目标应用的Overlay信息命令 -| 命令       | 描述                       | -| ---------- | -------------------------- | -| bm dump-target-overlay -h | 显示dump-target-overlay支持的命令信息 | -| bm dump-target-overlay -b | 获取指定目标应用的所有OverlayBundleInfo信息 | -| bm dump-target-overlay -b -m | 根据指定的目标应用的包名和module名查询OverlayModuleInfo信息 | - -* 示例 -```Bash -* 示例 -# 根据包名来获取目标应用com.ohos.app中的所有关联的OverlayBundleInfo信息 -bm dump-target-overlay-b com.ohos.app - -# 根据包名和module来获取目标应用com.ohos.app中目标module为entry的所有关联的OverlayModuleInfo信息 -bm dump-target-overlay -b com.ohos.app -m entry - -``` - ## 相关仓 [包管理子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/%E5%8C%85%E7%AE%A1%E7%90%86%E5%AD%90%E7%B3%BB%E7%BB%9F.md) [bundlemanager_bundle_framework](https://gitee.com/openharmony/bundlemanager_bundle_framework) +[bundlemanager_bundle_tool](https://gitee.com/openharmony/bundlemanager_bundle_tool) + +[bundlemanager_distributed_bundle_framework](https://gitee.com/openharmony/bundlemanager_distributed_bundle_framework) + [developtools_packing_tool](https://gitee.com/openharmony/developtools_packing_tool)