为生成的UIImage添加CGImageProperties/元数据失败求助

问题诊断 #

1. PNG格式的元数据限制：你使用UIImagePNGRepresentation生成PNG图片，而GPS相关属性（如kCGImagePropertyGPSLongitudeRef）属于EXIF元数据规范，PNG格式本身并不原生支持这类EXIF字段。iOS的CGImageDestination在处理PNG时会忽略非PNG标准的元数据键，导致你添加的属性无法被写入。
2. 代码笔误：最后一行创建UIImage的代码有误，正确写法应为[UIImage imageWithData:updatedData]，不过这不是核心问题，但会导致你无法正确获取带元数据的图片对象。

可行解决方案 #

方案1：改用JPEG格式保存（推荐，原生支持EXIF元数据）

JPEG格式原生支持EXIF元数据，包括可存储长文本的字段，适合存放调试信息：

// 替换PNG为JPEG生成图片数据
NSData *imageData = UIImageJPEGRepresentation(image, 0.9);

// 将调试数组转成JSON字符串（也可直接存NSString）
NSArray *debugArray = @[@"视图ID:1001", @"frame:(0,0,1059,132)", @"调试时间:2024-05-20"];
NSError *jsonError;
NSData *debugJsonData = [NSJSONSerialization dataWithJSONObject:debugArray options:0 error:&jsonError];
NSString *debugStr = [[NSString alloc] initWithData:debugJsonData encoding:NSUTF8StringEncoding];

// 构造Exif属性，使用UserComment字段存储自定义信息
NSDictionary *exifProps = @{(NSString *)kCGImagePropertyExifUserComment: debugStr};
NSDictionary *metaProps = @{(NSString *)kCGImagePropertyExifDictionary: exifProps};

// 写入元数据
CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)imageData, NULL);
CFStringRef UTI = CGImageSourceGetType(source);
NSMutableData *updatedData = [NSMutableData data];
CGImageDestinationRef destination = CGImageDestinationCreateWithData((__bridge CFMutableDataRef)updatedData, UTI, 1, NULL);
CGImageDestinationAddImageFromSource(destination, source, 0, (__bridge CFDictionaryRef)metaProps);
CGImageDestinationFinalize(destination);

// 释放资源
CFRelease(destination);
CFRelease(source);

// 获取带元数据的图片并保存到磁盘
UIImage *imageWithProperties = [UIImage imageWithData:updatedData];
[updatedData writeToFile:@"/path/to/debug_image.jpg" atomically:YES];

读取时，通过CGImageSourceCopyProperties获取Exif字典中的kCGImagePropertyExifUserComment字段，再转回NSArray即可。

方案2：给PNG添加合规的自定义元数据

如果必须使用PNG格式，可利用PNG规范支持的文本字段（如kCGImagePropertyPNGDescription）存储调试信息：

NSData *imageData = UIImagePNGRepresentation(image);

// 构造PNG专属元数据
NSString *debugInfo = @"布局调试：导航栏高度异常，当前高度132px";
NSDictionary *pngProps = @{(NSString *)kCGImagePropertyPNGDescription: debugInfo};
NSDictionary *metaProps = @{(NSString *)kCGImagePropertyPNGDictionary: pngProps};

// 后续写入流程与方案1一致
CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)imageData, NULL);
CFStringRef UTI = CGImageSourceGetType(source);
NSMutableData *updatedData = [NSMutableData data];
CGImageDestinationRef destination = CGImageDestinationCreateWithData((__bridge CFMutableDataRef)updatedData, UTI, 1, NULL);
CGImageDestinationAddImageFromSource(destination, source, 0, (__bridge CFDictionaryRef)metaProps);
CGImageDestinationFinalize(destination);

CFRelease(destination);
CFRelease(source);

UIImage *imageWithProperties = [UIImage imageWithData:updatedData];
[updatedData writeToFile:@"/path/to/debug_image.png" atomically:YES];

读取时从图片属性的{PNG}字典中提取Description字段即可。

方案3：利用文件扩展属性存储元数据（与图片格式无关）

如果不需要将元数据嵌入图片本身，而是和图片文件关联，可使用文件系统的扩展属性，支持存储任意NSData类型的数据：

// 先将图片保存到磁盘
NSString *imagePath = @"/path/to/debug_image.png";
[UIImagePNGRepresentation(image) writeToFile:imagePath atomically:YES];

// 存储调试元数据（数组转JSON）
NSArray *debugArray = @[@"异常类型:布局偏移", @"关联视图:UITabBar", @"偏移量:10px"];
NSError *error;
NSData *metaData = [NSJSONSerialization dataWithJSONObject:debugArray options:0 error:&error];
if (!error) {
    [[NSFileManager defaultManager] setExtendedAttribute:@"com.yourapp.debug.metadata" 
                                                   value:metaData 
                                                     path:imagePath 
                                                      error:&error];
}

// 读取元数据
NSData *readMeta = [[NSFileManager defaultManager] extendedAttribute:@"com.yourapp.debug.metadata" 
                                                                 path:imagePath 
                                                                  error:&error];
if (readMeta) {
    NSArray *readDebugArray = [NSJSONSerialization JSONObjectWithData:readMeta options:0 error:&error];
}

该方案完全不受图片格式限制，适合批量处理截图时关联调试信息。

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