调用requestApplicationPermission申请userDiscoverability无权限弹窗

问题描述 #

开发过程中需要通过iCloud获取用户信息，在模拟器、真机环境测试时，调用requestApplicationPermission申请.userDiscoverability权限的弹窗始终未弹出，原有实现代码如下：

func requestPermission() {
    CKContainer.default().requestApplicationPermission(.userDiscoverability) { [weak self] returnedStatus, returnedError in
        DispatchQueue.main.async {
            if returnedStatus == .granted {
                self?.permissionStatus = true
            }
        }
    }
}

排查步骤与解决方案 #

• 基础配置校验
  • 确认开发者后台对应AppID已开启iCloud服务，Xcode的Signing & Capabilities页已正确添加iCloud能力、勾选CloudKit选项，关联的CloudKit容器ID与业务配置一致，无签名报错
  • 确认测试设备/模拟器已登录有效iCloud账号，且iCloud Drive功能处于开启状态；iOS14及以上系统需额外确认设置-iCloud-使用iCloud的App列表中，当前App的开关为开启状态
  • 确认测试环境网络可正常连接苹果iCloud服务，无全局代理、网络拦截规则阻断CloudKit请求
• 代码逻辑修正
  系统不会重复弹出权限申请弹窗：如果用户此前已经对该权限做出过允许/拒绝的选择，再次调用申请接口不会触发弹窗。原有代码未做权限状态预查询、未处理错误返回，无法定位无响应的具体原因，修正后代码如下：

func requestPermission() {
    // 先查询当前权限状态
    CKContainer.default().status(forApplicationPermission: .userDiscoverability) { [weak self] currentStatus, checkError in
        if let error = checkError {
            print("权限状态查询失败: \(error.localizedDescription)")
            return
        }
        // 已授权场景直接更新状态，无需发起申请
        guard currentStatus != .granted else {
            DispatchQueue.main.async {
                self?.permissionStatus = true
            }
            return
        }
        // 仅在权限为初始未请求状态时发起申请
        CKContainer.default().requestApplicationPermission(.userDiscoverability) { [weak self] returnedStatus, returnedError in
            DispatchQueue.main.async {
                // 必须处理错误返回，定位问题
                if let error = returnedError {
                    print("权限申请出错: \(error.localizedDescription)")
                    return
                }
                self?.permissionStatus = (returnedStatus == .granted)
            }
        }
    }
}

• 特殊场景说明
  • 若用户此前已经拒绝过权限申请，后续调用接口不会再弹窗，需要引导用户前往系统设置页手动开启对应权限
  • 模拟器如果执行过「抹除所有内容和设置」操作，需要重新登录iCloud账号，否则CloudKit接口会直接返回账号未登录错误，不会触发弹窗
  • App首次调用CloudKit相关接口时，系统会先弹出iCloud使用确认的全局弹窗，该弹窗未完成交互前，权限申请弹窗不会弹出

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