Action Extension在iPhone正常运行但iPad无法使用问题求助

问题概述 #

原iPhone应用的Action Extension在iPhone上运行正常，添加iPad为目标设备后，主应用可正常启动，但Extension无法工作，报错如下：

Error:
-[_EXSinkLoadOperator loadItemForTypeIdentifier:completionHandler:expectedValueClass:options:] nil expectedValueClass allowing {(
     NSURL,
     NSDictionary
     _EXItemProviderSandboxedResource,
     NSUUID,
     NSDate,
     NSArray,
     NSData,
     NSString,
     NSNumber
     NSError
     UIImage,
     NSValue
)}

错误触发点为调用itemProvider.loadItem(forTypeIdentifier: typeImage, options: nil)的代码位置，且存在以下现象：

• 真机iPad完全无法运行Extension
• iPad模拟器首次运行可唤起主应用，但二次尝试失败
• 测试环境：iOS17.2、Xcode15.2，涉及iPad 6/9/10、iPad Air 6模拟器及iPad 6真机

核心原因 #

iOS17在iPad平台对NSItemProvider的加载逻辑做了更严格的校验，默认调用loadItem(forTypeIdentifier:options:)时未明确指定expectedValueClass，导致系统无法确定期望的返回类型，触发类型匹配或权限类错误；同时旧API在iPad沙盒环境下存在兼容性问题。

解决方案 #

1. 明确指定期望的ValueClass #

替换原loadItem调用，使用带expectedValueClass参数的重载方法，明确告知系统期望的返回类型为UIImage：

if itemProvider.hasItemConformingToTypeIdentifier(typeImage) {
    itemProvider.loadItem(forTypeIdentifier: typeImage, expectedValueClass: UIImage.self, options: nil) { item, error in
        // 原处理逻辑
    }
}

2. 适配iOS17新API（推荐） #

使用iOS14+引入的loadTransferable(type:)替代旧的loadItem方法，该方法类型更安全，且在iOS17上兼容性更好：

if itemProvider.canLoadObject(ofClass: UIImage.self) {
    itemProvider.loadTransferable(type: UIImage.self) { result in
        switch result {
        case .success(let image):
            guard let image = image else {
                // 处理空值逻辑
                return
            }
            // 处理图片逻辑
        case .failure(let error):
            // 处理错误逻辑
            print("加载图片失败：\(error)")
        }
    }
}

3. 检查Extension的Info.plist配置 #

确保NSExtension下的NSExtensionActivationRule配置正确，针对iPad设备添加合适的激活规则，比如支持图片类型的配置：

<key>NSExtensionActivationRule</key>
<dict>
    <key>NSExtensionActivationSupportsImageWithMaxCount</key>
    <integer>1</integer>
    <key>NSExtensionActivationSupportsText</key>
    <false/>
    <!-- 根据需求添加其他支持的类型 -->
</dict>

4. 清理构建缓存 #

• 清理Xcode的Derived Data：Xcode > Settings > Locations > Derived Data > 点击箭头打开文件夹后删除对应项目的缓存
• 重启Xcode和模拟器/真机
• 执行Product > Clean Build Folder

5. 验证沙盒权限 #

在Extension的Info.plist中添加必要的权限描述（如访问照片），确保在iPad上能获取到资源访问权限：

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问照片以处理图片</string>

内容的提问来源于stack exchange，提问作者Анатолий