🔐SwiftUI 权限请求优雅方案 —— 深入解析 PermissionsSwiftUI 使用与集成

掘金 iOS

作者 MaoJiu

2025年5月18日 21:38

在 iOS 应用开发中，权限请求是用户体验中的关键一环。我们通常需要请求访问相机、麦克风、定位、通知等系统资源，但系统原生的权限提示机制往往不够统一，缺乏灵活控制和个性化设计。

本文将深入介绍一个极具实用价值的开源项目 —— PermissionsSwiftUI，它可以帮助我们在 SwiftUI 中以 Apple 风格的方式统一管理权限请求，为用户提供一致的交互体验，并极大提升开发效率。

🌟 为什么选择 PermissionsSwiftUI？

SwiftUI 生态下的权限请求痛点

原生权限请求需要手动管理每种权限的状态判断与请求流程，代码分散、重复性高；
界面风格不统一，系统弹窗缺乏一致性、定制性；
缺乏优雅的组合请求机制，多个权限需要分次触发，交互割裂。

PermissionsSwiftUI 提供的解决方案

特性	说明
🧩 SwiftUI 原生支持	完全基于 SwiftUI 构建，无需 UIKit
🎨 苹果风格 UI	模态弹窗（Modal）或警告框（Alert），界面统一
🧠 自动授权判断	内置权限状态判断逻辑
⚙️ 高度自定义	图标、颜色、描述、关闭策略均可配置
🎯 支持权限丰富	支持十多种常见权限类型

🛠️ 安装与配置

推荐方式：使用 Swift Package Manager

打开 Xcode 项目，选择菜单栏：

File → Add Packages...

2. 输入 GitHub 仓库地址：

https://github.com/jevonmao/PermissionsSwiftUI

3. 选择版本（建议使用 Up to Next Major，确保自动兼容更新） 4. 在 Link Binary With Libraries 中选择实际使用的权限模块，避免多余依赖和 Apple 审核拒绝。

重要配置：添加 Info.plist 权限声明

如需请求相机和定位权限，需添加以下键值到 Info.plist：

<key>NSCameraUsageDescription</key>
<string>我们需要访问您的相机用于拍照上传</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>我们需要访问您的位置信息以提供本地化服务</string>

⚡ 快速上手：几行代码完成权限弹窗

import SwiftUI
import PermissionsSwiftUI

struct ContentView: View {
    @State private var showPermissions = false

    var body: some View {
        Button("打开权限弹窗") {
            showPermissions = true
        }
        .JMModal(showModal: $showPermissions, for: [.camera, .microphone])
    }
}

✨ 效果说明：

.JMModal() 修饰符创建一个类似苹果系统设置的权限弹窗；
for: [.camera, .microphone] 表示一次性请求多个权限；
你也可以用 .JMAlert() 创建警告框样式弹窗。

🎛 自定义弹窗内容与行为

PermissionsSwiftUI 提供多个链式方法对弹窗进行细粒度控制：

修改 UI 内容：

.JMModal(showModal: $showPermissions, for: [.photo])
.changeHeaderTo("我们需要您的照片权限")
.changeHeaderDescriptionTo("请允许访问照片库以上传您的头像")

改变主色调和样式：

.changePrimaryColor(.indigo)
.changeAccentColor(.orange)

行为控制：

.autoDismiss(true) // 请求后自动关闭
.restrictDismissal(true) // 不允许用户关闭弹窗
.autoCheckAuthorization(true) // 自动判断授权状态

📚 支持的权限类型一览

权限类型	枚举值	描述
📷 相机	.camera	拍照、扫码等场景
🎤 麦克风	.microphone	音频录制、通话
📍 位置（使用时）	.locationWhenInUse	地图、定位
📍 位置（始终）	.locationAlways	后台定位
🖼️ 照片	.photo	上传图片、访问相册
📅 日历	.calendar	添加、读取日程
⏰ 提醒事项	.reminder	管理提醒事项
❤️ 健康	.health	Apple Health 数据
🧭 蓝牙	.bluetooth	与蓝牙设备通信
🏃‍♂️ 运动传感器	.motion	健身、步数识别
📢 通知	.notification	推送消息
🎶 音乐库	.music	Apple Music 访问
🗣️ 语音识别	.speech	实时语音识别

你只需引入需要的权限模块，无需一次性导入所有依赖。

🧱 高阶用法：封装权限管理组件

可进一步封装一个可复用的权限请求组件，提升项目模块化程度：

struct PermissionRequestView: View {
    @Binding var isPresented: Bool

    var body: some View {
        EmptyView()
        .JMModal(showModal: $isPresented, for: [.camera, .microphone, .locationWhenInUse])
        .changeHeaderTo("权限说明")
        .changeHeaderDescriptionTo("为了正常使用应用，我们需要以下权限...")
        .changePrimaryColor(.green)
    }
}

在页面中调用：

PermissionRequestView(isPresented: $showPermissions)

🔄 权限状态管理与回调处理

PermissionsSwiftUI 不直接暴露授权状态回调，但你可以通过 PermissionsSwiftUI.PermissionManager 判断当前权限状态：

let status = PermissionManager.shared.getPermissionStatus(for: .camera)

switch status {
    case .authorized:
    print("已授权")
    case .denied:
    print("被拒绝")
    case .notDetermined:
    print("未决定")
    default:
    break
}

你也可以监听状态变化后动态关闭权限弹窗或执行某些操作。

🚧 常见问题与注意事项

问题	说明
App 审核被拒	请确保只请求实际使用的权限，并在 Info.plist 中添加合理描述
无法自动弹窗	请确保 .JMModal 中绑定的 @State 被正确设置
通知权限不起作用	iOS 通知授权需单独处理，可考虑手动使用 UNUserNotificationCenter 搭配

📬 总结与推荐

PermissionsSwiftUI 是一个轻量、高扩展性、易集成的权限请求库，特别适合使用 SwiftUI 技术栈的项目：

✅ Apple 风格弹窗提升用户信任感

✅ 多权限统一管理简化开发流程

✅ 高度自定义满足不同 UI 风格需求

如果你正准备开发一个需要使用多个系统权限的 SwiftUI 项目，PermissionsSwiftUI 是一个非常值得尝试的工具库。

普通视图