iOS8 Day-by-Day项目解析：深入理解Photo Extension开发

薛珑佳

于 2025-06-24 09:08:15 发布

阅读量309

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00632/article/details/148862430

iOS8 Day-by-Day项目解析：深入理解Photo Extension开发

iOS8-day-by-day Selection of projects accompanying the iOS8-Day-by-Day blog series 项目地址: https://gitcode.com/gh_mirrors/io/iOS8-day-by-day

前言

在iOS8中，苹果引入了扩展(Extension)的概念，允许开发者创建功能模块来增强系统原生应用的能力。Photo Extension（照片扩展）就是其中一种强大的扩展类型，它能让开发者将自己的图像处理功能直接集成到系统相册应用中。本文将基于ScottLogic/iOS8-day-by-day项目中的Photo Extension实现，深入解析其开发要点。

Photo Extension基础概念

Photo Extension是一种特殊的应用扩展，它允许开发者：

为系统相册应用添加自定义的图像编辑功能
提供交互式的编辑界面
支持编辑操作的撤销与重做
保持编辑历史记录

当用户在相册中选择一张照片并点击编辑按钮时，系统会显示所有已安装的Photo Extension，用户可以选择使用你的扩展来处理照片。

创建Photo Extension项目

在Xcode中创建Photo Extension非常简单：

新建一个Target
选择"Application Extension"下的"Photo Editing Extension"模板

这个模板会自动创建一个继承自UIViewController并遵循PHContentEditingController协议的视图控制器类。这个协议定义了Photo Extension的生命周期方法。

核心组件解析

1. PHContentEditingController协议

这是Photo Extension的核心协议，包含以下关键方法：

startContentEditingWithInput(_:placeholderImage:)：开始编辑时调用
finishContentEditingWithCompletionHandler(_:)：完成编辑时调用
cancelContentEditing()：取消编辑时调用
shouldShowCancelConfirmation：决定是否显示取消确认对话框

2. 图像处理流程

Photo Extension处理图像分为三个阶段：

初始阶段：使用displaySizeImage进行交互式预览
编辑阶段：用户通过UI调整参数，实时预览效果
最终处理阶段：使用fullSizeImageURL处理原始图像

实现细节详解

1. 初始化编辑界面

func startContentEditingWithInput(contentEditingInput: PHContentEditingInput?, 
                                placeholderImage: UIImage) {
    // 保存输入对象
    input = contentEditingInput
    
    // 使用适合屏幕尺寸的图像初始化滤镜
    filter.inputImage = CIImage(image: input?.displaySizeImage)
    
    // 初始化UI控件状态
    thresholdSlider.value = filter.threshold
    
    // 更新输出图像
    updateOutputImage()
}

这里的关键点是使用displaySizeImage而非原始图像进行交互式编辑，这能保证编辑过程的流畅性。

2. 实时图像处理

private func updateOutputImage() {
    // 更新滤镜参数
    filter.threshold = thresholdSlider.value
    
    // 获取处理后的图像并渲染
    if let outputImage = filter.outputImage {
        glRenderer?.renderImage(outputImage)
    }
    
    // 标记已修改
    includesChanges = true
}

为了获得最佳性能，示例中使用OpenGL ES来渲染处理后的图像，避免了CPU和GPU之间的数据拷贝。

3. 完成编辑处理

func finishContentEditingWithCompletionHandler(completionHandler: ((PHContentEditingOutput!) -> Void)!) {
    // 禁用UI
    thresholdSlider.enabled = false
    
    // 在后台队列处理高分辨率图像
    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0)) {
        // 创建输出对象
        let output = PHContentEditingOutput(contentEditingInput: self.input)
        
        // 处理全尺寸图像
        let fullSizeImage = CIImage(contentsOfURL: self.input?.fullSizeImageURL)
        self.filter.inputImage = fullSizeImage
        
        // 渲染最终图像
        UIGraphicsBeginImageContext(fullSizeImage.extent().size)
        UIImage(CIImage: self.filter.outputImage!)!.drawInRect(fullSizeImage.extent())
        let outputImage = UIGraphicsGetImageFromCurrentImageContext()
        let jpegData = UIImageJPEGRepresentation(outputImage, 1.0)
        UIGraphicsEndImageContext()
        
        // 保存处理结果
        jpegData.writeToURL(output.renderedContentURL, atomically: true)
        
        // 保存调整数据
        let adjustmentData = PHAdjustmentData(
            formatIdentifier: self.formatIdentifier,
            formatVersion: self.formatVersion,
            data: self.filter.encodeFilterParameters())
        output.adjustmentData = adjustmentData
        
        // 完成处理
        completionHandler(output)
    }
}

4. 支持可恢复编辑

为了实现编辑历史的重现，需要实现：

调整数据(Adjustment Data)：保存编辑参数
版本控制：确保兼容性

func canHandleAdjustmentData(adjustmentData: PHAdjustmentData?) -> Bool {
    return adjustmentData?.formatIdentifier == formatIdentifier &&
           adjustmentData?.formatVersion == formatVersion
}