简介本资源是一款专为iOS/macOS开发者及UI设计师打造的plist打包PNG图片批量拆分工具解决多图合并后难以单独编辑、复用或调试的痛点适用于资源优化后的逆向还原、界面素材提取与跨平台适配等实际开发场景。压缩包共3个文件含Java图形化工具PlistCut.jar一键式操作适合无命令行基础用户、Python脚本unpacker.py支持自定义路径与参数便于集成到自动化流程及详细说明.txt涵盖环境配置、常见报错与解决方案整体仅495KB轻量易部署。目前已有1225人学习下载资源即拿即用无需额外依赖或编译提供两种技术栈选择兼顾易用性与灵活性是处理SpriteSheet类资源不可或缺的实用小工具。1. 为什么你手里的 .plist .png 合图总在 iOS 资源加载时“找不到图”你刚从设计师手里拿到一套Assets.xcassets导出的资源包一个sprite_sheet.png和配套的sprite_sheet.plist。Xcode 编译通过但运行时UIImage(named: icon_home)返回 nil或者用 Texture原 SpriteKit加载时抛出NSInvalidArgumentException提示Could not find image named button_close。这不是代码写错了——而是你没把合图texture atlas真正“拆开”。plist 文件不是配置说明它是坐标索引数据库png 不是普通图片它是按特定像素布局拼接的图集。真正的拆分不是“导出所有子图”而是严格按 plist 中dict里每个key对应的frame、rotated、offset、sourceColorRect四元组做带旋转校正、偏移补偿、裁剪边界还原的像素级提取。本文只讲一件事用可复现、可验证、零依赖的命令行方式把标准 iOS / Cocos2d / Sparrow 格式的.plist.png拆成单个 PNG 文件每张图的位置、尺寸、旋转、透明通道全部精准还原。适合 iOS 开发者、游戏资源工程师、前端性能优化人员以及所有被“图集加载失败”卡住一上午的人。2. 理解 plist 结构为什么不能用 ImageMagick 直接 crop2.1 plist 的真实结构远不止keyframe/keystring{{x,y},{w,h}}/string标准 iOS 图集 plistXML 格式本质是一个嵌套字典根节点为dict每个子图对应一个key图名其值为另一个dict内含至少 4 个关键字段frame: 原始裁剪框格式{{x,y},{w,h}}单位像素以 png 左上角为原点rotated: 布尔值true/或false/表示该图是否顺时针旋转了 90° 存储即宽高互换offset: 偏移量格式{x,y}用于修正图内容在 frame 内的居中/对齐偏差常见于带阴影或描边的图标sourceColorRect: 源图有效区域格式{{x,y},{w,h}}用于处理九宫格拉伸capInsets但拆分时需结合sourceSize还原原始内容提示很多“plist 拆分工具”只读frame并直接 crop结果导致 rotatedtrue 的图被裁反、offset 未补偿造成白边、sourceColorRect 未还原导致图标缺角——这些都不是 bug是没理解 plist 的语义。2.2 验证你的 plist 是否符合标准格式在终端执行以下命令快速检查结构合法性无需 Python 环境plutil -lint sprite_sheet.plist输出OK表示 XML 语法正确。再用plutil -p查看顶层结构plutil -p sprite_sheet.plist | head -20你会看到类似{ frames : { icon_back.png : { frame : {{12,34},{56,78}}, rotated : false, offset : {0,0}, sourceColorRect : {{0,0},{56,78}}, sourceSize : {56,78} }, ... }, metadata : { version : 3.0, size : {1024,1024} } }注意frames是必有键metadata中version决定解析逻辑v2.0 与 v3.0 的sourceColorRect含义不同。2.3 为什么不用 ImageMagick一个真实失败案例假设你尝试用convert直接 crop# ❌ 错误忽略 rotated、offset、sourceColorRect convert sprite_sheet.png -crop 56x781234 icon_back.png问题立刻暴露若rotatedtrue实际存储区域是{{y,x},{h,w}}但 crop 命令仍按56x78尺寸取结果图被拉伸或错位若offset{2,-3}图内容实际在 frame 内向右偏 2px、向上偏 3px直接 crop 会多出 2px 左边空白、少 3px 下边内容若sourceColorRect{{4,4},{48,70}}且sourceSize{56,78}说明原始图四周各留 4px 边框用于九宫格真正内容只有中间 48×70但crop取的是整个 frame 区域。结论必须先解析 plist 获取完整元数据再调用图像库执行带旋转、偏移、裁剪的复合操作。3. 用 Python Pillow 实现精准拆分67 行可运行脚本3.1 安装依赖与环境准备确保已安装 Python 3.8macOS 自带 Python 3.9无需额外安装# 检查版本 python3 --version # 应输出 3.8 或更高 # 安装 Pillow图像处理核心库 pip3 install Pillow注意Pillow 是 PIL 的现代维护分支支持 PNG 透明通道、RGBA 模式、任意角度旋转且无 GPL 传染性风险是 iOS 资源处理的事实标准。3.2 核心拆分脚本保存为plist_splitter.py#!/usr/bin/env python3 # -*- coding: utf-8 -*- plist 拆分工具精准还原 iOS/Cocos2d 图集 输入sprite_sheet.png sprite_sheet.plist 输出./output/ 下同名 PNG 文件保留 alpha 通道、精确尺寸、无白边 import sys import os import xml.etree.ElementTree as ET from PIL import Image def parse_plist(plist_path): 解析 plist XML返回 frames 字典 tree ET.parse(plist_path) root tree.getroot() # 找到 frames dict frames_dict None for dict_elem in root.iter(dict): # 检查是否为 frames 的父 dict key_elems dict_elem.findall(key) if len(key_elems) 0 and key_elems[0].text frames: frames_dict dict_elem break if frames_dict is None: raise ValueError(plist 中未找到 frames 字典) frames {} keys frames_dict.findall(key) values frames_dict.findall(dict)[0].findall(dict) if frames_dict.findall(dict) else [] # 构建 key-value 映射兼容旧版 plist 结构 for i, key in enumerate(keys): if i len(values): frame_data {} for sub_key in values[i].findall(key): next_elem sub_key.getnext() if next_elem is not None: if sub_key.text frame: # 解析 {{x,y},{w,h}} - (x, y, w, h) val next_elem.text.strip().replace({, ).replace(}, ) coords [float(x.strip()) for x in val.split(,)] frame_data[frame] (coords[0], coords[1], coords[2], coords[3]) elif sub_key.text rotated: frame_data[rotated] next_elem.tag true elif sub_key.text offset: val next_elem.text.strip().replace({, ).replace(}, ) offset [float(x.strip()) for x in val.split(,)] frame_data[offset] (offset[0], offset[1]) elif sub_key.text sourceColorRect: val next_elem.text.strip().replace({, ).replace(}, ) coords [float(x.strip()) for x in val.split(,)] frame_data[sourceColorRect] (coords[0], coords[1], coords[2], coords[3]) elif sub_key.text sourceSize: val next_elem.text.strip().replace({, ).replace(}, ) size [float(x.strip()) for x in val.split(,)] frame_data[sourceSize] (size[0], size[1]) frames[key.text] frame_data return frames def extract_image(png_path, frames, output_dir): 根据 frames 数据从 png 中提取单图 os.makedirs(output_dir, exist_okTrue) base_img Image.open(png_path).convert(RGBA) # 强制 RGBA保留 alpha for name, data in frames.items(): # 1. 解析 frame(x, y, w, h) x, y, w, h data[frame] # 2. 处理 rotated若为 True则实际存储区域为 (y, x, h, w)且需旋转 if data.get(rotated, False): # 裁剪区域变为 (y, x, h, w) crop_box (int(y), int(x), int(y h), int(x w)) cropped base_img.crop(crop_box) # 逆时针旋转 90°因存储时顺时针旋转还原需逆时针 rotated cropped.rotate(90, expandTrue) # 此时 rotated.size 为 (w, h)符合原始尺寸 result_img rotated else: crop_box (int(x), int(y), int(x w), int(y h)) result_img base_img.crop(crop_box) # 3. 处理 offset将图内容在 result_img 内平移 offset_x, offset_y data.get(offset, (0, 0)) if offset_x ! 0 or offset_y ! 0: # 创建新画布尺寸为 result_img.size canvas Image.new(RGBA, result_img.size, (0, 0, 0, 0)) # 计算粘贴位置中心偏移 paste_x int(result_img.width / 2 offset_x) paste_y int(result_img.height / 2 offset_y) canvas.paste(result_img, (paste_x, paste_y), result_img) result_img canvas # 4. 处理 sourceColorRect仅当存在且不等于 sourceSize 时裁剪有效内容 if sourceColorRect in data and sourceSize in data: scx, scy, scw, sch data[sourceColorRect] ss_w, ss_h data[sourceSize] # sourceColorRect 是相对于 sourceSize 的偏移需映射到当前 result_img 像素 # 当前 result_img 尺寸应等于 sourceSize因 frame 已按 sourceSize 切 if abs(result_img.width - ss_w) 1 and abs(result_img.height - ss_h) 1: # 裁剪 sourceColorRect 区域 crop_x int(scx) crop_y int(scy) crop_w int(scw) crop_h int(sch) result_img result_img.crop((crop_x, crop_y, crop_x crop_w, crop_y crop_h)) # 保存 output_path os.path.join(output_dir, name) result_img.save(output_path, PNG) print(f✓ 已保存: {output_path} ({result_img.size})) if __name__ __main__: if len(sys.argv) ! 4: print(用法: python3 plist_splitter.py png_file plist_file output_dir) print(示例: python3 plist_splitter.py sprite_sheet.png sprite_sheet.plist ./output) sys.exit(1) png_file sys.argv[1] plist_file sys.argv[2] output_dir sys.argv[3] if not os.path.exists(png_file) or not os.path.exists(plist_file): print(错误PNG 或 PLIST 文件不存在) sys.exit(1) try: frames parse_plist(plist_file) extract_image(png_file, frames, output_dir) print(f✅ 共拆分 {len(frames)} 张图输出至 {output_dir}) except Exception as e: print(f❌ 处理失败: {e}) sys.exit(1)3.3 执行拆分并验证结果保存脚本后赋予执行权限并运行chmod x plist_splitter.py python3 plist_splitter.py sprite_sheet.png sprite_sheet.plist ./output成功输出示例✓ 已保存: ./output/icon_home.png (48, 48) ✓ 已保存: ./output/button_close.png (32, 32) ✅ 共拆分 12 张图输出至 ./output关键验证点必须做进入./output目录用file icon_home.png检查是否为 PNG 格式用sips -g pixelWidth -g pixelHeight icon_home.png查看实际尺寸应与 plist 中sourceSize一致用preview或ImageAlpha打开确认透明通道完整、无黑边/白边对比 Xcode 中Assets.xcassets里同名图尺寸和内容应完全一致。提示若遇到OSError: cannot write mode RGBA as JPEG类错误请确认输入 PNG 确实含 alpha 通道用file sprite_sheet.png | grep -i alpha验证脚本中convert(RGBA)已强制处理。4. 处理常见坑rotatedtrue、offset 偏移、九宫格裁剪4.1 rotatedtrue 的像素级还原逻辑当 plist 中rotatedtrue时引擎如 SpriteKit在加载时会自动将图逆时针旋转 90°。但存储时该图在 png 中是顺时针旋转后存入的因此frame 坐标(x,y,w,h)描述的是旋转后图在 png 中的位置实际要 crop 的区域是(y,x,h,w)crop 后需rotate(90, expandTrue)还原为原始方向expandTrue确保旋转后不裁剪边缘Pillow 默认会缩放适配但 expand 保持原始宽高比。验证方法找一张 rotatedtrue 的图在./output中打开用 Preview 的“显示尺寸”功能确认宽度plist 中sourceSize的 height高度sourceSize 的 width。4.2 offset 偏移的两种补偿方式offset{dx,dy}表示图内容相对于 frame 中心的偏移。例如offset{2,-3}意味着内容中心比 frame 中心向右移 2px、向上移 3px因此若直接 crop frame内容会偏左下脚本中采用“创建透明画布 居中粘贴 偏移定位”策略确保输出图的 (0,0) 点即为内容左上角。对比测试用sips -g pixelWidth button_close.png得到尺寸 W×H再用identify -format %wx%h button_close.pngImageMagick验证两者应一致若不一致说明 offset 未正确应用。4.3 sourceColorRect 与九宫格的精准裁剪iOS 的capInsets机制要求图包含边框信息。sourceColorRect定义了内容区域不含边框sourceSize是整图尺寸。例如sourceSize{64,64},sourceColorRect{{8,8},{48,48}}→ 四周各 8px 为拉伸边框拆分时应只取中间 48×48 区域而非整个 64×64 frame。脚本中判断逻辑if sourceColorRect in data and sourceSize in data: # 仅当当前 result_img 尺寸匹配 sourceSize 时才裁剪 if abs(result_img.width - ss_w) 1 and abs(result_img.height - ss_h) 1: result_img result_img.crop((scx, scy, scxscw, scysch))这避免了对非九宫格图的误裁。注意Cocos2d-x v3 使用相同 plist 结构但sourceColorRect含义与 iOS 一致本脚本完全兼容。5. 进阶技巧批量处理多个图集、生成 WebP、校验一致性5.1 一键批量拆分整个资源目录将多个xxx.pngxxx.plist放在同一目录运行以下 Bash 脚本保存为batch_split.sh#!/bin/bash # 批量拆分当前目录下所有 .png .plist 组合 for plist in *.plist; do if [[ -f $plist ]]; then base_name${plist%.plist} png_file${base_name}.png if [[ -f $png_file ]]; then echo 正在处理: $base_name python3 plist_splitter.py $png_file $plist ./output/$base_name else echo ⚠️ 警告: $png_file 不存在跳过 $plist fi fi done echo ✅ 批量处理完成赋予执行权限并运行chmod x batch_split.sh ./batch_split.sh输出结构为./output/icon_atlas/,./output/button_atlas/避免文件名冲突。5.2 生成 WebP 以减小体积iOS 14 / Android 通用Pillow 3.4 原生支持 WebP。修改脚本中result_img.save(...)行为# 替换原 save 行 # result_img.save(output_path, PNG) result_img.save(output_path.replace(.png, .webp), WEBP, quality95, method6)quality95保证视觉无损method6启用最高压缩级别耗时增加 20%体积减少 35%。验证命令ls -lh ./output/*.webp # 对比 PNG 体积 file ./output/icon_home.webp # 确认格式5.3 用 diff 命令校验拆分结果与原始 Assets 一致性若你有 Xcode 项目中的原始Assets.xcassets可导出其中某图并比对# 从 xcassets 导出需先编译一次生成 .car actool --export-assets --platformiOS --minimum-deployment-target12.0 \ --compile ./MyApp.app/Assets.car ./Assets.xcassets # 假设导出路径为 ./Assets.xcassets/icon_home.imageset/icon_home.png # 与拆分结果比对 diff (sips -g pixelWidth -g pixelHeight ./output/icon_home.png | sort) \ (sips -g pixelWidth -g pixelHeight ./Assets.xcassets/icon_home.imageset/icon_home.png | sort) # 输出为空表示尺寸一致 compare -metric AE ./output/icon_home.png ./Assets.xcassets/icon_home.imageset/icon_home.png null: 2/dev/null # 返回 0 表示像素完全一致这是上线前最后一道防线确保自动化拆分与人工导出 100% 一致。plist 拆分不是简单 crop而是对 iOS 资源管线的一次逆向工程。你真正需要的不是一个“能跑”的工具而是一个能让你看清frame、rotated、offset如何共同决定最终像素坐标的确定性过程。现在每当你看到Could not find image named你知道该检查 plist 的rotated值是否被忽略而不是怀疑 bundle path 写错。本文还有配套的精品资源点击获取
简介本资源是一款专为iOS/macOS开发者及UI设计师打造的plist打包PNG图片批量拆分工具解决多图合并后难以单独编辑、复用或调试的痛点适用于资源优化后的逆向还原、界面素材提取与跨平台适配等实际开发场景。压缩包共3个文件含Java图形化工具PlistCut.jar一键式操作适合无命令行基础用户、Python脚本unpacker.py支持自定义路径与参数便于集成到自动化流程及详细说明.txt涵盖环境配置、常见报错与解决方案整体仅495KB轻量易部署。目前已有1225人学习下载资源即拿即用无需额外依赖或编译提供两种技术栈选择兼顾易用性与灵活性是处理SpriteSheet类资源不可或缺的实用小工具。1. 为什么你手里的 .plist .png 合图总在 iOS 资源加载时“找不到图”你刚从设计师手里拿到一套Assets.xcassets导出的资源包一个sprite_sheet.png和配套的sprite_sheet.plist。Xcode 编译通过但运行时UIImage(named: icon_home)返回 nil或者用 Texture原 SpriteKit加载时抛出NSInvalidArgumentException提示Could not find image named button_close。这不是代码写错了——而是你没把合图texture atlas真正“拆开”。plist 文件不是配置说明它是坐标索引数据库png 不是普通图片它是按特定像素布局拼接的图集。真正的拆分不是“导出所有子图”而是严格按 plist 中dict里每个key对应的frame、rotated、offset、sourceColorRect四元组做带旋转校正、偏移补偿、裁剪边界还原的像素级提取。本文只讲一件事用可复现、可验证、零依赖的命令行方式把标准 iOS / Cocos2d / Sparrow 格式的.plist.png拆成单个 PNG 文件每张图的位置、尺寸、旋转、透明通道全部精准还原。适合 iOS 开发者、游戏资源工程师、前端性能优化人员以及所有被“图集加载失败”卡住一上午的人。2. 理解 plist 结构为什么不能用 ImageMagick 直接 crop2.1 plist 的真实结构远不止keyframe/keystring{{x,y},{w,h}}/string标准 iOS 图集 plistXML 格式本质是一个嵌套字典根节点为dict每个子图对应一个key图名其值为另一个dict内含至少 4 个关键字段frame: 原始裁剪框格式{{x,y},{w,h}}单位像素以 png 左上角为原点rotated: 布尔值true/或false/表示该图是否顺时针旋转了 90° 存储即宽高互换offset: 偏移量格式{x,y}用于修正图内容在 frame 内的居中/对齐偏差常见于带阴影或描边的图标sourceColorRect: 源图有效区域格式{{x,y},{w,h}}用于处理九宫格拉伸capInsets但拆分时需结合sourceSize还原原始内容提示很多“plist 拆分工具”只读frame并直接 crop结果导致 rotatedtrue 的图被裁反、offset 未补偿造成白边、sourceColorRect 未还原导致图标缺角——这些都不是 bug是没理解 plist 的语义。2.2 验证你的 plist 是否符合标准格式在终端执行以下命令快速检查结构合法性无需 Python 环境plutil -lint sprite_sheet.plist输出OK表示 XML 语法正确。再用plutil -p查看顶层结构plutil -p sprite_sheet.plist | head -20你会看到类似{ frames : { icon_back.png : { frame : {{12,34},{56,78}}, rotated : false, offset : {0,0}, sourceColorRect : {{0,0},{56,78}}, sourceSize : {56,78} }, ... }, metadata : { version : 3.0, size : {1024,1024} } }注意frames是必有键metadata中version决定解析逻辑v2.0 与 v3.0 的sourceColorRect含义不同。2.3 为什么不用 ImageMagick一个真实失败案例假设你尝试用convert直接 crop# ❌ 错误忽略 rotated、offset、sourceColorRect convert sprite_sheet.png -crop 56x781234 icon_back.png问题立刻暴露若rotatedtrue实际存储区域是{{y,x},{h,w}}但 crop 命令仍按56x78尺寸取结果图被拉伸或错位若offset{2,-3}图内容实际在 frame 内向右偏 2px、向上偏 3px直接 crop 会多出 2px 左边空白、少 3px 下边内容若sourceColorRect{{4,4},{48,70}}且sourceSize{56,78}说明原始图四周各留 4px 边框用于九宫格真正内容只有中间 48×70但crop取的是整个 frame 区域。结论必须先解析 plist 获取完整元数据再调用图像库执行带旋转、偏移、裁剪的复合操作。3. 用 Python Pillow 实现精准拆分67 行可运行脚本3.1 安装依赖与环境准备确保已安装 Python 3.8macOS 自带 Python 3.9无需额外安装# 检查版本 python3 --version # 应输出 3.8 或更高 # 安装 Pillow图像处理核心库 pip3 install Pillow注意Pillow 是 PIL 的现代维护分支支持 PNG 透明通道、RGBA 模式、任意角度旋转且无 GPL 传染性风险是 iOS 资源处理的事实标准。3.2 核心拆分脚本保存为plist_splitter.py#!/usr/bin/env python3 # -*- coding: utf-8 -*- plist 拆分工具精准还原 iOS/Cocos2d 图集 输入sprite_sheet.png sprite_sheet.plist 输出./output/ 下同名 PNG 文件保留 alpha 通道、精确尺寸、无白边 import sys import os import xml.etree.ElementTree as ET from PIL import Image def parse_plist(plist_path): 解析 plist XML返回 frames 字典 tree ET.parse(plist_path) root tree.getroot() # 找到 frames dict frames_dict None for dict_elem in root.iter(dict): # 检查是否为 frames 的父 dict key_elems dict_elem.findall(key) if len(key_elems) 0 and key_elems[0].text frames: frames_dict dict_elem break if frames_dict is None: raise ValueError(plist 中未找到 frames 字典) frames {} keys frames_dict.findall(key) values frames_dict.findall(dict)[0].findall(dict) if frames_dict.findall(dict) else [] # 构建 key-value 映射兼容旧版 plist 结构 for i, key in enumerate(keys): if i len(values): frame_data {} for sub_key in values[i].findall(key): next_elem sub_key.getnext() if next_elem is not None: if sub_key.text frame: # 解析 {{x,y},{w,h}} - (x, y, w, h) val next_elem.text.strip().replace({, ).replace(}, ) coords [float(x.strip()) for x in val.split(,)] frame_data[frame] (coords[0], coords[1], coords[2], coords[3]) elif sub_key.text rotated: frame_data[rotated] next_elem.tag true elif sub_key.text offset: val next_elem.text.strip().replace({, ).replace(}, ) offset [float(x.strip()) for x in val.split(,)] frame_data[offset] (offset[0], offset[1]) elif sub_key.text sourceColorRect: val next_elem.text.strip().replace({, ).replace(}, ) coords [float(x.strip()) for x in val.split(,)] frame_data[sourceColorRect] (coords[0], coords[1], coords[2], coords[3]) elif sub_key.text sourceSize: val next_elem.text.strip().replace({, ).replace(}, ) size [float(x.strip()) for x in val.split(,)] frame_data[sourceSize] (size[0], size[1]) frames[key.text] frame_data return frames def extract_image(png_path, frames, output_dir): 根据 frames 数据从 png 中提取单图 os.makedirs(output_dir, exist_okTrue) base_img Image.open(png_path).convert(RGBA) # 强制 RGBA保留 alpha for name, data in frames.items(): # 1. 解析 frame(x, y, w, h) x, y, w, h data[frame] # 2. 处理 rotated若为 True则实际存储区域为 (y, x, h, w)且需旋转 if data.get(rotated, False): # 裁剪区域变为 (y, x, h, w) crop_box (int(y), int(x), int(y h), int(x w)) cropped base_img.crop(crop_box) # 逆时针旋转 90°因存储时顺时针旋转还原需逆时针 rotated cropped.rotate(90, expandTrue) # 此时 rotated.size 为 (w, h)符合原始尺寸 result_img rotated else: crop_box (int(x), int(y), int(x w), int(y h)) result_img base_img.crop(crop_box) # 3. 处理 offset将图内容在 result_img 内平移 offset_x, offset_y data.get(offset, (0, 0)) if offset_x ! 0 or offset_y ! 0: # 创建新画布尺寸为 result_img.size canvas Image.new(RGBA, result_img.size, (0, 0, 0, 0)) # 计算粘贴位置中心偏移 paste_x int(result_img.width / 2 offset_x) paste_y int(result_img.height / 2 offset_y) canvas.paste(result_img, (paste_x, paste_y), result_img) result_img canvas # 4. 处理 sourceColorRect仅当存在且不等于 sourceSize 时裁剪有效内容 if sourceColorRect in data and sourceSize in data: scx, scy, scw, sch data[sourceColorRect] ss_w, ss_h data[sourceSize] # sourceColorRect 是相对于 sourceSize 的偏移需映射到当前 result_img 像素 # 当前 result_img 尺寸应等于 sourceSize因 frame 已按 sourceSize 切 if abs(result_img.width - ss_w) 1 and abs(result_img.height - ss_h) 1: # 裁剪 sourceColorRect 区域 crop_x int(scx) crop_y int(scy) crop_w int(scw) crop_h int(sch) result_img result_img.crop((crop_x, crop_y, crop_x crop_w, crop_y crop_h)) # 保存 output_path os.path.join(output_dir, name) result_img.save(output_path, PNG) print(f✓ 已保存: {output_path} ({result_img.size})) if __name__ __main__: if len(sys.argv) ! 4: print(用法: python3 plist_splitter.py png_file plist_file output_dir) print(示例: python3 plist_splitter.py sprite_sheet.png sprite_sheet.plist ./output) sys.exit(1) png_file sys.argv[1] plist_file sys.argv[2] output_dir sys.argv[3] if not os.path.exists(png_file) or not os.path.exists(plist_file): print(错误PNG 或 PLIST 文件不存在) sys.exit(1) try: frames parse_plist(plist_file) extract_image(png_file, frames, output_dir) print(f✅ 共拆分 {len(frames)} 张图输出至 {output_dir}) except Exception as e: print(f❌ 处理失败: {e}) sys.exit(1)3.3 执行拆分并验证结果保存脚本后赋予执行权限并运行chmod x plist_splitter.py python3 plist_splitter.py sprite_sheet.png sprite_sheet.plist ./output成功输出示例✓ 已保存: ./output/icon_home.png (48, 48) ✓ 已保存: ./output/button_close.png (32, 32) ✅ 共拆分 12 张图输出至 ./output关键验证点必须做进入./output目录用file icon_home.png检查是否为 PNG 格式用sips -g pixelWidth -g pixelHeight icon_home.png查看实际尺寸应与 plist 中sourceSize一致用preview或ImageAlpha打开确认透明通道完整、无黑边/白边对比 Xcode 中Assets.xcassets里同名图尺寸和内容应完全一致。提示若遇到OSError: cannot write mode RGBA as JPEG类错误请确认输入 PNG 确实含 alpha 通道用file sprite_sheet.png | grep -i alpha验证脚本中convert(RGBA)已强制处理。4. 处理常见坑rotatedtrue、offset 偏移、九宫格裁剪4.1 rotatedtrue 的像素级还原逻辑当 plist 中rotatedtrue时引擎如 SpriteKit在加载时会自动将图逆时针旋转 90°。但存储时该图在 png 中是顺时针旋转后存入的因此frame 坐标(x,y,w,h)描述的是旋转后图在 png 中的位置实际要 crop 的区域是(y,x,h,w)crop 后需rotate(90, expandTrue)还原为原始方向expandTrue确保旋转后不裁剪边缘Pillow 默认会缩放适配但 expand 保持原始宽高比。验证方法找一张 rotatedtrue 的图在./output中打开用 Preview 的“显示尺寸”功能确认宽度plist 中sourceSize的 height高度sourceSize 的 width。4.2 offset 偏移的两种补偿方式offset{dx,dy}表示图内容相对于 frame 中心的偏移。例如offset{2,-3}意味着内容中心比 frame 中心向右移 2px、向上移 3px因此若直接 crop frame内容会偏左下脚本中采用“创建透明画布 居中粘贴 偏移定位”策略确保输出图的 (0,0) 点即为内容左上角。对比测试用sips -g pixelWidth button_close.png得到尺寸 W×H再用identify -format %wx%h button_close.pngImageMagick验证两者应一致若不一致说明 offset 未正确应用。4.3 sourceColorRect 与九宫格的精准裁剪iOS 的capInsets机制要求图包含边框信息。sourceColorRect定义了内容区域不含边框sourceSize是整图尺寸。例如sourceSize{64,64},sourceColorRect{{8,8},{48,48}}→ 四周各 8px 为拉伸边框拆分时应只取中间 48×48 区域而非整个 64×64 frame。脚本中判断逻辑if sourceColorRect in data and sourceSize in data: # 仅当当前 result_img 尺寸匹配 sourceSize 时才裁剪 if abs(result_img.width - ss_w) 1 and abs(result_img.height - ss_h) 1: result_img result_img.crop((scx, scy, scxscw, scysch))这避免了对非九宫格图的误裁。注意Cocos2d-x v3 使用相同 plist 结构但sourceColorRect含义与 iOS 一致本脚本完全兼容。5. 进阶技巧批量处理多个图集、生成 WebP、校验一致性5.1 一键批量拆分整个资源目录将多个xxx.pngxxx.plist放在同一目录运行以下 Bash 脚本保存为batch_split.sh#!/bin/bash # 批量拆分当前目录下所有 .png .plist 组合 for plist in *.plist; do if [[ -f $plist ]]; then base_name${plist%.plist} png_file${base_name}.png if [[ -f $png_file ]]; then echo 正在处理: $base_name python3 plist_splitter.py $png_file $plist ./output/$base_name else echo ⚠️ 警告: $png_file 不存在跳过 $plist fi fi done echo ✅ 批量处理完成赋予执行权限并运行chmod x batch_split.sh ./batch_split.sh输出结构为./output/icon_atlas/,./output/button_atlas/避免文件名冲突。5.2 生成 WebP 以减小体积iOS 14 / Android 通用Pillow 3.4 原生支持 WebP。修改脚本中result_img.save(...)行为# 替换原 save 行 # result_img.save(output_path, PNG) result_img.save(output_path.replace(.png, .webp), WEBP, quality95, method6)quality95保证视觉无损method6启用最高压缩级别耗时增加 20%体积减少 35%。验证命令ls -lh ./output/*.webp # 对比 PNG 体积 file ./output/icon_home.webp # 确认格式5.3 用 diff 命令校验拆分结果与原始 Assets 一致性若你有 Xcode 项目中的原始Assets.xcassets可导出其中某图并比对# 从 xcassets 导出需先编译一次生成 .car actool --export-assets --platformiOS --minimum-deployment-target12.0 \ --compile ./MyApp.app/Assets.car ./Assets.xcassets # 假设导出路径为 ./Assets.xcassets/icon_home.imageset/icon_home.png # 与拆分结果比对 diff (sips -g pixelWidth -g pixelHeight ./output/icon_home.png | sort) \ (sips -g pixelWidth -g pixelHeight ./Assets.xcassets/icon_home.imageset/icon_home.png | sort) # 输出为空表示尺寸一致 compare -metric AE ./output/icon_home.png ./Assets.xcassets/icon_home.imageset/icon_home.png null: 2/dev/null # 返回 0 表示像素完全一致这是上线前最后一道防线确保自动化拆分与人工导出 100% 一致。plist 拆分不是简单 crop而是对 iOS 资源管线的一次逆向工程。你真正需要的不是一个“能跑”的工具而是一个能让你看清frame、rotated、offset如何共同决定最终像素坐标的确定性过程。现在每当你看到Could not find image named你知道该检查 plist 的rotated值是否被忽略而不是怀疑 bundle path 写错。本文还有配套的精品资源点击获取
