iOS AppIntent能否返回应用沙箱内文件URL？真机适配问题咨询

要在真机上实现沙箱文件URL跨快捷指令传递，需要补充权限配置并使用安全范围书签绕过沙箱隔离限制，具体步骤如下：

1. 添加文件访问权限 #

在应用的entitlements文件中添加com.apple.security.files.user-selected.read-write权限，这是跨应用传递沙箱文件的必要配置：

<key>com.apple.security.files.user-selected.read-write</key>
<true/>

2. 使用安全范围书签传递文件 #

真机上的沙箱隔离机制会拦截直接传递的原始沙箱URL，必须将URL转换为**安全范围书签（Security-Scoped Bookmarks）**后再传递，接收方通过解析书签获取可访问的URL。

示例代码 #

import AppIntents
import Foundation

// 自定义Intent，用于返回带书签的文件实体
struct GetSandboxFileIntent: AppIntent {
    static var title: LocalizedStringResource = "获取沙箱文件"
    
    func perform() async throws -> some IntentResult {
        // 获取Documents目录下的目标文件URL
        guard let targetURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
                .first?.appendingPathComponent("example.txt") else {
            throw IntentError(message: "文件不存在")
        }
        
        // 生成安全范围书签数据
        let bookmarkData = try targetURL.bookmarkData(
            options: .withSecurityScope,
            includingResourceValuesForKeys: nil,
            relativeTo: nil
        )
        
        return .result(value: SandboxFileEntity(bookmarkData: bookmarkData))
    }
}

// 实现AppEntity和Transferable协议的文件实体
struct SandboxFileEntity: AppEntity, Transferable {
    static var typeDisplayRepresentation: TypeDisplayRepresentation = "沙箱文件"
    
    let bookmarkData: Data
    
    // Transferable协议实现，用于快捷指令间传递
    static var transferRepresentation: some TransferRepresentation {
        DataRepresentation(exportedContentType: .data) { entity in
            entity.bookmarkData
        } importing: { data in
            try SandboxFileEntity(bookmarkData: data)
        }
    }
    
    // 解析书签获取可访问的URL
    func resolveAccessibleURL() throws -> URL {
        var isBookmarkStale = false
        let resolvedURL = try URL(
            resolvingBookmarkData: bookmarkData,
            options: .withSecurityScope,
            relativeTo: nil,
            bookmarkDataIsStale: &isBookmarkStale
        )
        
        // 书签过期时重新生成（可选）
        if isBookmarkStale {
            let updatedBookmark = try resolvedURL.bookmarkData(
                options: .withSecurityScope,
                includingResourceValuesForKeys: nil,
                relativeTo: nil
            )
            // 这里可以更新本地存储的书签数据
        }
        
        // 开始访问沙箱文件
        resolvedURL.startAccessingSecurityScopedResource()
        defer {
            // 访问结束后必须释放资源
            resolvedURL.stopAccessingSecurityScopedResource()
        }
        
        return resolvedURL
    }
}

// 自定义Intent错误
enum IntentError: Error, CustomStringConvertible {
    case message(String)
    
    var description: String {
        switch self {
        case .message(let msg): return msg
        }
    }
}

3. 关键注意事项 #

• 访问解析后的URL时，必须调用startAccessingSecurityScopedResource()，使用完成后务必调用stopAccessingSecurityScopedResource()，避免资源泄漏
• UIFileSharingEnabled和LSSupportsOpeningDocumentsInPlace仅用于Files应用访问你的应用文件，和快捷指令间的URL传递无关，之前的配置无法解决问题
• 不能直接返回原始沙箱URL作为IntentResult，真机上系统会直接拒绝跨应用访问

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