From 21d9f62817a9469b1df090cf6ed10398eeab3b89 Mon Sep 17 00:00:00 2001
From: z30034863 <zhangfengzhuang@huawei.com>
Date: Wed, 4 Jun 2025 10:22:17 +0800
Subject: [PATCH] unpack_tool add iconId/labelId doc

Signed-off-by: z30034863 <zhangfengzhuang@huawei.com>
---
 README_zh.md | 128 ++++++++++++++++++++++++++-------------------------
 1 file changed, 66 insertions(+), 62 deletions(-)

diff --git a/README_zh.md b/README_zh.md
index baad5d92..df4a106c 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -454,30 +454,32 @@ java -jar app_unpacking_tool.jar --mode <option> --hsp-path <options> --out-path
 
 ### 4.4 AppInfo结构体信息
 
-| 字段                             | 类型      | 描述                                                                          | 备注          |
-|--------------------------------|---------|-----------------------------------------------------------------------------|-------------|
-| bundleName                     | String  | 标识app的包名称                                                                   | NA          |
-| vendor                         | String  | 标识app的供应商信息                                                                 | NA          |
-| relatedBundleName              | String  | 标识app相关bundle的包名                                                            | NA          |
-| versionName                    | String  | 标识app中的versionName信息                                                        | NA          |
-| versionCode                    | String  | 标识app中的versionCode信息                                                        | NA          |
-| targetApiVersion               | int     | 标识应用运行需要的API目标版本                                                            | NA          |
-| compatibleApiVersion           | int     | 标识应用兼容的API版本                                                                | NA          |
-| appName                        | String  | 标识显示在桌面上的ability的label                                                      | NA          |
-| appNameEN                      | String  | 标识显示在桌面上的ability的label                                                      | NA          |
-| releaseType                    | String  | 标识应用运行需要的API目标版本的类型                                                         | NA          |
-| shellVersionCode               | String  | 标识HarmonyOS中的API版本                                                          | NA          |
-| shellVersionName               | String  | 标识HarmonyOS中的API版本名称                                                        | NA          |
-| multiFrameworkBundle           | String  | 标识bundleName                                                                | NA          |
-| debug                          | boolean | 标识应用是否可调试                                                                   | NA          |
-| icon                           | String  | 标识应用的图标路径                                                                   | NA          |
-| label                          | String  | 标识应用的label                                                                  | NA          |
-| description                    | String  | 标识应用的描述信息                                                                   | stage模型新增   |
-| minCompatibleVersionCode       | int     | 标识应用能够兼容的最低版本号                                                              | NA          |
-| distributedNotificationEnabled | boolean | 标记该应用是否开启分布式通知                                                              | stage模型新增   |
-| bundleType                     | String  | 标识bundle的类型，取值：<br/>- app：普通应用<br/>- atomicService：元服务 <br/>- shared：应用间共享库 | NA   |
-| compileSdkVersion              | String  | 标识编译该应用时使用的sdk版本                                                            | stage模型新增   |
-| compileSdkType                 | String  | 标识编译该应用时使用的sdk类别                                                            | stage模型新增   |
+| 字段                             | 类型                       | 描述                                                                          | 备注          |
+|--------------------------------|--------------------------|-----------------------------------------------------------------------------|-------------|
+| bundleName                     | String                   | 标识app的包名称                                                                   | NA          |
+| vendor                         | String                   | 标识app的供应商信息                                                                 | NA          |
+| relatedBundleName              | String                   | 标识app相关bundle的包名                                                            | NA          |
+| versionName                    | String                   | 标识app中的versionName信息                                                        | NA          |
+| versionCode                    | String                   | 标识app中的versionCode信息                                                        | NA          |
+| targetApiVersion               | int                      | 标识应用运行需要的API目标版本                                                            | NA          |
+| compatibleApiVersion           | int                      | 标识应用兼容的API版本                                                                | NA          |
+| appName                        | String                   | 标识显示在桌面上的ability的label                                                      | NA          |
+| appNameEN                      | String                   | 标识显示在桌面上的ability的label                                                      | NA          |
+| releaseType                    | String                   | 标识应用运行需要的API目标版本的类型                                                         | NA          |
+| shellVersionCode               | String                   | 标识HarmonyOS中的API版本                                                          | NA          |
+| shellVersionName               | String                   | 标识HarmonyOS中的API版本名称                                                        | NA          |
+| multiFrameworkBundle           | String                   | 标识bundleName                                                                | NA          |
+| debug                          | boolean                  | 标识应用是否可调试                                                                   | NA          |
+| iconId                         | int                      | 标识应用的图标资源ID                                                                 | NA          |
+| labelId                        | int                      | 标识应用的label资源ID                                                              | NA          |
+| icon                           | String                   | 标识应用的图标路径                                                                   | NA          |
+| label                          | String                   | 标识应用的label                                                                  | NA          |
+| description                    | String                   | 标识应用的描述信息                                                                   | stage模型新增   |
+| minCompatibleVersionCode       | int                      | 标识应用能够兼容的最低版本号                                                              | NA          |
+| distributedNotificationEnabled | boolean                  | 标记该应用是否开启分布式通知                                                              | stage模型新增   |
+| bundleType                     | String                   | 标识bundle的类型，取值：<br/>- app：普通应用<br/>- atomicService：元服务 <br/>- shared：应用间共享库 | NA   |
+| compileSdkVersion              | String                   | 标识编译该应用时使用的sdk版本                                                            | stage模型新增   |
+| compileSdkType                 | String                   | 标识编译该应用时使用的sdk类别                                                            | stage模型新增   |
 | labels                         | HashMap\<String, String> | 标识多语言应用程序AppJson的标签。                                                        | NA          |
 | descriptions                   | HashMap\<String, String> | 标识多语言应用程序AppJson的说明。                                                        | NA          |
 
