ipa包内Assets.car资源导出：assetutil命令实战教程-北京尧图网络

拿到一个ipa包想看看里面的图标、启动图或者某张图片素材到底有没有被打进包里很多人第一反应是先把ipa改后缀解压出来找到那个叫Assets.car的文件。然后双击发现Finder根本打不开连预览都没有一脸懵。Assets.car不是图片它是Xcode里Assets.xcassets编译后的资源集合图片都被打成了一个带索引的文件普通的看图工具当然识别不了。这篇文章就从解压ipa、定位Assets.car到用macOS自带的assetutil命令把资源完整导出一条链路讲透。适合iOS开发、测试、设计侧审资源以及做APP资源分析的朋友参考。我最早遇到这个需求是想验证一个线上包里的启动图是不是设计师给的最新版本翻遍图形工具都没辙最后靠assetutil解决了问题。1. 动手之前先搞清楚Assets.car的来龙去脉1.1 先纠正一个容易踩的拼写坑很多人会把文件名记成Assert.car实际上Xcode编译出来的是Assets.car中间那个单词是Assets不是Assert。Assert是程序里的断言关键字跟图片资源八竿子打不着。如果你在搜索引擎或者代码仓库里按Assert.car去搜很容易搜到一堆无关结果白白浪费时间。我见过不止一个同事在群里问“这个Assert.car怎么打开”最后发现是拼写问题。这看起来是个小事但在实际操作里确实会卡住人尤其是当你在代码里搜索、在git历史里找文件、或者在脚本里写资源路径的时候拼错一个字母结果就天差地别。后面所有命令、脚本、参数都是针对Assets.car这个正确文件名来操作的。1.2 Assets.car到底是个什么文件Xcode里的Assets.xcassets是一个资源目录开发者在里面放各种AppIcon、启动图、通用图片还能按设备类型、尺寸、深色模式、显示色域等条件设置不同变体。编译的时候Xcode会把整个Assets.xcassets打包成一个Assets.car文件这个过程叫asset catalog compilation。编译后的Assets.car可以理解为“图片资源的数据库加索引”。它内部不只是简单地把PNG、JPG堆在一起而是把每张图片的元数据、渲染模式、缩放倍数、适用的设备条件都存成了结构化信息。运行时App通过名称去查这个索引就能拿到最适合当前设备的那张图片。这种设计能减少包体积、提升加载效率但代价就是普通工具根本没法直接打开它。所以不要指望Finder、Preview、Photoshop这类软件能识别Assets.car。它本质上不是一张图而是一个容器。想把它里面的图片导出来得用能解析这个容器的工具。苹果官方其实提供了命令行工具就是assetutil后面重点说它。1.3 你的ipa来源决定了解包的难易不是所有ipa包解出来都能直接拿到Assets.car。根据ipa的来源情况分三种ipa来源是否需要脱壳解压后能否直接拿到Assets.carXcode Archive导出的开发包不需要可以企业签名包、开发者自签包不需要可以App Store官方商店包需要先做DRM脱壳直接解压的二进制和资源是受保护的如果你想处理的包是App Store直接下载的里面的可执行文件和部分资源会被FairPlay DRM保护直接用unzip解出来也没法正常分析资源。这种情况不在本文范围内需要先走脱壳流程。但日常开发和测试场景里我们接触最多的其实还是前面两种Xcode产物、企业包、自签包。这些包没有DRM解压后资源都是明文直接就能用assetutil处理。2. 把ipa包拆开找到Assets.car2.1 三种解压姿势按场景选ipa本质上是一个zip压缩包只是换了扩展名。所以解压方式有很多种我这里按实际体验排序。第一种Finder直接改后缀。把ipa后缀改成zip然后双击macOS自带归档工具就能解压。这种方式最直观适合只想快速看一眼包里有什么的情况。缺点是Finder解压偶尔会丢失符号链接和文件权限而且如果你要写脚本自动化处理显然不能靠手动双击。第二种unzip命令行。在终端里执行unzip -q app.ipa -d ipa_extracted-q是静默模式-d指定输出目录。这种方式比Finder可靠一些尤其适合在脚本里调用。缺点是对zip内部文件名的编码处理不够好遇到中文文件名的资源解压出来可能乱码。第三种ditto命令。这是macOS自带的工具对zip格式兼容性比unzip更好而且能保留文件权限ditto -x -k app.ipa ipa_extracted-x表示解压-k表示输入文件是zip格式。我自己最常用这个因为稳定而且对中文文件名、符号链接的处理都更友好。后面几个小节的演示命令默认都用ditto解压。2.2 在Payload中找到Assets.car解压完成后进入解压目录会看到一个Payload文件夹里面是xxxxx.app。这个.app本质上也是一个目录右键“显示包内容”就能进去。在终端里可以这样定位cd ipa_extracted/Payload find . -name *.car -type f正常情况下Assets.car就在主bundle的根目录下路径类似Payload/WeChat.app/Assets.car但有些App会把资源拆到其他bundle或framework里比如第三方组件、扩展、watchOS App等也会有自己的Assets.car。用find命令全量搜一遍是最稳妥的。找到之后可以先看一眼文件类型file WeChat.app/Assets.car输出结果大概率是data或者Apple Binary Plist反正不会是image。这再一次说明它不是一个能直接打开的图片文件。2.3 解压时容易踩的几个坑第一个坑ipa包很大但磁盘空间不够。解压前先看下包大小和可用空间一个大游戏ipa可能好几个GB解压出来还会膨胀。第二个坑解压报错“End-of-central-directory signature not found”。这通常说明文件不完整或者根本不是ipa格式。先确认文件下载是否中断。第三个坑有人会在Finder里直接右键ipa选“打开方式”里的归档工具解压解到一半又去编辑里面的文件。这样会破坏代码签名如果目的是重打包十有八九会失败。第四个坑路径里有空格或中文。终端里执行命令时记得给路径加引号否则找不到文件。3. 核心实操用assetutil导出资源3.1 先执行--info读取资源索引assetutil是Xcode Command Line Tools自带的工具正常装了Xcode或命令行工具就能用。最常用的参数是--info它能输出整个Assets.car的资源索引格式是JSON数组。在Assets.car所在目录执行xcrun --sdk iphoneos assetutil --info Assets.car assets_info.json为什么用xcrun而不是直接assetutil因为xcrun会绑定当前激活的Xcode版本确保用的是与系统匹配的工具链。有些机器上装了多个Xcode版本直接调用assetutil可能指向旧版解析新格式的car文件会失败。打开assets_info.json能看到每条资源的详细信息。常用的字段包括字段含义AssetType资源类型常见Image、Icon等Name开发者在Assets.xcassets里的资源名Idiom设备类型universal、iphone、ipadScale缩放倍数1、2、3DisplayGamut色域srgb、p3MemoryClass内存级别GraphicsFeatureClass图形特性级别DeploymentTarget最低系统版本先看这个JSON你就能知道包里大概有哪些资源哪些是AppIcon哪些是启动图哪些是普通图片。我一般会先统计一下资源总量python3 -c import json,sys; datajson.load(open(assets_info.json)); print(len(data))这样操作起来心里有数。3.2 按条件提取具体资源assetutil提取资源不是按名字来的而是按资源属性组合来筛选。它支持--idiom、--scale、--display-gamut等过滤参数组合起来会把匹配的所有资源一起导出。比如我想导出所有iPhone 2x、sRGB色域的资源命令是这样mkdir -p extracted xcrun --sdk iphoneos assetutil \ --idiom iphone \ --scale 2x \ --display-gamut srgb \ Assets.car \ --output extracted执行完extracted目录里就会出现一堆文件。这里要注意导出文件的名字不一定等于开发时的资源名assetutil会根据资源属性、名称等自动生成文件名。不同Xcode版本生成规则略有差异所以不要指望导出来就是“icon.png”这种直白的命名。如果命令执行完extracted目录是空的最常见的可能就是你写的过滤条件跟资源实际属性不匹配。回头打开assets_info.json挑一条记录看它的Idiom、Scale、DisplayGamut到底写的什么照着填。3.3 批量导出全部图片脚本化才是正解手动按组合去提取一次只能导出一类。一个App的Assets.car里Idiom、Scale、DisplayGamut的组合可能有几十种手动跑太蠢了。我的做法是先解析--info输出的JSON把里面Image资源的属性组合去重然后循环调用assetutil。下面这个Python脚本可以直接用#!/usr/bin/env python3 import json import os import subprocess import sys from collections import OrderedDict if len(sys.argv) ! 3: print(Usage: extract_assets.py Assets.car output_dir) sys.exit(1) car_file, output_dir sys.argv[1], sys.argv[2] os.makedirs(output_dir, exist_okTrue) info_text subprocess.check_output( [xcrun, --sdk, iphoneos, assetutil, --info, car_file], textTrue, ) assets json.loads(info_text) combos OrderedDict() for item in assets: if item.get(AssetType) ! Image: continue key ( item.get(Idiom, universal), str(item.get(Scale, 1)), item.get(DisplayGamut, srgb), ) combos.setdefault(key, []).append(item.get(Name, )) for (idiom, scale, gamut), names in combos.items(): scale_arg f{scale}x print(fextracting idiom{idiom} scale{scale_arg} gamut{gamut} count{len(names)}) cmd [ xcrun, --sdk, iphoneos, assetutil, --idiom, idiom, --scale, scale_arg, --display-gamut, gamut, car_file, --output, output_dir, ] subprocess.run(cmd, checkFalse)用法python3 extract_assets.py /path/to/Assets.car /path/to/extracted这个脚本会遍历所有Image资源的属性组合把匹配的图片全部导出。核心逻辑就是先读info再按组合去跑assetutil。比起手动按一次参数跑一遍效率提升非常明显。脚本里如果某些资源带了特殊字段导致提取失败先把报错信息发出来对照info里的记录调整过滤条件即可。3.4 导出文件的后续处理脚本导出的文件经常没有扩展名后缀可能是一串编码直接看根本不知道是什么格式。这种情况下用file命令批量识别类型是首选cd extracted file * | head -20识别出是PNG或者JPEG之后可以批量补扩展名。在macOS上可以用sips来转换和读取图片信息for f in extracted/*; do sips -g pixelWidth -g pixelHeight $f 2/dev/null | head -3 echo --- done如果需要把资源归档给设计师建议根据assets_info.json里的Name字段重命名。做法是先通过脚本把每个导出文件与info里的Name对应起来按用途建目录。不过要注意一个Name可能对应多张不同scale的图片命名时把scale加进去更合理。注意assets_info.json里的Name就是开发者在Assets.xcassets里填的名字这套命名在编译后仍然会保留在元数据里。对资源、找资源、核对资源都靠它。4. 实操中的坑与排查4.1 assetutil报错unsupported asset catalog version这是最常见的报错之一尤其是在老版本macOS上处理用新版Xcode编译的包。car文件有版本号工具支持范围不够时就报这个错。解决办法升级Xcode或单独更新Command Line Tools。在终端执行xcode-select --install如果已经安装了最新版Xcode确认一下当前激活的工具链xcode-select -p输出路径应该指向新版Xcode的Contents/Developer。如果指向老版本用sudo xcode-select -switch切换。4.2 AppIcon怎么都导不全AppIcon在Assets.car里通常也是Image类型但它有几套不同尺寸和倍数的组合。比如iPhone上可能需要2x和3x两套iPad上又有一组加上设置图标、通知图标组合很多。处理办法是先单独看info里AppIcon相关记录python3 -c import json data json.load(open(assets_info.json)) for item in data: if AppIcon in item.get(Name, ): print(item.get(Name), item.get(Idiom), item.get(Scale), item.get(DisplayGamut)) 然后把每一套组合都跑一遍或者直接用前面那个批量导出脚本跑全量。AppIcon导出的文件名通常会带icon字样耐心对照即可。4.3 资源名称和工程里的名字对不上有时候你想找某张叫“home_banner”的图info里也确实有这个Name但导出的文件名看起来跟它毫无关系。这是assetutil的输出策略导致的它会在原Name基础上附加一些描述信息具体规则不同Xcode版本有差异。这时候最靠谱的办法是用sips读每张导出图片的尺寸、格式再回看info里的Width、Height、Scale字段反向定位。图片多的话我建议写个小脚本把info里的Name、尺寸和导出文件做个映射表自己维护命名关系。4.4 中文文件名与解压乱码问题在Linux或Windows上解压ipa经常会看到乱码文件名。这是zip格式的编码老问题。如果你必须在这两个平台上处理可以在Linux上尝试用unzip的-O参数指定字符集或者用7z解压。但我的建议是处理ipa资源优先在macOS上做。用ditto解压基本不会遇到中文乱码问题。跨平台传文件时也要注意压缩时选择zip而不是其他格式避免二次转码。4.5 其他提取工具值不值得用第三方工具里有些人会推荐Asset Catalog Tinkerer这类GUI软件。它们确实能可视化浏览资源适合不想敲命令的人。但问题也很明显对新版Assets.car格式支持往往滞后而且只能看自动化能力弱。如果你只是临时看一两张图GUI工具可以试试。如果你要经常处理包、写脚本、自动核对资源assetutil才是真正能依靠的。它是苹果官方命令行工具格式支持跟随Xcode更新还能配合脚本做批量处理这才是长期方案。4.6 常见问题速查表现象可能原因解决办法assetutil报unsupported asset catalog version工具链版本落后升级Xcode Command Line Tools并切换激活版本--info输出为空Assets.car路径不对或不是car文件用find全盘搜索file确认文件类型导出目录为空过滤参数跟资源属性不匹配对照info里的Idiom、Scale、DisplayGamut重试解压出现乱码zip编码问题在macOS上用ditto解压或指定字符集找不到AppIconAppIcon组合太多没导全单独筛选AppIcon的所有组合导出文件名看不懂assetutil的命名规则导致用sips读尺寸对照info定位5. 把流程封装成自己的工具箱如果你只是偶尔处理一次手动敲命令就够了。但如果你要经常核对线上包的资源、给设计侧提供素材、或者做包体分析我建议把整个流程封装成一个脚本输入是ipa路径和输出目录脚本自动完成解压、定位car、导出资源、生成info索引一条命令出结果。我自己的封装思路是这样的第一步用ditto把ipa解压到临时目录第二步find提取所有car文件路径第三步逐个car执行assetutil --info并保存JSON第四步按3.3节的批量脚本把所有资源导出最后输出一份汇总文件包含car文件位置、资源总量、Name列表和导出目录。这样一套下来一个包的资源分析时间从半小时压缩到两分钟以内。配合md5比对还能快速判断两个安装包之间的资源有没有变化哪个图被替换过一目了然。这套流程我用了很长时间稳定可靠。最后再分享一个个人经验assetutil导出资源时别急着把所有组合都跑完先看一遍info确认这个包的重点资源是什么。是AppIcon是启动图还是某张运营位图片。确认之后再决定按什么组合提取。这样既省时间又不容易在一堆导出文件里迷失方向。

ipa包内Assets.car资源导出：assetutil命令实战教程

相关推荐

StarRocks count_if 条件聚合函数：语法、返回语义与 FE 源码级改写机制解析

Django项目部署实战：从开发到生产的完整指南

webnovel-writer 网文节奏审查指南：信息密度标准、灌水诊断与快节奏写法实战

更多资讯

RuoYi-SpringBoot3-Pro集成Magic API实战指南

Redis Search实战：千万级实时搜索为何比Elasticsearch快5倍

Linux 安装 VS Code 与项目运行配置全指南

用python-pptx解析PPTX：SMART目标校验与任务排期巡检

工控现货采购实战拆解：从渠道分辨到国产平台落地

RK3568 USB鼠标驱动开发实战：从HID协议到设备树全链路解析

今日更新

AWS无服务器应用开发指南：从Lambda到SAM的架构与实践

SpringBoot+Vue人事系统实战：解决HR数据断点与事务一致性

MATLAB手写紧束缚模型计算石墨烯能带结构

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？