一般使用 flutter_launcher_icons
来设置 Flutter 应用的图标,以下是详细的步骤,包括如何配置 pubspec.yaml
文件,以及 Android 和 iOS 的图标尺寸要求:
第一步:准备图标
准备好应用图标,建议使用正方形的图片(一般推荐 1024x1024 像素的 PNG 格式)。放置在项目的 assets/images/
目录下,图标的文件名可以是 app_icon.png
。
第二步:在 pubspec.yaml
中添加依赖并更新
在项目的 pubspec.yaml
文件中,添加 flutter_launcher_icons
作为开发依赖:
dev_dependencies:
flutter_launcher_icons: "^0.13.1"
flutter_launcher_icons:
android: true # 为 Android 生成图标
ios: true # 为 iOS 生成图标
image_path: "assets/images/icon/app_icon.png" # 图标的路径
remove_alpha_ios: true # (可选)去除 iOS 图标的透明度,避免上传到 App Store 时被拒绝
第三步:确保图标路径正确
确认你的图标已经放置在 assets/images/icon/app_icon.png
位置。如果文件夹不存在,先手动创建。
第四步:运行命令生成图标
在终端中执行以下命令,生成 Android 和 iOS 的应用图标:
flutter pub run flutter_launcher_icons:main
或者,如果你使用 FVM
,可以运行:
fvm flutter pub run flutter_launcher_icons:main
如果配置正确并且图片路径无误,终端会输出成功的信息,类似于:
✓ Successfully generated launcher icons
图标尺寸要求
flutter_launcher_icons
会自动生成所需的各种图标尺寸,但你需要了解 Android 和 iOS 的默认图标尺寸:
iOS 图标尺寸:
- 180x180 (60pt @3x)
- 120x120 (60pt @2x)
- 152x152 (76pt @2x)
- 167x167 (83.5pt @2x)
- 1024x1024 (App Store 图标)
Android 图标尺寸:
- 48x48 (mdpi)
- 72x72 (hdpi)
- 96x96 (xhdpi)
- 144x144 (xxhdpi)
- 192x192 (xxxhdpi)
这些图标会自动生成,无需手动调整。
第五步:清理和重新构建项目
最后,执行以下命令清理项目并重新构建:
flutter clean
flutter run
其他配置选项
你可以通过以下配置选项来自定义图标:
-
android: true/false
:指定是否为 Android 生成图标。 -
ios: true/false
:指定是否为 iOS 生成图标。 -
image_path_android
/image_path_ios
:分别为 Android 和 iOS 设置不同的图标路径。
这样,应用图标就设置完成了。