@@ -518,44 +520,46 @@ java -jar app_unpacking_tool.jar --mode <option> --hsp-path <options> --out-path
 
 ### 4.6 AbilityInfo结构体信息
 
-| 字段                | 类型                       | 描述                                              | 备注                        |
-|-------------------|--------------------------| ------------------------------------------------- | ------------------------------- |
-| name              | String                   | 标识当前ability的逻辑名                           | NA                              |
-| description       | String                   | 标识ability的描述                                 | NA                              |
-| descriptionRes    | String                   | 标识ability资源的描述                             | NA                              |
-| icon              | String                   | 标识ability图标                                   | NA                              |
-| iconPath          | String                   | 标识ability图标路径                               | NA                              |
-| label             | String                   | 标识ability对用户显示的名称                       | NA                              |
-| labelRes          | String                   | 标识ability对用户显示的名称资源                   | NA                              |
-| type              | String                   | 标识ability类型                                   | Stage模型下该值直接赋予page类型 |
-| formsEnabled      | boolean                  | 标识ability卡片是否使能                           | NA                              |
-| formInfo          | FormInfo结构体           | 描述卡片的信息                                    | NA                              |
-| uri               | String                   | 标识ability的uri信息                              | FA模型支持                      |
-| launchType        | String                   | 标识ability中的launcherType信息                   | NA                              |
-| orientation       | String                   | 标识ability中的orientation信息                    | NA                              |
-| visible           | boolean                  | 标识ability中的visible信息                        | NA                              |
-| grantPermission   | boolean                  | 标识ability中的grantPermission信息                | NA                              |
-| readPermission    | String                   | 标识ability中的readPermission信息                 | NA                              |
-| writePermission   | String                   | 标识ability中的writePermission信息                | NA                              |
-| uriPermissionMode | String                   | 标识ability中的uriPermissionMode信息              | NA                              |
-| uriPermissionPath | String                   | 标识ability中的uriPermissionPath信息              | NA                              |
-| directLaunch      | boolean                  | 标识ability中的directLaunch信息                   | NA                              |
-| mission           | String                   | 标识ability中的mission信息                        | NA                              |
-| targetAbility     | String                   | 标识ability中的targetAbility信息                  | NA                              |
-| multiUserShared   | boolean                  | 标识ability中的multiUserShared信息                | NA                              |
-| supportPipMode    | boolean                  | 标识ability中的supportPipMode信息                 | NA                              |
-| srcLanguage       | String                   | 标识ability中的srcLanguage信息                    | NA                              |
-| srcPath           | String                   | 标识ability中的srcPath信息                        | NA                              |
-| srcEntrance       | String                   | 标识ability中的srcEntrance信息                    | NA                              |
-| continuable       | boolean                  | 标识ability中的continuable信息                    | NA                              |
-| metaData          | MetaData结构体（见下述MetaData） | 标识ability的自定义元信息                  | NA                             |
-| configChanges     | List\<String>            | 标识ability中的configChanges信息                  | NA                              |
-| formInfos         | List\<AbilityFormInfo>   | 标识ability中的forms信息                          | NA                              |
-| permissions       | List\<String>            | 标识ability中的permissions信息                    | NA                              |
-| skills            | List\<SkillInfo>         | 标识ability中的skills信息                         | NA                              |
-| backgroundModes   | List\<String>            | 标识ability中的backgroundModes信息                | NA                              |
-| labels            | HashMap\<String, String> | 标识多语言下ability对用户显示的名称                | NA                             |
-| descriptions      | HashMap\<String, String> | 标识多语言下ability的描述                         | NA                              |
+| 字段                | 类型                       | 描述                             | 备注                        |
+|-------------------|--------------------------|--------------------------------| ------------------------------- |
+| name              | String                   | 标识当前ability的逻辑名                | NA                              |
+| description       | String                   | 标识ability的描述                   | NA                              |
+| descriptionRes    | String                   | 标识ability资源的描述                 | NA                              |
+| iconId            | int                      | 标识ability图标资源ID                | NA                              |
+| icon              | String                   | 标识ability图标                    | NA                              |
+| iconPath          | String                   | 标识ability图标路径                  | NA                              |
+| labelId           | int                      | 标识ability对用户显示的名称资源ID          | NA                              |
+| label             | String                   | 标识ability对用户显示的名称              | NA                              |
+| labelRes          | String                   | 标识ability对用户显示的名称资源            | NA                              |
+| type              | String                   | 标识ability类型                    | Stage模型下该值直接赋予page类型 |
+| formsEnabled      | boolean                  | 标识ability卡片是否使能                | NA                              |
+| formInfo          | FormInfo结构体              | 描述卡片的信息                        | NA                              |
+| uri               | String                   | 标识ability的uri信息                | FA模型支持                      |
+| launchType        | String                   | 标识ability中的launcherType信息      | NA                              |
+| orientation       | String                   | 标识ability中的orientation信息       | NA                              |
+| visible           | boolean                  | 标识ability中的visible信息           | NA                              |
+| grantPermission   | boolean                  | 标识ability中的grantPermission信息   | NA                              |
+| readPermission    | String                   | 标识ability中的readPermission信息    | NA                              |
+| writePermission   | String                   | 标识ability中的writePermission信息   | NA                              |
+| uriPermissionMode | String                   | 标识ability中的uriPermissionMode信息 | NA                              |
+| uriPermissionPath | String                   | 标识ability中的uriPermissionPath信息 | NA                              |
+| directLaunch      | boolean                  | 标识ability中的directLaunch信息      | NA                              |
+| mission           | String                   | 标识ability中的mission信息           | NA                              |
+| targetAbility     | String                   | 标识ability中的targetAbility信息     | NA                              |
+| multiUserShared   | boolean                  | 标识ability中的multiUserShared信息   | NA                              |
+| supportPipMode    | boolean                  | 标识ability中的supportPipMode信息    | NA                              |
+| srcLanguage       | String                   | 标识ability中的srcLanguage信息       | NA                              |
+| srcPath           | String                   | 标识ability中的srcPath信息           | NA                              |
+| srcEntrance       | String                   | 标识ability中的srcEntrance信息       | NA                              |
+| continuable       | boolean                  | 标识ability中的continuable信息       | NA                              |
+| metaData          | MetaData结构体（见下述MetaData） | 标识ability的自定义元信息               | NA                             |
+| configChanges     | List\<String>            | 标识ability中的configChanges信息     | NA                              |
+| formInfos         | List\<AbilityFormInfo>   | 标识ability中的forms信息             | NA                              |
+| permissions       | List\<String>            | 标识ability中的permissions信息       | NA                              |
+| skills            | List\<SkillInfo>         | 标识ability中的skills信息            | NA                              |
+| backgroundModes   | List\<String>            | 标识ability中的backgroundModes信息   | NA                              |
+| labels            | HashMap\<String, String> | 标识多语言下ability对用户显示的名称          | NA                             |
+| descriptions      | HashMap\<String, String> | 标识多语言下ability的描述               | NA                              |
 
 ### 4.7 Distro结构体信息
 
-- 
Gitee