iOS App 相机权限崩溃问题排查与解决方案

2024-12-08 11:32:04

iOS App 因相机权限崩溃问题排查与解决

移动应用请求访问相机权限时，如果配置不当，可能会导致应用崩溃。iOS系统对此类权限有严格的限制和要求，本文章将详细分析 iOS App 因相机权限崩溃 的原因并提供解决方案。

问题分析：隐私权限声明缺失

iOS应用在访问用户隐私数据（如相机）时，必须事先在Info.plist文件中声明使用目的。如果没有声明，或者声明不完整，系统会认为应用非法访问隐私数据，从而强制终止应用运行。从问题的错误信息来看，应用缺少 NSCameraUsageDescription 键值声明。虽然开发者可能已经在项目的Target中进行了设置，但实际运行时，系统依然无法识别到相应的权限声明。

解决方案

以下步骤将指导你如何正确配置相机权限，并提供代码示例以及操作说明：

1. 添加 `NSCameraUsageDescription` 到 Info.plist

此步骤为关键步骤，直接关系到App是否能够正确获取相机权限。

操作步骤 :
1. 打开 Xcode 项目，找到 Info.plist 文件。
2. 鼠标悬停在最后一行，会出现一个 + 号。点击这个加号，或者右键选择 Add Row 添加新的键值对。
3. 在 Key 列中输入 Privacy - Camera Usage Description 或者 NSCameraUsageDescription，系统会自动匹配并补全键名。
4. 在 Value 列中，填入一段文字，向用户解释应用使用相机的目的。例如：“应用需要使用相机扫描二维码”。
5. 保存 Info.plist 文件。

Info.plist XML 代码示例 :

<key>NSCameraUsageDescription</key>
<string>应用需要使用相机扫描二维码</string>

2. 检查 Target 设置

有时候，即使在 Info.plist 文件中添加了权限，Target 设置也可能存在问题。因此，需要仔细检查 Target 中的设置，确保权限配置正确。

操作步骤 :
1. 在 Xcode 中，点击左上角项目导航器中的 Target。
2. 选择 Signing & Capabilities 选项卡。
3. 点击 + Capability 按钮，添加 Camera 权限。理论上Info.plist配置后此处会自动配置，但也应做二次检查。如果已经存在则无需重复添加，只需确认没有错误配置即可。

3. 代码层面请求权限

虽然在 Info.plist 中声明了权限，但应用仍然需要在代码中请求用户授权。这是一种更稳妥的做法，可以处理用户拒绝授权的情况，提升用户体验。

原理 : 使用 AVCaptureDevice.authorizationStatus 检查当前授权状态，如果未授权则使用 AVCaptureDevice.requestAccess 请求授权。

代码示例 (Swift) :

import AVFoundation

func requestCameraPermission(completion: @escaping (Bool) -> Void) {
    let cameraAuthorizationStatus = AVCaptureDevice.authorizationStatus(for: .video)
    switch cameraAuthorizationStatus {
    case .authorized:
        // 已经授权，直接执行回调
        completion(true)
    case .notDetermined:
        // 尚未请求授权，发起请求
        AVCaptureDevice.requestAccess(for: .video) { granted in
            DispatchQueue.main.async {
                completion(granted)
            }
        }
    case .denied, .restricted:
        // 授权被拒绝或受限，提示用户去设置中修改
        completion(false)
    @unknown default:
      completion(false)
    }
}

// 在需要使用相机的地方调用
requestCameraPermission { granted in
    if granted {
        // 用户已授权，执行相机操作
      DispatchQueue.main.async {
              self.setupCameraSession() // 此处替换成你的相机启动逻辑
      }
      } else {
        // 用户拒绝授权，提示用户
        DispatchQueue.main.async {
          self.showCameraPermissionAlert() // 此处替换成你的权限提示逻辑
      }
    }
}

func setupCameraSession() {
//...此处是之前初始化相机和扫描的代码
      captureSession = AVCaptureSession()

              guard let videoCaptureDevice = AVCaptureDevice.default(for: .video) else { return }
              let videoInput: AVCaptureDeviceInput

      do {
          videoInput = try AVCaptureDeviceInput(device: videoCaptureDevice)

      } catch {
                  return
              }

      if (captureSession.canAddInput(videoInput)) {
          captureSession.addInput(videoInput)

      } else {
          failed()
          return

      }

              let metadataOutput = AVCaptureMetadataOutput()

      if (captureSession.canAddOutput(metadataOutput)) {
          captureSession.addOutput(metadataOutput)

          metadataOutput.setMetadataObjectsDelegate(self, queue: DispatchQueue.main)
          metadataOutput.metadataObjectTypes = [.qr]

      } else {
          failed()
          return

      }

      previewLayer = AVCaptureVideoPreviewLayer(session: captureSession)
      previewLayer.frame = view.layer.bounds
      previewLayer.videoGravity = .resizeAspectFill
      view.layer.addSublayer(previewLayer)

      captureSession.startRunning()
  }

func showCameraPermissionAlert() {
    let alert = UIAlertController(title: "无法访问相机",
                                  message: "请在iPhone的“设置-隐私-相机”选项中，允许App访问你的相机。",
                                  preferredStyle: .alert)
    let settingsAction = UIAlertAction(title: "设置", style: .default) { (_) in
        guard let settingsUrl = URL(string: UIApplication.openSettingsURLString) else {
            return
        }
        if UIApplication.shared.canOpenURL(settingsUrl) {
            UIApplication.shared.open(settingsUrl)
        }
    }
    let cancelAction = UIAlertAction(title: "取消", style: .cancel, handler: nil)
    alert.addAction(settingsAction)
    alert.addAction(cancelAction)
    present(alert, animated: true, completion: nil)
}

代码说明 :
1. requestCameraPermission 函数封装了请求相机权限的逻辑，接受一个回调函数作为参数。
2. 首先检查当前授权状态，如果是已授权，直接调用回调函数并传入 true。
3. 如果是未决定状态，则调用 AVCaptureDevice.requestAccess 请求权限，并在回调中更新 UI 并执行相应的操作。
4. 如果权限被拒绝或受限，则调用回调函数并传入 false，并提示用户前往设置手动开启权限。

4. 避免重复请求权限

原理：频繁请求权限会打扰用户。一旦用户拒绝，应该引导用户去设置中修改权限，而不是反复弹窗请求。
代码示例 (Swift) 此部分已经在 requestCameraPermission函数中实现。case .denied, .restricted 分支中执行 completion(false)，并在调用 requestCameraPermission 后的回调中执行 showCameraPermissionAlert函数引导用户到设置更改权限。

5. 安全建议

最小权限原则 ：只请求必要的权限，不要过度申请用户隐私。如果仅需扫描二维码，则只请求相机权限即可。
明确告知用户 ：在 NSCameraUsageDescription 中清晰说明应用使用相机的目的，让用户知情。
优雅处理权限拒绝 ：如果用户拒绝授权，不要强制退出，应提供友好的提示和备选方案。
及时更新权限描述 ：如果应用功能发生变化，需要修改权限用途时，务必及时更新 Info.plist 文件中的权限描述。
* 懒加载相机 : 避免在 App 启动时立即初始化相机，可以延迟到实际需要使用的时候再加载，可以提高 App 启动速度。

遵循上述步骤，并结合代码示例，可以有效地解决iOS App 因相机权限崩溃的问题。在开发过程中，始终牢记用户隐私安全的重要性，合理、合法地使用各项权限。

iOS App 相机权限崩溃问题排查与解决方案

问题分析：隐私权限声明缺失

解决方案