在鸿蒙Next开发中,startWindowIcon 用于设置应用启动时显示的图标,通常配置在 module.json5 文件中的 abilities 字段下。以下是详细使用方法:
1. 配置步骤
- 在
entry/src/main/resources/base/profile/ 目录下找到 module.json5 文件。
- 在
abilities 中为需要设置启动图标的 Ability 添加 startWindowIcon 属性,指向图标资源路径。
2. 代码示例
{
"module": {
"abilities": [
{
"name": "EntryAbility",
"srcEntry": "./ets/entryability/EntryAbility.ts",
"description": "$string:EntryAbility_desc",
"icon": "$media:icon",
"label": "$string:EntryAbility_label",
"startWindowIcon": "$media:start_icon", // 启动图标资源
"startWindowBackground": "$color:start_background",
"visible": true
}
]
}
}
3. 资源准备
- 图标文件需放在
src/main/resources/base/media/ 目录下(例如 start_icon.png)。
- 在
src/main/resources/base/element/string.json 中确保资源引用正确。
4. 注意事项
- 图标格式支持 PNG、JPG、SVG 等,推荐使用 PNG 以保证清晰度。
- 图标尺寸建议适配不同屏幕密度(如
base、ldpi、hdpi 等目录)。
- 若未设置
startWindowIcon,系统会默认使用 icon 字段的图标。
通过以上配置,应用启动时将显示指定图标,提升用户体验。