鸿蒙Next App启动图如何设置

在鸿蒙Next开发中，如何为App设置启动图？具体需要修改哪个配置文件？是否支持动态加载不同分辨率的启动图？求详细的操作步骤和示例代码。

2 回复

鸿蒙Next（HarmonyOS NEXT）中，启动图设置方式与HarmonyOS 3/4类似，主要通过配置文件定义。具体步骤：

  1. 在entry/src/main/resources/base/media目录放置启动图图片，建议使用.png格式，命名如icon_splash.png。

  2. 配置module.json5：在abilities字段中对应页面的splashScreen属性设置：

"abilities": [{
  "name": "MainAbility",
  "splashScreen": {
    "backgroundImage": "$media:icon_splash",
    "icon": "$media:icon_splash_icon", // 可选图标
    "textColor": "#FFFFFF" // 文字颜色（若有文字）
  }
}]
  1. 图片尺寸适配：需提供不同分辨率的图片（如hdpi/xhdpi等目录），确保多设备兼容。

注意：HarmonyOS NEXT强化了安全与性能，启动图加载时间受系统严格控制，若超时可能被强制跳过。

更多关于鸿蒙Next App启动图如何设置的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next（HarmonyOS NEXT）中，设置App启动图主要通过配置config.json文件中的启动页属性来实现。以下是具体步骤和示例代码：

1. 配置config.json文件

在项目的 entry/src/main/resources/base/profile/ 目录下，找到或创建 config.json 文件，添加或修改 "window" 字段中的启动图设置。

示例代码：

{
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:startIcon",  // 启动图标
        "startWindowBackground": "$color:startBg", // 启动背景色或图片
        "visible": true
      }
    ]
  }
}

2. 资源文件配置

  • 启动图标：在 src/main/resources/base/media/ 中放置图片（如 startIcon.png），并在 resource/base/media/ 中引用。
  • 启动背景：可以是颜色值（在 color.json 中定义）或图片资源。若使用图片，需将图片放在 media 目录并通过 "$media:图片名" 引用。

color.json 示例：

{
  "color": [
    {
      "name": "startBg",
      "value": "#FFFFFF"
    }
  ]
}

3. 注意事项

  • 图片尺寸：建议使用适配不同屏幕密度的图片（如 startIcon.png、startIcon@2x.png）。
  • 启动时间：系统默认显示启动图直至App首页加载完成，无需额外控制。
  • 格式支持：支持 PNG、JPG 等常见图片格式。

总结

通过修改 config.json 中的 startWindowIcon 和 startWindowBackground 属性，并配置对应资源文件，即可自定义鸿蒙Next App的启动图。无需编写额外代码，系统会自动处理显示逻辑。

回到顶部