打造自动化图标流水线:用macOS-icon-generator CLI为Jamf Pro和Munki批量生成App图标
打造自动化图标流水线:用macOS-icon-generator CLI为Jamf Pro和Munki批量生成App图标
macOS-icon-generator(应用名 Icons)是一款面向 Mac 管理员的开源 App 图标生成工具:拖入一张源图,即可自动产出 install.png、uninstall.png 和动画版卸载图标。更关键的是,它内置了命令行工具 icons_cli,可以写进脚本里,为 Jamf Pro 和 Munki 批量生成标准化 PNG 图标——完全不需要设计技能。这篇文章带你从零搭起一条图标自动化流水线。
为什么 Mac 管理员需要标准化图标集 🎯
在企业内部 App Store(Jamf Pro 的 App Store / Self Service)里,用户靠图标一眼区分"这是安装还是卸载"。如果你还在用图片编辑器手动裁剪、叠横幅,一次几十款应用就是灾难。macOS-icon-generator 官方定位就是解决这个场景:
官方说明:Icons 可用于 Jamf Pro、开源 Munki 软件安装工具等任意管理工具(见 README.md)。
它一次生成"三件套":
- install.png —— 可带环境横幅(dev/test/prod)的安装图标
- uninstall.png —— 带删除徽章的卸载图标
- uninstall_animated.png —— 9 帧 APNG 动画卸载图标,无限循环
不用打开 CLI,在 Finder 里右键任意图片 → Quick Actions → Make Icon Set 也能一键出全套图标(由 source/Make Icon Set/ActionRequestHandler.m 实现的 Finder 扩展):
认识 icons_cli:藏在 Icons.app 里的命令行引擎 ⌨️
安装 Icons.app 后,CLI 可执行文件就嵌在应用的 Resources 目录里(Xcode 工程通过 CopyFiles 构建阶段将其打包进 app,见 project.pbxproj),调用路径为:
/Applications/Icons.app/Contents/Resources/icons_cli
核心生成逻辑在 source/icons_cli/main.m:加载源图 → 组装安装/卸载图标视图 → 渲染写入输出目录。所有命令行参数的解析集中在 source/icons_cli/Classes/MTProcessInfo.m,默认值定义在 source/Icons/Constants.h。
不带参数运行会打印完整帮助,-v 可查版本:
常用参数速查表
| 参数 | 作用 | 默认值 |
|---|---|---|
-i / --input |
源图片或 .app 应用包路径(必填) | — |
-o / --output |
输出目录,必须已存在(必填) | — |
-s / --size |
输出分辨率(像素,最大 1024) | 自动从 64/128/256/512/1024 选取 |
-b / --bannertext |
安装图标的横幅文字 | 无 |
-c / --bannercolor |
横幅颜色(6 位十六进制) | ffcc00 |
-t / --textcolor |
横幅文字颜色 | 000000 |
-p / --position |
横幅位置 (t|b)(l|r) |
tl |
-a / --bannerangle |
横幅角度(30–60 度) | 45 |
-h / --bannerheight |
横幅高度百分比 | 18 |
-d / --duration |
动画时长(秒,最大 0.9) | 0.5(设为 0 则跳过动画图标) |
-r / --reduce |
缩小源图百分比,避免动画裁切 | 自动计算 |
-g / --deletebadge |
自定义删除徽章图片 | 内置 X 徽章 |
-n / --nameprefix |
输出文件名前缀 | 无 |
-x / --exclude |
排除生成的图标:i/u/a 任意组合 |
无 |
一条命令生成完整图标三件套 ✅
最简用法只需两个参数——输入图片 + 输出目录:
/Applications/Icons.app/Contents/Resources/icons_cli \
-i ./MyApp-icon.png \
-o ~/Desktop/MyApp-icons
运行成功后会看到 Output files have been successfully written,目录里得到三个文件:install.png、uninstall.png、uninstall_animated.png。加上 --nameprefix 则输出 <前缀>_install.png 等(文件命名逻辑见 source/Icons/Classes/MTIconSet.m):
批量图标流水线:环境横幅 + 循环脚本 🔁
macOS-icon-generator 解决多环境管理的关键能力是可定制横幅:开发、测试、生产环境的图标各带一条不同文字色带,终端用户不会装错包。CLI 里的横幅参数与图形界面里的选项一一对应(GUI 面板如 source/Icons/Classes/MTBannerView.m 所示):
把下面这段脚本放进你的图标仓库,每新增一个应用的源图,重新跑一遍即可批量出全套图标:
ICONS_CLI="/Applications/Icons.app/Contents/Resources/icons_cli"
ENV="TEST" # DEV / TEST / PROD 切换环境
SRC_DIR="$HOME/AppIcons/src" # 每个应用的源图放这里
OUT_DIR="$HOME/AppIcons/out"
for img in "$SRC_DIR"/*.png; do
app="$(basename "$img" .png)"
mkdir -p "$OUT_DIR/$app"
"$ICONS_CLI" -i "$img" -o "$OUT_DIR/$app" \
-b "$ENV" -c ffcc00 -t 000000 -p tl \
-n "$app" -s 512
done
脚本跑完后:
- Jamf Pro:把各目录下的
install.png作为应用的 App Icon 导入,uninstall.png配合卸载脚本展示,横幅上的环境名让用户在 Self Service 中一目了然; - Munki:将 PNG 放进安装包资源目录供安装界面引用,
uninstall_animated.png可直接用于卸载脚本的图形提示。
同一条流水线,只改 ENV 变量就能再产出 3 套环境图标,全程零手工操作。
动画卸载图标的高级调参 🎬
uninstall_animated.png 是一个 9 帧无限循环的 APNG 文件,由 source/Icons/Classes/MTIconSet.m 生成,默认总时长 0.5 秒。两个实用调参:
-d:调整动画时长(0.1–0.9 秒),设为0直接跳过动画图标,节省生成时间;-r:手动缩小源图百分比(最大 20),防止动画旋转时画面被裁切;不指定时自动计算;-g:指定公司自己的徽章图片替换内置的 X 删除徽章,--badgesize、--badgemargin控制其大小和边距。
对应的 GUI 设置项(Animation Duration、Reduce Image Size)见下图的 Uninstall 面板:
接入 CI/预置脚本:用好退出码 🚀
icons_cli 是标准命令行程序,天然适合放进 Jamf 预置脚本、Jenkins/脚本化的 Munki 仓库构建中。它在 source/icons_cli/main.m 中定义了清晰的退出码:
| 退出码 | 含义 |
|---|---|
0 |
生成成功 |
255 |
缺少必填的 -i / -o 参数 |
2 |
源图片无法打开(格式无效) |
3 |
输出文件写入失败 |
示例:
"$ICONS_CLI" -i icon.png -o out -b PROD -x a # 跳过动画图标,加快流水线
if [ $? -eq 0 ]; then
echo "Icons ready, packaging..."
fi
写在最后
macOS-icon-generator 的分工很清晰:GUI 窗口负责单张图片的精调,Finder Quick Action 负责日常快捷操作,icons_cli 负责批量与自动化。一旦把 CLI 接入 Jamf Pro / Munki 的发布流水线,你的内部 App Store 就能始终保持图标统一、环境可辨、零人工维护——这正是"自动化图标流水线"的全部意义。核心源码入口都在这几个文件,方便进阶阅读:source/icons_cli/main.m、source/icons_cli/Classes/MTProcessInfo.m、source/Icons/Constants.h。