mcpField
I
icon-generator

icon-generator

github.com/anhao设计与 UI284 次安装32 周前更新
代码仓库

关于 icon-generator

通过附带的 Python 脚本，从源图导出 Android 和 iOS 应用图标资源。可控制图像适配、背景、圆角和额外尺寸，并可选择生成 Android 自适应图标资源。

主要功能

  1. 01导出 Android 和 iOS 图标资源
  2. 02contain 或 cover 图像适配
  3. 03设置留白背景色
  4. 04添加圆角
  5. 05生成额外 PNG 尺寸
  6. 06可选生成 Android 自适应图标

适用场景

  1. 01根据 Logo 图片生成应用图标
  2. 02制作留白或居中裁切图标
  3. 03导出额外的方形 PNG 尺寸
  4. 04准备 Android 自适应图标资源

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/anhao/icon-generator-skill --skill icon-generator

安装后在 Claude Code 中输入/icon-generator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
LICENSE
agents/
openai.yaml
references/
usage.md
scripts/
icon_generator.py

详细介绍

图标生成器

概述

使用捆绑的脚本，将一张源图像转换为 Android 和 iOS 应用图标资源。当任务是确定性的图标导出，而非手动编辑图像时，优先使用此技能。

快速开始

  1. 确认输入图像路径。
  2. 运行 python3 scripts/icon_generator.py <input-image> -o <output-dir>。
  3. 检查生成的 android/ 和 ios/AppIcon.appiconset/ 文件夹。

如有需要，请先安装 Pillow：

python3 -m pip install 'Pillow>=10.0.0'

工作流

选择输出行为
  • 如果必须完整显示 Logo，且可以接受留白，请使用默认的 contain 模式。
  • 如果图标必须填满正方形，且可以接受居中裁剪，请使用 cover。
  • 对于非正方形源图像，请使用 --background 控制留白颜色。
  • 如果导出的图标应已包含圆角，请使用 --corner-radius。
  • 如果用户需要内置 Android 和 iOS 尺寸之外的其他方形 PNG，请使用 --extra-sizes。
  • 如果用户明确需要 Android 自适应图标资源，请使用 --android-adaptive。
运行脚本

基本导出：

python3 scripts/icon_generator.py input.png -o output_icons

导出时进行裁剪、添加白色留白、生成额外尺寸并添加圆角：

python3 scripts/icon_generator.py input.png \
  -o output_icons \
  --mode cover \
  --background '#FFFFFFFF' \
  --extra-sizes 256 384 \
  --corner-radius 18

同时导出 Android 自适应图标：

python3 scripts/icon_generator.py input.png \
  -o output_icons \
  --android-adaptive \
  --adaptive-background '#FFFFFF'

验证结果

  • 检查 android/mipmap-* 中的启动器 PNG。
  • 检查 android/play-store/play_store_icon.png 中的 512px 商店资源。
  • 检查 ios/AppIcon.appiconset/Contents.json 以及生成的 PNG 文件。
  • 如果请求了自适应图标，请检查 android/mipmap-anydpi-v26/ 中的 XML 文件以及 ic_launcher_foreground.png / ic_launcher_background.png。

故障排除

  • 如果脚本因 Pillow 导入错误而退出，请安装 Pillow 并重新运行。
  • 如果颜色无法解析，请传入 #RRGGBB 或 #RRGGBBAA。
  • 如果找不到源图像，请停止操作，并在重新生成前确认路径。
  • 如果用户要求非正方形输出或手动精修，此技能并不适用；请改用图像编辑工作流。

资源

  • 使用 scripts/icon_generator.py 执行实际导出。
  • 阅读 references/usage.md，了解参数详情、尺寸列表和输出结构。

评论

支持 Markdown