DevEco Studio的前景图和后景图怎么使用？foreground.png,background。

DevEco Studio的前景图和后景图怎么使用？foreground.png,background。 请问大家：DevEco Studio的前景图和后景图怎么使用？foreground.png,background。

要修改module.json5文件吗？

6 回复

您好，1楼两种方式都可以，您可参考文档配置分层图标。

方式一：配置app.json5

app.json5该配置仅当module.json5配置文件中无UIAbility、或者存在UIAbility但abilities标签中未设置icon和label（可手动删除icon和label配置）时生效。

方式二：配置module.json5

【背景知识】

  • 配置分层图标：应用图标如果采用分层图标（包括前景图和背景图两层），可以参考本文档进行配置。图标规范详见图标资源规范。
  • 配置优先级和生成策略：图标和标签通常一起配置，对应app.json5配置文件和module.json5配置文件中的icon和label标签。系统将优先返回module.json5中的icon与label，如果在module.json5配置文件的abilities标签中未设置icon和label，系统将返回app.json5中的icon和label。

  1. 将前景资源和背景资源文件放在“AppScope\resources\base\media”文件夹下。 例如前景资源文件名为“foreground.png”，背景资源文件名为“background.png”。 在“AppScope\resources\base\media”文件夹下app_layered_image.json分层图标资源文件中，配置分层图标的前景资源与背景资源信息。

    {
  "layered-image":
  {
    "background" : "$media:background",
    "foreground" : "$media:foreground"
  }
}

    在app.json5配置文件中引用分层图标资源文件。

    {
  "app": {
    // ...
    "icon": "$media:layered_image"
  }
}

  2. 将前景资源和背景资源文件放在“entry\src\main\resources\base\media”文件夹下。 例如采用的前景资源和背景资源的文件名分别为“foreground.png”和“background.png”。 在“entry\src\main\resources\base\media”文件夹下layered_image.json分层图标资源文件中，配置分层图标的前景资源与背景资源信息。

    {
  "layered-image":
  {
    "background" : "$media:background",
    "foreground" : "$media:foreground"
  }
}

    在配置module.json5配置使用：

    // icon配置为分层图标资源文件的索引
"icon": "$media:layered_image",

期待HarmonyOS能在未来推出更多针对特定场景的优化功能。

small，请问，你是指这2个方案都可以，是吗？

在DevEco Studio中，前景图（foreground.png）和后景图（background.png）用于定义Ability的启动过渡动画。前景图显示在Ability内容之上，后景图显示在内容之下。在config.json文件的"abilities"字段内，为对应Ability配置"startWindowBackground"、"startWindowIcon"和"startWindowLabel"属性，分别指定后景图、图标和标签。前景图通常通过代码动态设置或与图标关联。确保图片资源放置在项目的resources目录下，并在配置中正确引用其路径。

在DevEco Studio中，前景图（foreground.png）和后景图（background.png）主要用于配置应用安装时的等待界面。以下是具体使用方法：

  1. 文件位置：将设计好的foreground.png和background.png图片放置在项目的entry > src > main > resources > base > media目录下。

  2. 配置module.json5：需要在对应模块的module.json5文件中进行声明。在abilities字段下的每个ability中，添加"installationFree": false（如果未设置），并在"metadata"数组中添加安装图配置：

    "metadata": [
  {
    "name": "ohos.ability.foreground",
    "resource": "$media:foreground"
  },
  {
    "name": "ohos.ability.background",
    "resource": "$media:background"
  }
]

  3. 图片规范：

    • 前景图：建议使用透明背景的PNG，尺寸推荐480×480像素，用于覆盖在后景图上显示。
    • 后景图：建议使用不透明背景，尺寸推荐1080×1920像素，作为等待界面的背景。

  4. 注意事项：

    • 仅当应用配置为"installationFree": false（非免安装模式）时，安装等待界面才会生效。
    • 图片需符合HarmonyOS设计规范，避免尺寸或格式错误导致显示异常。

配置后，安装应用时系统将自动组合前后景图作为过渡界面。无需额外代码调用。

回到顶部