如何在Xcode/SwiftUI项目中添加PNG文件模拟下载及获取原始字节

一、直接拖入图片到Xcode项目的方法 #

完全可以直接将Finder里的PNG图片拖入Xcode项目，步骤如下：

• 打开Xcode项目，找到左侧的项目导航栏（Project Navigator）
• 从Finder选中目标PNG图片，直接拖到导航栏的合适位置（建议新建一个TestImages文件夹归类，避免和Assets混淆）
• 拖入时弹出的选项框里，务必勾选：
  • "Copy items if needed"：确保文件被复制到项目目录，而非仅引用外部文件
  • 你的主目标（Target）：让Xcode把这个文件打包到App bundle中

二、为什么不推荐用Assets存储测试用的原始图片？ #

Assets中的图片会被Xcode自动优化（比如压缩、转格式），且从Assets读取的是UIImage/Image对象，不是原始的PNG字节流，和真实下载场景（下载的是原始二进制数据）完全不符。因此要模拟下载后存储的流程，直接把原始PNG文件放到项目bundle里更贴近真实场景。

三、获取bundle中图片原始字节的代码示例 #

1. 读取原始字节的工具方法 #

func getTestPNGRawData() -> Data? {
    guard let fileURL = Bundle.main.url(forResource: "testImage", withExtension: "png") else {
        print("找不到目标图片文件")
        return nil
    }
    do {
        let rawData = try Data(contentsOf: fileURL)
        return rawData
    } catch {
        print("读取图片字节失败：\(error.localizedDescription)")
        return nil
    }
}

2. 在SwiftUI中模拟下载存储流程 #

struct ContentView: View {
    @State private var storedImageData: Data?
    
    var body: some View {
        VStack {
            if let data = storedImageData, let uiImage = UIImage(data: data) {
                Image(uiImage: uiImage)
                    .resizable()
                    .scaledToFit()
                    .frame(width: 200, height: 200)
            }
            
            Button("模拟下载并存储") {
                guard let rawData = getTestPNGRawData() else { return }
                // 模拟存储到Documents目录
                let documentsDir = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
                let saveURL = documentsDir.appending(path: "downloadedImage.png")
                do {
                    try rawData.write(to: saveURL)
                    storedImageData = rawData
                    print("图片已存储到：\(saveURL.path)")
                } catch {
                    print("存储失败：\(error.localizedDescription)")
                }
            }
            .padding()
            .background(Color.blue)
            .foregroundColor(.white)
            .cornerRadius(8)
        }
        .padding()
    }
}

四、注意事项 #

• 拖入的图片文件名不要包含特殊字符，避免读取时出现路径错误
• 批量测试多张图片时，建议在项目内新建专门文件夹管理，便于维护
• 读取bundle文件时，forResource参数要和图片文件名完全一致（不含扩展名），withExtension填写png

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