跳至主要内容

图标

Tauri 附带基于其徽标的默认图标集。这并不是你发布应用程序时想要的内容。为了解决这种情况，Tauri 提供了 icon 命令，该命令将获取一个输入文件（默认情况下为 "./app-icon.png"），并创建各种平台所需的所有图标。

文件类型说明
  • icon.icns = macOS
  • icon.ico = Windows
  • *.png = Linux
  • Square*Logo.png 和 StoreLogo.png = 当前未使用，但用于 AppX/MS Store 目标。

请注意，图标类型可用于除上述平台之外的其他平台（特别是 png）。因此，我们建议包含所有图标，即使您打算仅针对部分平台进行构建。

命令用法​

从 @tauri-apps/cli / tauri-cli 版本 1.1 开始，icon 子命令是主 cli 的一部分

npm run tauri icon
> cargo tauri icon --help
cargo-tauri-icon 1.1.0

Generates various icons for all major platforms

USAGE:
    cargo tauri icon [OPTIONS] [INPUT]

ARGS:
    <INPUT>    Path to the source icon (png, 1024x1024px with transparency) [default: ./app-icon.png]

OPTIONS:
    -h, --help               Print help information
    -o, --output <OUTPUT>    Output directory. Default: 'icons' directory next to the tauri.conf.json file
    -v, --verbose            Enables verbose logging
    -V, --version            Print version information

默认情况下，图标将放置在 src-tauri/icons 文件夹中，它们将自动包含在您构建的应用程序中。如果您希望从其他位置获取图标，可以编辑 tauri.conf.json 文件的这一部分

{
  "tauri": {
    "bundle": {
      "icon": [
        "icons/32x32.png",
        "icons/128x128.png",
        "icons/[email protected]",
        "icons/icon.icns",
        "icons/icon.ico"
      ]
    }
  }
}

手动创建图标​

如果您希望自己构建这些图标，例如，如果您希望为小尺寸设计更简单的设计，或者因为您不想依赖 CLI 的内部图像调整大小，您必须确保您的图标满足某些要求

  • icon.icns：icns 文件所需的图层大小和名称在 Tauri 仓库中进行了描述
  • icon.ico：ico 文件必须包括 16、24、32、48、64 和 256 像素的图层。为了在开发中最佳显示 ICO 图像，32px 图层应为第一图层。
  • png：png 图标的要求是：宽度 == 高度、RGBA（RGB + 透明度）和每像素 32 位（每个通道 8 位）。通常预期的尺寸为 32、128、256 和 512 像素。我们建议至少匹配 tauri icon 的输出：32x32.png、128x128.png、[email protected] 和 icon.png。