iOS Widget使用AppIntent调用UIPasteboard真机失效求助

我开发了一款通过AppIntent实现账号复制功能的Widget，该功能在Xcode模拟器上运行正常，能将账号复制到短信、备忘录、Safari等应用，但在真机设备上完全无法实现复制功能。调试时出现以下错误：

...retrieving pasteboard named com.apple.UIKit.pboard.general failed with error: Error Domain=PBErrorDomain Code=10 UserInfo={NSLocalizedDescription=}
...saving pasteboard failed with error: Error Domain=PBErrorDomain Code=11 UserInfo={NSLocalizedDescription=}

以下是实现复制功能的AppIntent代码：

import AppIntents
import Foundation
import SwiftUI
import UIKit

@available(iOSApplicationExtension 16, *)
struct CopyAccountNumberIntent: AppIntent {
    static var title: LocalizedStringResource = "Copy Account Number"
    private let appGroupID: String = "appname.com"

    func perform() async throws -> some ReturnsValue<String> {
        let defaults: UserDefaults? = UserDefaults(suiteName: appGroupID)
        if let accountNumber: String = defaults?.string(forKey: "accountNumber"),
           let accountName: String = defaults?.string(forKey: "accountName") {
            let pasteboard: String = "\(accountNumber)\n\(accountName)"
            UIPasteboard.general.string = pasteboard
            return .result(value: pasteboard)
        } else {
            print("Button No account number found")
            return .result(value: "")
        }
    }
}

问题原因与解决办法 #

1. 核心原因：Widget扩展的剪贴板权限限制 #

iOS的Widget属于应用扩展，出于隐私安全的沙箱规则，扩展无法直接访问UIPasteboard.general，这就是真机抛出PBErrorDomain Code10（无法获取剪贴板）和Code11（无法写入剪贴板）的根本原因。模拟器权限限制宽松，所以能正常运行，但真机严格遵循系统规则。

2. 正确实现：使用AppIntent专属剪贴板API #

从iOS 16开始，AppIntent提供了适配扩展场景的剪贴板操作API，替代原生UIPasteboard。修改后的代码如下：

import AppIntents
import Foundation
import SwiftUI

@available(iOSApplicationExtension 16, *)
struct CopyAccountNumberIntent: AppIntent {
    static var title: LocalizedStringResource = "Copy Account Number"
    private let appGroupID: String = "appname.com"

    func perform() async throws -> some ReturnsValue<String> & ProvidesDialog {
        let defaults = UserDefaults(suiteName: appGroupID)
        guard let accountNumber = defaults?.string(forKey: "accountNumber"),
              let accountName = defaults?.string(forKey: "accountName") else {
            print("No account number found")
            return .result(value: "")
                .dialog("未找到账号信息")
        }
        
        let pasteboardContent = "\(accountNumber)\n\(accountName)"
        // 使用AppIntent剪贴板API完成复制
        try await Pasteboard.copy(pasteboardContent)
        
        return .result(value: pasteboardContent)
            .dialog("账号已复制到剪贴板")
    }
}

3. 额外验证项 #

• 确认Widget扩展已正确配置App Groups能力，且appGroupID与主应用完全一致，保证UserDefaults能正常读取账号数据。
• 必须使用真机测试，模拟器的权限逻辑与真机存在差异，不能作为最终验证标准。

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