图标
Tauri 使用基于其 logo 的默认图标集。这并非您发布应用程序时想要的结果。为了解决这种情况,Tauri 提供了icon
命令,该命令将接收输入文件(默认情况下为"./app-icon.png"
)并创建各种平台所需的所有图标。
文件类型说明
icon.icns
= macOSicon.ico
= Windows*.png
= LinuxSquare*Logo.png
&StoreLogo.png
= 当前未使用,但适用于 AppX/MS Store 目标。
请注意,图标类型可用于上述平台以外的平台(特别是png
)。因此,即使您只打算为部分平台构建,我们也建议包含所有图标。
命令用法
从@tauri-apps/cli
/ tauri-cli
1.1 版本开始,icon
子命令是主 cli 的一部分。
- npm
- Yarn
- pnpm
- bun
- Cargo
npm run tauri icon
yarn tauri icon
pnpm tauri icon
bunx tauri icon
cargo 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 图像,32 像素图层应为第一层。png
:png 图标的要求是:宽度 == 高度,RGBA(RGB + 透明度)和每像素 32 位(每个通道 8 位)。常用的尺寸为 32、128、256 和 512 像素。我们建议至少与tauri icon
的输出匹配:32x32.png
、128x128.png
、[email protected]
和icon.png
。