跳至主要內容

圖示

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/128x128@2x.png",
        "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、128x128@2x.png 和 icon.png。