搜尋套件、儲存庫與 APP 分類

icons_launcher 封面
套件詳情v3.1.0

icons_launcher

一個命令列工具,可簡化更新您的 Flutter 應用程式啟動圖示的任務。

AndroidiOSmacOSWindowsLinux
近 30 天下載
25.1萬
喜歡數
1080
Pub 分數
160

安裝套件

flutter pub add icons_launcher

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

icons_launcher 是一個命令列工具,專為簡化 Flutter 應用程式中啟動器圖示更新的過程而設計。它自動化了在 Android、iOS、macOS、Windows 和 Linux 等多個平台生成和放置應用圖示的工作。透過簡化圖示管理,該工具減少手動操作,並確保在不同裝置設定下的一致性。此工具可透過 pub add 與 Flutter 專案無縫整合,讓開發者能輕鬆維持專業的應用外觀,而不需複雜的工作流程。

適用情境

  • 更新新版本的應用圖示
  • 跨平台自動化圖示生成
  • 在各種裝置上保持品牌的連貫性
  • 在設計變更後快速重新產生圖示
  • 支援多平台應用程式部署

主要特色

  • 跨平台圖示產生
  • 命令列介面整合
  • 自動資產資料夾更新
  • 支援各種圖示大小和格式
  • 使用 flutter pub add 進行簡單設定

適合對象

  • Flutter 開發人員管理應用品牌
  • 需要一致圖示部署的團隊
  • 針對多個操作系統的專案
  • 尋求節省時間的自動化工具的開發者

使用建議

  • 需要熟悉命令列
  • 可能需要手動驗證生成的資產
  • 依賴於正確的輸入圖像尺寸
  • 不適用於即時圖示編輯
  • 有限的GUI互動

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

🍃 Icons Launcher 🍃

A command-line tool that simplifies the task of updating your Flutter app's launcher icon. Full flexibility allows you to only update the launcher icon for specific platforms as needed.


icons launcher preview

Platform Support
Android iOS macOS Web Linux Windows
✅ ✅ ✅ ✅ ✅ ✅

Guide

1. Setup the config file

Add your Icons Launcher configuration to your pubspec.yaml or create a new config file called icons_launcher.yaml.

An example is shown below. More complex examples here.

Add config to pubspec.yaml or create a separate icons_launcher.yaml
icons_launcher:
  image_path: "assets/ic_logo_radius.png"
  platforms:
    android:
      enable: true
    ios:
      enable: true

Note For IOS 18 icons dark and tinted also supported. See more on example config below.

2. Run the package

After setting up the configuration, all that is left to do is run the package:

flutter pub get
dart run icons_launcher:create

If you name your configuration file something other than icons_launcher.yaml or pubspec.yaml you will need to specify the name of the file when running the package.

flutter pub get
dart run icons_launcher:create --path <your config file name here>

Note

If you are not using the existing pubspec.yaml your config file must still be located in the same directory as it.

If you encounter any issues please report them here.

In the above configuration, the package is setup to replace the existing launcher icons in both the Android and iOS project.


Attributes

Shown below is the full list of attributes which you can specify within your Icons Launcher configuration.

Icons Launcher Option Type Default Description
image_path String null The image file path
platforms Object null Use for specific platforms to generate icons

Platforms Option Type Default Description
android Object null Use for specific Android platform
ios Object null Use for specific iOS platform
macos Object null Use for specific macOS platform
windows Object null Use for specific Windows platform
web Object null Use for specific Web platform
linux Object null Use for specific Linux platform
Android Option Type Default Description
enable Boolean false Use for enable Android platform
image_path String null The image file path
notification_image String null Image for the notification icon
adaptive_background_color String null Color for fill out the background of the adaptive icon
adaptive_background_image String null Image for fill out the background of the adaptive icon
adaptive_foreground_image String null Image for the icon foreground of the adaptive icon
adaptive_round_image String null Image for the round icon of the adaptive icon
adaptive_monochrome_image String null Image for the monochrome version of the adaptive icon
iOS Option Type Default Description
enable Boolean false Use for enable iOS platform
image_path String null The image file path
dark_path String null The dark image file path
tinted_path String null The tinted image file path
Web Option Type Default Description
enable Boolean false Use for enable Web platform
image_path String null The image file path
maskable_image_path String null The maskable image file path for PWA
favicon_path String null The image file path
favicon_output_extension String .png Extension for favicon .png or .ico
macOS Option Type Default Description
enable Boolean false Use for enable macOS platform
image_path String null The image file path
Windows Option Type Default Description
enable Boolean false Use for enable Windows platform
image_path String null The image file path
Linux Option Type Default Description
enable Boolean false Use for enable Linux platform with snapcraft
image_path String null The image file path

Flavor support

Create a Icons Launcher configuration file for your flavor. The config file is called icons_launcher-<flavor>.yaml by replacing <flavor> by the name of your desired flavor.

Example: icons_launcher-dev.yaml and icons_launcher-prod.yaml

Run with flavor:

flutter pub get
# create for dev flavor
dart run icons_launcher:create --flavor dev

# create for prod flavor
dart run icons_launcher:create --flavor prod

Alternatively, you can run multiple flavors at the same time with the following command:

dart run icons_launcher:create --flavors dev,prod

The configuration file format is the same.


Example

icons_launcher:
  platforms:
    android:
      enable: true
      image_path: "assets/ic_logo_radius.png"
      notification_image: "assets/ic_foreground.png"
      # adaptive_background_color: "#ffffff"
      adaptive_background_image: "assets/ic_background.png"
      adaptive_foreground_image: "assets/ic_foreground.png"
      adaptive_round_image: "assets/ic_logo_round.png"
      adaptive_monochrome_image: "assets/ic_black_white.png"
    ios:
      enable: true
      image_path: "assets/ic_logo_rectangle_light.png"
      # For iOS 18+ (support dark and tinted)
      dark_path: "assets/ic_logo_rectangle_dark.png"
      tinted_path: "assets/ic_logo_rectangle_tinted.png"
    web:
      enable: false
      image_path: "assets/ic_logo_rectangle_light.png"
      maskable_image_path: "assets/ic_logo_radius.png"
      favicon_path: "assets/ic_logo_round.png"
      # favicon_output_extension: ".ico"
    macos:
      enable: false
      image_path: "assets/macos_icon.png"
    windows:
      enable: false
      image_path: "assets/ic_logo_radius.png"
    linux:
      enable: false
      image_path: "assets/ic_logo_radius.png"

Activities

Alt

所屬分類

依賴

依賴清單 5 項

原始碼儲存庫

使用此套件的專案

所在榜單