diff --git a/en/readme/bundle-management.md b/en/readme/bundle-management.md index d18e3f23245abbe4bc5483898e3a8961b9544e0d..6276b4896f7e3fc342774df6d78233464908b0af 100644 --- a/en/readme/bundle-management.md +++ b/en/readme/bundle-management.md @@ -11,7 +11,7 @@ Below is the architecture of the Bundle Management subsystem. ## Responsibilities of Modules -| Module Name | Description | +| 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.| @@ -27,24 +27,24 @@ Below is the architecture of the Bundle Management subsystem. ## Directory Structure ``` -foundation/appexecfwk/standard -├── kits -│   └── appkit # Core code for Appkit implementation +foundation/bundlemanager/bundle_framework +├── bundle_tool # bm code +├── distributed_bundle_framework # Framework code of the distributed bundle management service ├── common -│   └── log # Log component +│ └── log # Log component ├── interfaces -│   └── innerkits # Internal interfaces -├── services -│   └── bundlemgr # Framework code of the bundle management service -│   └── dbms # Framework code of the distributed bundle management service +│ ├── inner_api # Internal APIs +│ └── kits # Application APIs +│ ├── js # JS APIs +│ └── native # C/C++ APIs +├── services # Framework code of the bundle management service ├── test # Testing -└── tools # bm commands ``` ### 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| +| Command | Description | | ------- | ---------- | | help | Displays the commands supported by the bm tool.| | install | Installs an application.| @@ -55,7 +55,7 @@ bm is a tool used to facilitate debugging. It is encapsulated in the HDC tool. Y | disable | Disables an application.| | get | Obtains the UDID of a device.| #### Help Command -| Command| Description| +| Command | Description | | ------- | ---------- | | bm help | Displays the commands supported by the bm tool.| @@ -66,11 +66,11 @@ bm help ``` #### Installation Command This command can be run with different options to achieve different purposes. The table below lists some examples. -| Command| Description| +| 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 -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.| @@ -83,23 +83,26 @@ 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| +| 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.| +| bm uninstall -n -m | Uninstalls a specific module of an application based on the specified bundle name.| * Example ```Bash # 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| +| Command | Description | | ---------- | -------------------------- | | bm dump -h | Displays the commands supported by **dump**.| | bm dump -a | Queries all applications installed in the system.| @@ -117,8 +120,8 @@ bm dump -a bm dump -n com.ohos.app ``` #### Clean Command -If **-u** is not specified, the command applies to all active users. -| Command| Description| +-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.| @@ -134,8 +137,8 @@ bm clean -n com.ohos.app -c bm clean -n com.ohos.app -d ``` #### Enable Command -If **-u** is not specified, the command applies to all active users. -| Command| Description| +-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.| @@ -148,8 +151,8 @@ If **-u** is not specified, the command applies to all active users. bm enable -n com.ohos.app ``` #### Disable Command -If **-u** is not specified, the command applies to all active users. -| Command| Description| +-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.| @@ -162,7 +165,7 @@ If **-u** is not specified, the command applies to all active users. bm disable -n com.ohos.app ``` #### Command for Obtaining the UDID -| Command| Description| +| Command | Description | | ---------- | -------------------------- | | bm get -h | Displays the commands supported by **get**.| | bm get -u | Obtains the UDID of a device.|