!2185 1626 处理完成：包管理子系统相关文档

Merge pull request !2185 from ester.zhou/TR-1626

en/OpenHarmony-Overview.md

@@ -256,9 +256,9 @@ The following table describes the subsystems of OpenHarmony. For details about t
 <td class="cellrowborder" valign="top" width="8.080808080808081%" headers="mcps1.1.4.1.3 "><p id="p1962012112314"><a name="p1962012112314"></a><a name="p1962012112314"></a>Standard system</p>
 </td>
 </tr>
-<tr id="row176674368222"><td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.1.4.1.1 "><p id="p3667203652214"><a name="p3667203652214"></a><a name="p3667203652214"></a>Application framework</p>
+<tr id="row176674368222"><td class="cellrowborder" valign="top" width="11.111111111111112%" headers="mcps1.1.4.1.1 "><p id="p3667203652214"><a name="p3667203652214"></a><a name="p3667203652214"></a>Bundle management</p>
 </td>
-<td class="cellrowborder" valign="top" width="80.80808080808082%" headers="mcps1.1.4.1.2 "><p id="p12923326230"><a name="p12923326230"></a><a name="p12923326230"></a>Provides bundle installation, uninstallation, running, and management capabilities.</p>
+<td class="cellrowborder" valign="top" width="80.80808080808082%" headers="mcps1.1.4.1.2 "><p id="p12923326230"><a name="p12923326230"></a><a name="p12923326230"></a>Provides bundle installation, uninstallation, update, and query capabilities.</p>
 </td>
 <td class="cellrowborder" valign="top" width="8.080808080808081%" headers="mcps1.1.4.1.3 "><p id="p12667123619226"><a name="p12667123619226"></a><a name="p12667123619226"></a>All systems</p>
 </td>

en/readme/bundle-management.md

+# **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.
+
+![](figures/appexecfwk.png)
+
+
+## Responsibilities of Modules
+
+| Module Name      | Description                                                        |
+| ---------------- | ------------------------------------------------------------ |
+| Bundle management interface module  | 1. Provides external interfaces for installation, update, uninstallation, and notification.<br>2. Provides external interfaces for querying bundle, component, and permission information.<br>3. Provides external interfaces for querying application permissions.<br>4. Provides external interfaces for clearing data.|
+| Scanning module        | 1. Scans pre-installed applications.<br>2. Scans installed third-party applications.<br>3. Parses bundle configuration files.|
+| Security management module    | 1. Verifies signatures during installation.<br>2. Grants the permissions requested by the application during installation.<br>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:<br>(1) Creating and deleting directories<br>(2) Creating and deleting files<br>(3) Sandbox UID/GID operations in the device directory|
+| DFX              | Provides bundle maintenance and testing.                                              |
+
+
+## Directory Structure
+
+```
+foundation/appexecfwk/standard
+├── kits
+│   └── appkit						   # Core code for Appkit implementation
+├── common
+│   └── 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
+├── 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|
+| ------- | ---------- |
+|  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
+```Bash
+# 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 <hap-file-path>    | Installs HAPs. You can specify a path to install one or more HAPs at the same time.|
+| bm install -p <hap-file-path> -u <user-id>   |Installs a HAP for a specified user.|
+| bm install -r -p <hap-file-path> | Installs a HAP in overwrite mode.|
+| bm install -r -p <hap-file-path> -u <user-id> | Installs a HAP for a specified user in overwrite mode.|
+
+* Example
+```Bash
+# 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 <bundle-name> | Uninstalls an application based on the specified bundle name.|
+| bm uninstall -n <bundle-name> -u <user-id>| Uninstalls an application based on the specified bundle name and user.|
+| bm uninstall -n <bundle-name> -m <moudle-name> | 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 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 -i | Queries details about all applications installed in the system.|
+| bm dump -n <bundle-name> | Queries details about a specified bundle.|
+| bm dump -n <bundle-name> -s | Queries the shortcut information of a specified bundle.|
+| bm dump -n <bundle-name> -d <device-id> | Queries information about a bundle on a remote device.|
+| bm dump -n <bundle-name> -u <user-id> | Queries details about a specified bundle of a specified user.|
+
+* Example
+```Bash
+# 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 <bundle-name> -c | Clears the cache data of the specified bundle.|
+| bm clean -n <bundle-name> -d | Clears the data directory of the specified bundle.|
+| bm clean -n <bundle-name> -c -u <user-id> | Clears the cached data of the specified bundle for the specified user.|
+| bm clean -n <bundle-name> -d -u <user-id> | Clears the data directory of the specified bundle for the specified user.|
+
+* Example
+```Bash
+# 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 <bundle-name> | Enables the application that matches the specified bundle name.|
+| bm enable -n <bundle-name> -a <ability-name> | Enables a specific ability module of the application that matches the specified bundle name.|
+| bm enable -n <bundle-name> -u <user-id>| Enables the application that matches the specified bundle name for the specified user.|
+
+* Example
+```Bash
+# 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 <bundle-name> | Disables the application that matches the specified bundle name.|
+| bm disable -n <bundle-name> -a <ability-name> | Disables a specific ability module of the application that matches the specified bundle name.|
+| bm disable -n <bundle-name> -u <user-id>| Disables the application that matches the specified bundle name for the specified user.|
+
+* Example
+```Bash
+# 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
+```Bash
+# Obtain the UDID of a device.
+bm get -u
+```
+
+## Repositories Involved
+
+Bundle Management Subsystem
+
+**appexecfwk_standard**
+
+developtools_packing_tool