Bundle Management

Introduction

The Bundle Management subsystem allows you to query, install, update, and uninstall capabilities for application bundles as well as store bundle information.

Below is the architecture of the Bundle Management subsystem.

Responsibilities of Modules

Module Description
Bundle management interface module 1. Provides external interfaces for installation, update, uninstallation, and notification.
2. Provides external interfaces for querying bundle, component, and permission information.
3. Provides external interfaces for querying application permissions.
4. Provides external interfaces for clearing data.
Scanning module 1. Scans pre-installed applications.
2. Scans installed third-party applications.
3. Parses bundle configuration files.
Security management module 1. Verifies signatures during installation.
2. Grants the permissions requested by the application during installation.
3. Verifies permissions during application running.
DBMS module Obtains the ability information about a specified device.
Installation management module Provides installation, update, and uninstallation logic processing and result notification.
Bundle information management module Stores and synchronizes bundle and component information.
Device status listening module Listens for the online and offline status changes of devices.
Installed module Provides privileged processes for:
(1) Creating and deleting directories
(2) Creating and deleting files
(3) Sandbox UID/GID operations in the device directory
DFX Provides bundle maintenance and testing.

Directory Structure

foundation/bundlemanager/bundle_framework
├── bundle_tool                        # bm code
├── distributed_bundle_framework       # Framework code of the distributed bundle management service					   
├── common
│   └── log							   # Log component
├── interfaces
│   ├── inner_api                      # Internal APIs
│   └── kits                           # Application APIs
│       ├── js                         # JS APIs
│       └── native                     # C/C++ APIs  					   
├── services                           # Framework code of the bundle management service
└── test						       # Testing

bm Commands

bm is a tool used to facilitate debugging. It is encapsulated in the HDC tool. You can use it by running bm commands in the HDC shell.

Command Description
help Displays the commands supported by the bm tool.
install Installs an application.
uninstall Uninstalls an application.
dump Queries application information.
clean Clears the cache and data of an application.
enable Enables an application.
disable Disables an application.
get Obtains the UDID of a device.

Help Command

Command Description
bm help Displays the commands supported by the bm tool.
  • Example
# Display help information.
bm help

Installation Command

This command can be run with different options to achieve different purposes. The table below lists some examples.

Command Description
bm install -h Displays the commands supported by install.
bm install -p Installs HAPs. You can specify a path to install one or more HAPs at the same time.
bm install -p -u Installs a HAP for a specified user.
bm install -r -p Installs a HAP in overwrite mode.
bm install -r -p -u Installs a HAP for a specified user in overwrite mode.
  • Example
# Install a HAP.
bm install -p /data/app/ohosapp.hap
# Install a HAP in overwrite mode.
bm install -p /data/app/ohosapp.hap -r

Uninstallation Command

This command can be run with different options to achieve different purposes. The table below lists some examples. If -u is not specified, the command applies to all users.

Command Description
bm uninstall -h Displays the commands supported by uninstall.
bm uninstall -n Uninstalls an application based on the specified bundle name.
bm uninstall -n -k Uninstalls an application based on the specified bundle name, while retaining the data directory of the application.
bm uninstall -n -u Uninstalls an application based on the specified bundle name and user.
bm uninstall -n -m Uninstalls a specific module of an application based on the specified bundle name.
  • Example
# Uninstall a HAP.
bm uninstall -n com.ohos.app
# Uninstall a HAP while retaining its data directory.
bm uninstall -n com.ohos.app -k
# Uninstall an ability of the HAP.
bm uninstall -n com.ohos.app -m com.ohos.app.MainAbility

Query Command

This command can be run with different options to achieve different purposes. The table below lists some examples. If -u is not specified, the command applies to all users.

Command Description
bm dump -h Displays the commands supported by dump.
bm dump -a Queries all applications installed in the system.
bm dump -n Queries details about a specified bundle.
bm dump -n -s Queries the shortcut information of a specified bundle.
bm dump -n -d Queries information about a bundle on a remote device.
bm dump -n -u Queries details about a specified bundle of a specified user.
  • Example
# Display the names of all applications installed in the system.
bm dump -a
# Display details about a specific application.
bm dump -n com.ohos.app

Clean Command

-If -u is not specified, the command applies to all active users.

Command Description
bm clean -h Displays the commands supported by clean.
bm clean -n -c Clears the cache data of the specified bundle.
bm clean -n -d Clears the data directory of the specified bundle.
bm clean -n -c -u Clears the cached data of the specified bundle for the specified user.
bm clean -n -d -u Clears the data directory of the specified bundle for the specified user.
  • Example
# Clear the cache data of the specified bundle.
bm clean -n com.ohos.app -c
# Clear the user data of the specified bundle.
bm clean -n com.ohos.app -d

Enable Command

-If -u is not specified, the command applies to all active users.

Command Description
bm enable -h Displays the commands supported by enable.
bm enable -n Enables the application that matches the specified bundle name.
bm enable -n -a Enables a specific ability module of the application that matches the specified bundle name.
bm enable -n -u Enables the application that matches the specified bundle name for the specified user.
  • Example
# Enable the specified application.
bm enable -n com.ohos.app

Disable Command

-If -u is not specified, the command applies to all active users.

Command Description
bm disable -h Displays the commands supported by disable.
bm disable -n Disables the application that matches the specified bundle name.
bm disable -n -a Disables a specific ability module of the application that matches the specified bundle name.
bm disable -n -u Disables the application that matches the specified bundle name for the specified user.
  • Example
# Disable the specified application.
bm disable -n com.ohos.app

Command for Obtaining the UDID

Command Description
bm get -h Displays the commands supported by get.
bm get -u Obtains the UDID of a device.
  • Example
# Obtain the UDID of a device.
bm get -u

Repositories Involved

Bundle Management Subsystem

bundlemanager_bundle_framework

bundlemanager_bundle_framework_lite developtools_packing_tool