打造自动化图标流水线:用macOS-icon-generator CLI为Jamf Pro和Munki批量生成App图标

原创2026-11-07 16:53:131,358 阅读
文章标签:开发工具

打造自动化图标流水线:用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)。

它一次生成"三件套":

  1. install.png —— 可带环境横幅(dev/test/prod)的安装图标
  2. uninstall.png —— 带删除徽章的卸载图标
  3. uninstall_animated.png —— 9 帧 APNG 动画卸载图标,无限循环

不用打开 CLI,在 Finder 里右键任意图片 → Quick Actions → Make Icon Set 也能一键出全套图标(由 source/Make Icon Set/ActionRequestHandler.m 实现的 Finder 扩展):

macOS-icon-generator 的 Finder 快捷操作 Make Icon Set 一键生成图标集

认识 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 可查版本:

icons_cli 命令行工具的完整参数帮助界面

常用参数速查表

参数 作用 默认值
-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):

icons_cli 生成的 install.png 安装图标,带标准 App 圆角造型

icons_cli 生成的 uninstall.png 卸载图标,左上角带删除徽章

批量图标流水线:环境横幅 + 循环脚本 🔁

macOS-icon-generator 解决多环境管理的关键能力是可定制横幅:开发、测试、生产环境的图标各带一条不同文字色带,终端用户不会装错包。CLI 里的横幅参数与图形界面里的选项一一对应(GUI 面板如 source/Icons/Classes/MTBannerView.m 所示):

Icons 应用安装图标窗口中的横幅 Banner 设置面板

把下面这段脚本放进你的图标仓库,每新增一个应用的源图,重新跑一遍即可批量出全套图标:

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 面板:

Icons 应用卸载图标窗口的动画时长与图像缩小设置

接入 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。

登录后查看全文
macOS-icon-generator