图标
本节介绍如何为各种平台配置应用程序的图标。有关启动画面图像的文档可以在 Cordova-Plugin-Splashscreen 文档 启动画面插件文档中找到。
在 CLI 中配置图标
在 CLI 中工作时,您可以通过
属性
描述
src
必需 图像文件的位置,相对于您的项目目录。
platform
可选 目标平台
width
可选 图标宽度,以像素为单位
height
可选 图标高度,以像素为单位
target
可选 设置目标以提供 application 和 installer 的唯一图标
以下配置可用于定义将用于所有平台的单个默认图标。
对于每个平台,您还可以定义一个像素完美的图标集,以适应不同的屏幕分辨率。
Android
您可以使用两个图像(背景和前景)来创建一个自适应图标,而不是使用单个图像作为图标。要在 Cordova 中使用自适应图标,至少需要 Cordova CLI 9.0.0 和 Cordova-Android 8.0.0。
Android 13 引入了主题图标,这些图标是附加到现有自适应图标上的单色图像。要在 Cordova 中使用主题图标,至少需要 Cordova CLI 12.0.0 和 Cordova-Android 12.0.0。
属性
描述
background
自适应图标必需 图像(png 或矢量)相对于您的项目目录的位置,或颜色引用
foreground
自适应图标必需 图像(png 或矢量)相对于您的项目目录的位置,或颜色引用
monochrome
对于自适应图标是可选的,但对于主题图标是必需的 图像(png 或矢量)相对于您的项目目录的位置
density
必需 指定的图标密度
自适应图标
要使用自适应图标,必须定义 background、foreground 和可选的 monochrome 属性,而不是 src 属性。src 属性不用于自适应图标。
使用图像的自适应图标
注意:在此示例中,前景色图像也将用作不支持自适应图标的 Android 设备的后备图标。可以通过设置 src 属性来覆盖后备图标。
使用矢量的自适应图标
注意:在此示例中,当使用矢量或颜色定义前景色属性时,必须定义 src 属性。
使用颜色的自适应图标
在您的项目目录中创建一个 res/values/colors.xml 资源文件,以存储应用程序的颜色定义。
在 config.xml 中,我们将添加 resource-file 将 colors.xml 复制到适当的位置,以便在构建时可以使用这些颜色。
标准图标
另请参阅
Android 图标指南
Android 自适应图标 - 用户主题
Android - 支持多种屏幕
浏览器
图标不适用于浏览器平台。
iOS
另请参阅
iPad 和 iPhone 上的应用图标
Electron
自定义应用程序的图标
可以在 config.xml 文件中使用
一个图标可用于应用程序和安装程序,但此图标应至少为 512x512 像素,才能在所有操作系统上正常工作。
注意:如果未提供自定义图标,则会使用 Apache Cordova 默认图标。
注意:在 macOS 上使用 cordova run 时,不会显示自定义图标。它默认为 Electron 的图标。
您可以通过设置 target 属性来为应用程序和安装程序提供唯一的图标。如上所述,安装程序图像应为 512x512 像素,才能在所有平台上正常工作。
对于支持高 DPI 分辨率的设备(例如 Apple 的 Retina 显示屏),您可以创建一组具有相同基本文件名但带有其倍增器后缀的图像。
例如,如果基本图像的文件名为 icon.png 并且是标准分辨率,则 icon@2x.png 将被视为 DPI 从基本值翻倍的高分辨率图像。
icon.png (256px x 256px)
icon@2x.png (512px x 512px)
如果要同时支持具有不同 DPI 密度的显示器,可以将不同大小的图像放在同一文件夹中,并使用不带 DPI 后缀的文件名。例如