【MacOS】自己开发的APP,dock图标圆角 + 调整大小(py2app 版)

请注意,该篇博客内容为我用ai让它帮我总结开发过程生成的,但是实测是好用的,可以看我的实际效果:

最右下角,回收站左面的就是我的app的图标,可以看到大小比其他我在网上下载的别人的app图标小了,也加上了圆角,和系统图标一致!

如果你不满意,你可以更改我下面的py脚本中的其他参数,调整图标的透明遮罩和大小,重新编译项目应用,调整到你满意为止。

如果你不想亲自做这些事,我准备了一个skill,你可以把任务给你的agent:

通过网盘分享的文件:macos-app-icon.skill
链接: https://pan.baidu.com/s/11_EsMQ5zTVDSgORGcUYhlQ?pwd=2qga 提取码: 2qga

代码一:生成图标(make_icon.py)

pythonÍ 复制代码
from PIL import Image, ImageDraw
import os

# ================= 配置区 =================
SRC = "source.png"      # 原始图标,任意尺寸,建议 ≥1024px
CORNER = 0.18           # 圆角曲率 18%
PADDING_RATIO = 0.118   # 边距比例 11.8%(实测与系统图标视觉一致)
# ===========================================

img = Image.open(SRC).convert("RGBA")
side = min(img.size)
img = img.crop((0, 0, side, side))          # 裁切为正方形

# ① 圆角遮罩
mask = Image.new("L", (side, side), 0)
ImageDraw.Draw(mask).rounded_rectangle(
    (0, 0, side, side),
    radius=int(side * CORNER),              # 圆角半径 = 边长 × 18%
    fill=255,
)
img.putalpha(mask)                          # 应用圆角

# ② 加 padding
PADDING = int(side * PADDING_RATIO)
canvas = Image.new(
    "RGBA",
    (side + PADDING * 2, side + PADDING * 2),
    (0, 0, 0, 0),                           # 透明背景
)
canvas.paste(img, (PADDING, PADDING), img)  # 居中贴图

# ③ 生成全部 10 个 iconset 尺寸
#    关键:全程 Pillow Lanczos,绝不用 sips(会破坏 alpha)
final = canvas.resize((1024, 1024), Image.Resampling.LANCZOS)
os.makedirs("MyIcon.iconset", exist_ok=True)

sizes = {
    "icon_16x16.png": 16,     "icon_16x16@2x.png": 32,
    "icon_32x32.png": 32,     "icon_32x32@2x.png": 64,
    "icon_128x128.png": 128,  "icon_128x128@2x.png": 256,
    "icon_256x256.png": 256,  "icon_256x256@2x.png": 512,
    "icon_512x512.png": 512,  "icon_512x512@2x.png": 1024,
}
for name, size in sizes.items():
    final.resize((size, size), Image.Resampling.LANCZOS).save(
        f"MyIcon.iconset/{name}"
    )

# ④ 打包 .icns
os.system("iconutil -c icns MyIcon.iconset -o icon.icns")
print("Done: icon.icns")

运行:

bash 复制代码
pip install Pillow
python3 make_icon.py

代码要点:

  • ①② 是核心:圆角和 padding 直接做进源图,而不是指望系统
  • ③ 别用 sips :sips -z 缩放带 alpha 的 PNG 会产生半透明插值,严重时整个图标变透明;Pillow LANCZOS 对 RGBA 处理正确
  • ④ 尺寸一个不能错:iconset 缺标准尺寸时 macOS 会拿大图缩放顶替,Dock 里显得偏大

代码二:py2app 指定图标(setup.py)

python 复制代码
from setuptools import setup

APP = ["main.py"]
DATA_FILES = []

OPTIONS = {
    "iconfile": "icon.icns",        # ← 关键行,指定图标
    "argv_emulation": False,
    "plist": {
        "CFBundleName": "Your App",
        "CFBundleIdentifier": "com.your.app",
        "CFBundleVersion": "1.0.0",
    },
}

setup(
    app=APP,
    data_files=DATA_FILES,
    options={"py2app": OPTIONS},
    setup_requires=["py2app"],
)
bash 复制代码
python3 setup.py py2app

代码三:清理 + 签名(build.sh)

bash 复制代码
#!/bin/bash
set -e

APP="dist/Your App.app"

# ① 删除 Tcl/Tk 框架里 codesign 无法处理的静态库
find "$APP/Contents/Frameworks" -name "*.a" -delete

# ② 清除扩展属性
xattr -cr "$APP"

# ③ ad-hoc 签名
codesign --force --deep --sign - "$APP"

# ④ 验证
codesign --verify --verbose "$APP"

要点:py2app 的内建签名遇到 Tcl/Tk 框架的 .a 文件会直接抛 RuntimeError: Cannot sign bundle,必须先删再手动签。未签名的 app 在 Apple Silicon 上会以 Code Signature Invalid 崩溃。

原理速览

现象 机制 解法
图标没圆角 Dock 自动加 squircle,但切在满铺内容边缘看不出来 源图自带 padding,露出圆角
图标比系统大 系统应用走 Asset Catalog(Assets.car)带自动 margin,纯 .icns 无此待遇 源图自带 padding 补偿
图标全透明 sips 缩放破坏 alpha 通道 全程 Pillow

.icns 本质是 10 张静态 PNG 的容器,Dock 原样渲染不做加工。所以一切视觉效果(圆角、留白)都必须在生成阶段做进图里,不能指望运行时。

相关推荐
CodeClimb1 天前
Mac 磁盘无法推出(DMG外接盘)排查处理教程
macos
Karl_fang2 天前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
csdn_aspnet3 天前
macOS 10 、Docker 玩轉 MySQL
运维·mysql·macos·docker·容器·mac
秋雨梧桐叶落莳3 天前
【iOS】Block底层详解
macos·ios·cocoa
高调的涵涵5 天前
café 和 café 不是一个文件名
macos
独隅7 天前
WebStorm macOS 安装部署与高效调优完全指南
ide·macos·webstorm
独隅8 天前
WebStorm macOS 安装调优与实战效能全景
ide·macos·webstorm
2601_967987378 天前
安装 Redis 或 Redis Stack
linux·windows·redis·macos·安装
高调的涵涵8 天前
1GB 文件,df 说没占地方
macos
奶油话梅糖8 天前
苹果的内核跑上了安卓手机:2,631 Star 的 HakiOS 让 XNU 在 Adreno GPU 上画出 118 帧
android·macos·智能手机