Bundle Manager

The Bundle Manager enables you to install, uninstall, update, and query a bundle (application). It provides the bundle debugging capabilities, for example, installing and uninstalling a bundle and querying bundle information.

NOTE

Before using this tool, you must obtain the hdc tool and run the hdc shell command.

Table 1 bm commands

Help Command

Table 2 Help command

Example

# Display the help information.
bm help

Installation Command

bm install [-h] [-p path] [-u userId] [-r] [-w waitting-time]

Table 3 Installation command parameters

Example

bm install -p /data/app/ohosapp.hap -u 100 -w 5s -r
// The execution result is as follows:
install bundle successfully.

Uninstall Command

bm uninstall [-h help] [-n bundleName] [-m moduleName] [-u userId] [-k]

Table 4 Uninstall command parameters

Example

bm uninstall -n com.ohos.app -m com.ohos.app.MainAbility -u 100 -k
// The execution result is as follows:
uninstall bundle successfully.

Dump Command

bm dump [-h help] [-a] [-n bundleName] [-s shortcutInfo] [-u userId] [-d deviceId]

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

Table 5 Dump command parameters

Example

# Display the names of all bundles installed in the system.
bm dump -a
# Display the details of a bundle.
bm dump -n com.ohos.app -u 100
# Display the shortcut information of a bundle.
bm dump -s com.ohos.app -u 100
# Display cross-device bundle information.
bm dump -n com.ohos.app -d xxxxx

Clean Command

bm clean [-h] [-c] [-n  bundleName] [-d] [-u userId]

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

Table 6 Clean command parameters

Example

# Clear the cache data of a bundle.
bm clean -c -n com.ohos.app -u 100
// The execution result is as follows:
clean bundle cache files successfully.
# Clear the user data of a bundle.
bm clean -d -n com.ohos.app -u 100
// The execution result is as follows:
clean bundle data files successfully.

Enable Command

bm enable [-h] [-n bundleName] [-a abilityName] [-u userId]

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

Table 7 Enable command parameters

Example

# Enable a bundle.
bm enable -n com.ohos.app -a com.ohos.app.MainAbility -u 100
// The execution result is as follows:
enable bundle successfully.

Disable Command

bm disable [-h] [-n bundleName] [-a abilityName] [-u userId]

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

Table 8 Disabled command parameters

Example

# Disable a bundle.
bm disable -n com.ohos.app -a com.ohos.app.MainAbility -u 100
// The execution result is as follows:
disable bundle successfully.

Obtaining UDID

bm get [-h] [-u]

Table 9 Parameters used in the command for obtaining the UDID

Example

# Obtain the UDID of a device.
bm get -u
// The execution result is as follows:
udid of current device is :
23CADE0C

Quick Fix

bm quickfix [-h] [-a -f filePath] [-q -b bundleName]

Table 10 Parameters used in the command for quick fix

Example

# Display patch package information by the bundle name.
bm quickfix -q -b com.ohos.app
// The execution result is as follows:
// Information as follows:            
// ApplicationQuickFixInfo:           
//  bundle name: com.ohos.app 
//  bundle version code: xxx     
//  bundle version name: xxx       
//  patch version code: x            
//  patch version name:              
//  cpu abi:                          
//  native library path:             
//  type:                            
# Patch installation in the quick fix:
bm quickfix -a -f /data/app/
// The execution result is as follows:
apply quickfix succeed.