为何Xcode资源中PDF/SVG会无端增大IPA安装包体积？

在Xcode 14.1中，将PDF（或SVG）文件添加到Assets资源库，已勾选「Preserve Vector Data」并设置「Scales」为「Single Scale」，但导出Ad Hoc包后，发现Assets.car中仍包含冗余的PNG位图文件，导致IPA体积增大——仅需保留矢量文件即可，冗余PNG属于无意义的体积占用，SVG文件也存在相同问题。

复现步骤 #

• 将PDF文件添加至Assets资源库，在属性检查器中勾选「Preserve Vector Data」，设置「Scales」为「Single Scale」。
• 执行Xcode→Product→Archive操作。
• 按照苹果官方指引选择「Distribute App」→Ad Hoc→App Thinning：「All compatible device variants」→下一步→自动管理签名→导出。
• 在导出文件夹的「Apps」子目录中选择非通用版IPA，解压后找到Assets.car文件。
• 执行命令 xcrun --sdk iphoneos assetutil --info Assets.car，输出显示Assets.car中包含1个PDF矢量文件和2个不同Scale的PNG位图文件。

原因分析 #

1. 兼容性降级逻辑：Xcode会自动为不支持矢量直接渲染的旧iOS版本（如iOS 10及以下）预渲染位图作为降级方案，即使你仅针对新版本打包，该逻辑仍可能被触发。
2. Asset Catalog默认行为：设置「Scales」为「Single Scale」时，Xcode仍可能基于通用Scale（@1x、@2x、@3x）生成预渲染位图，尤其是选择「All compatible device variants」进行App Thinning时，打包流程会默认包含适配不同设备的资源。
3. SVG/PDF的转换特性：SVG在iOS中需通过UIKit间接渲染，Xcode会先将其转换为PDF，再触发位图预渲染逻辑，同样产生冗余文件。

解决方案 #

1. 调整Asset Catalog构建配置 #

在项目Build Settings中，找到「Asset Catalog Compiler Options」：

• 将「Vector Rendering」设置为「Automatic」或「Always」
• 将「Pre-rendered Vector Assets」设置为「No」

2. 手动加载PDF资源（绕过Asset Catalog自动处理） #

将PDF直接添加到项目中（而非Assets库），通过代码直接渲染矢量内容，完全避免冗余位图生成：

func loadVectorPDF(named name: String) -> UIImage? {
    guard let url = Bundle.main.url(forResource: name, withExtension: "pdf") else { return nil }
    guard let document = CGPDFDocument(url as CFURL) else { return nil }
    guard let page = document.page(at: 1) else { return nil }
    
    let pageRect = page.getBoxRect(.mediaBox)
    let renderer = UIGraphicsImageRenderer(size: pageRect.size)
    return renderer.image { context in
        UIColor.clear.setFill()
        context.fill(pageRect)
        context.cgContext.translateBy(x: 0, y: pageRect.size.height)
        context.cgContext.scaleBy(x: 1.0, y: -1.0)
        context.cgContext.drawPDFPage(page)
    }
}

3. 优化App Thinning打包选项 #

分发时选择「Specific device variants」而非「All compatible device variants」，仅针对目标设备类型打包，减少不必要的资源生成。

4. 手动清理Assets.car中的冗余资源 #

导出IPA后，通过assetutil工具重新打包Assets.car，移除PNG文件：

# 导出Assets.car资源到临时目录
xcrun --sdk iphoneos assetutil --extract ./temp Assets.car
# 删除临时目录中的PNG文件
rm ./temp/*.png
# 重新打包生成精简后的Assets.car
xcrun --sdk iphoneos assetutil --output NewAssets.car ./temp

替换IPA中原Assets.car文件后，重新签名打包即可。

内容的提问来源于stack exchange，提问作者Jirui