1# 应用/组件级配置 2 3在开发应用时，需要配置应用的一些标签，例如应用的包名、图标等标识特征的属性。本文描述了在开发应用需要配置的一些关键标签。 4 5## 应用包名配置 6 7应用需要在工程的AppScope目录下的[app.json5配置文件](../quick-start/app-configuration-file.md)中配置bundleName标签，该标签用于标识应用的唯一性。推荐采用反域名形式命名（如com.example.demo，建议第一级为域名后缀com，第二级为厂商/个人名，第三级为应用名，也可以多级）。 8 9## 图标和标签配置 10图标和标签通常一起配置，对应[app.json5配置文件](../quick-start/app-configuration-file.md)和[module.json5配置文件](../quick-start/module-configuration-file.md)中的icon和label标签。IDE从5.0.3.800版本开始，不再对module.json5中的icon和label做强制校验，因此module.json5与app.json5只需要选择其一配置。 11 12### 生成机制 13* HAP中包含UIAbility 14 15 * 如果在module.json5配置文件的abilities标签中配置了icon和label，且该对应的ability中skills标签下面的entities中包含"entity.system.home"、actions中包含"ohos.want.action.home"，则系统将优先返回module.json5中的icon与label。如果存在多个满足条件的ability，优先返回module.json5中mainElement对应的ability配置的icon和label。 16 17 * 如果在module.json5配置文件的abilities标签中未设置icon和label，系统将返回app.json5中的icon和label。 18 19* HAP中不包含UIAbility，系统将返回app.json5中的icon和label。 20 21 22### 应用场景 23 24- 用于在应用界面内展示当前应用。例如：在设置应用中展示应用列表，在设置的隐私管理中展示应用申请的权限。 25- 用于在设备桌面上展示当前应用。例如：桌面或者最近任务列表中显示应用。 26 27效果图如下： 28 29 30 31### 配置示例 32 33- **方式一：配置app.json5（推荐）** 34 35 ```json 36 { 37 "app": { 38 "icon": "$media:app_icon", 39 "label": "$string:app_name" 40 // ... 41 } 42 } 43 ``` 44 45- **方式二：配置module.json5** 46 47 如果需要在桌面显示UIAbility图标，除了需要配置icon与label字段，还需要在skills标签下面的entities中添加"entity.system.home"、actions中添加"ohos.want.action.home"。 48 49 ```json 50 { 51 "module": { 52 // ... 53 "abilities": [ 54 { 55 "icon": "$media:icon", 56 "label": "$string:EntryAbility_label", 57 "skills": [ 58 { 59 "entities": [ 60 "entity.system.home" 61 ], 62 "actions": [ 63 "ohos.want.action.home" 64 ] 65 } 66 ], 67 } 68 ] 69 } 70 } 71 ``` 72### 管控规则 73系统对无图标应用实施严格管控，防止一些恶意应用故意配置无桌面应用图标，导致用户找不到软件所在的位置，无法操作卸载应用，在一定程度上保证用户终端设备的安全。 74 75如果预置应用确需隐藏桌面应用图标，需要配置AllowAppDesktopIconHide应用特权<!--Del-->，具体配置方式参考[应用特权配置指南](../../device-dev/subsystems/subsys-app-privilege-config-guide.md)<!--DelEnd-->。申请该特权后，应用不会在桌面上显示。除预置应用外，其他应用不支持隐藏桌面图标。 76 77 78## 应用版本声明配置 79 80应用版本声明需要在工程的AppScope目录下的[app.json5配置文件](../quick-start/app-configuration-file.md)中配置versionCode标签和versionName标签。versionCode用于标识应用的版本号，该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新，数值越大表示版本越高。versionName标签标识版本号的文字描述。 81 82## Module支持的设备类型配置 83 84Module支持的设备类型需要在[module.json5配置文件](../quick-start/module-configuration-file.md)中配置[deviceTypes标签](../quick-start/module-configuration-file.md#devicetypes标签)，如果deviceTypes标签中添加了某种设备，则表明当前的Module支持在该设备上运行。 85 86## Module权限配置 87 88Module访问系统或其他应用受保护部分所需的权限信息需要在[module.json5配置文件](../quick-start/module-configuration-file.md)中配置[requestPermissions标签](../security/AccessToken/declare-permissions.md)。该标签用于声明需要申请权限的名称、申请权限的原因以及权限使用的场景。 89
