MacOS SwiftUI应用无法正常触发Photos权限流程问题

问题描述 #

开发MacOS SwiftUI应用时，已在Info.plist配置Photos权限相关字段，且在Sandbox中开启文件访问权限，但应用请求Photos权限后，未出现在系统偏好设置→隐私与安全性→Photos板块中，即使代码能获取权限状态，系统设置里也看不到应用。

用户实现的代码如下：

struct PhotosPermissionView: View {
    @State private var authorizationStatus: PHAuthorizationStatus = .notDetermined
    @State private var logMessage: String = "Waiting for user action..."

    var body: some View {
        VStack(spacing: 20) {
            Text("Photos Permission")
                .font(.largeTitle)
                .padding()

            if authorizationStatus == .authorized || authorizationStatus == .limited {
                Text("Access to Photos Library granted!")
                    .foregroundColor(.green)
                Text(logMessage)
                    .font(.caption)
                    .foregroundColor(.gray)
                Button("Fetch Photos Library") {
                    fetchPhotosLibrary()
                }
                .buttonStyle(.borderedProminent)
            } else if authorizationStatus == .denied || authorizationStatus == .restricted {
                Text("Access to Photos Library denied.")
                    .foregroundColor(.red)
                Text("You can enable access in System Preferences.")
                    .font(.caption)
                    .foregroundColor(.gray)
            } else {
                Text("Permission to access Photos is not yet determined.")
                    .foregroundColor(.orange)
                Button("Request Access") {
                    requestPhotosPermissionAndTriggerUI()
                }
                .buttonStyle(.borderedProminent)
            }
        }
        .padding()
        .onAppear {
            checkPhotosAuthorizationStatus()
        }
    }

    /// Check the current Photos authorization status
    private func checkPhotosAuthorizationStatus() {
        authorizationStatus = PHPhotoLibrary.authorizationStatus(for: .readWrite)
        logMessage = "Current Photos authorization status: \(authorizationStatus.rawValue)"
        print(logMessage)
    }

    /// Request Photos permission and trigger the UI by accessing the library
    private func requestPhotosPermissionAndTriggerUI() {
        print("Requesting Photos permission...")

        // Request authorization
        PHPhotoLibrary.requestAuthorization(for: .readWrite) { status in
            DispatchQueue.main.async {
                authorizationStatus = status
                logMessage = "Authorization status after request: \(status.rawValue)"
                print(logMessage)

                if status == .authorized || status == .limited {
                    print("Access granted. Attempting to trigger Photos UI...")
                    self.fetchPhotosLibrary() // Trigger Photos Library access
                }
            }
        }
    }

    /// Attempt to access the Photos Library to trigger system behavior
    private func fetchPhotosLibrary() {
        let fetchOptions = PHFetchOptions()
        fetchOptions.fetchLimit = 1
        let fetchResult = PHAsset.fetchAssets(with: .image, options: fetchOptions)
        logMessage = "Fetched \(fetchResult.count) assets from the Photos Library."
        print(logMessage)
    }
}

解决方案 #

1. 确认Info.plist权限字段配置 #

MacOS下必须配置以下两个字段（描述内容不能为空）：

• NSPhotoLibraryUsageDescription：说明应用访问图库的用途，例如"需要访问您的照片库以展示和管理图片"
• NSPhotoLibraryAddUsageDescription：若应用需要写入照片，必须添加；即使仅申请读权限，部分MacOS版本也要求配置该字段

确保字段名拼写完全正确，否则系统不会识别权限请求。

2. 触发实际的图库访问操作 #

MacOS需要应用在权限请求后执行实际的图库访问操作，才能让系统在隐私设置中显示应用。修改requestPhotosPermissionAndTriggerUI方法：

private func requestPhotosPermissionAndTriggerUI() {
    print("Requesting Photos permission...")

    PHPhotoLibrary.requestAuthorization(for: .readWrite) { status in
        DispatchQueue.main.async {
            self.authorizationStatus = status
            self.logMessage = "Authorization status after request: \(status.rawValue)"
            print(self.logMessage)

            if status == .authorized || status == .limited {
                // 触发相册列表获取，强制系统在设置中注册应用
                let albums = PHAssetCollection.fetchAssetCollections(with: .album, subtype: .any, options: nil)
                self.logMessage = "Fetched \(albums.count) albums from Photos Library."
                print(self.logMessage)
            }
        }
    }
}

3. 检查Sandbox权限配置 #

在Xcode的Signing & Capabilities→App Sandbox中，确保勾选的是**"Photos Library"权限**（选择Read Access或Read/Write Access），不要仅依赖普通的文件访问权限。

4. 重置应用权限缓存 #

如果之前的测试导致系统缓存了权限状态，可通过终端重置：

tccutil reset Photos com.your-app-bundle-id

替换com.your-app-bundle-id为你的应用Bundle ID，关闭应用后执行该命令，再重新运行应用。

5. 兼容旧版MacOS权限API #

修改权限状态检查方法，兼容MacOS 10.15之前的版本：

private func checkPhotosAuthorizationStatus() {
    if #available(macOS 10.15, *) {
        authorizationStatus = PHPhotoLibrary.authorizationStatus(for: .readWrite)
    } else {
        authorizationStatus = PHPhotoLibrary.authorizationStatus()
    }
    logMessage = "Current Photos authorization status: \(authorizationStatus.rawValue)"
    print(logMessage)
}

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