Kotlin Multiplatform (KMP) 中，如何实现跨平台权限请求?

Kotlin Multiplatform (KMP) 中，如何实现跨平台权限请求?

在 Kotlin Multiplatform 中实现跨平台权限请求，最主流的方式是使用社区维护的第三方库，它们封装了底层的平台差异，能让你在共享代码中通过统一的 API 来请求权限。当然，也可以完全使用 Kotlin 原生的 expect/actual 机制自行封装。

目前，最常用的两个库是 kPermissions 和 moko-permissions。

对于 Compose Multiplatform 项目，kPermissions 的声明式 API 更契合现代 UI 开发模式。而如果你的项目对权限的精细控制要求很高，moko-permissions 会是更稳妥的选择。

🛠️ 两种主流实现方式

以下将分别介绍如何使用 kPermissions、moko-permissions 以及 expect/actual 机制来实现跨平台权限请求。

📦 方式一：使用 kPermissions

kPermissions 库为 KMP + Compose 项目提供了非常便利的 API。

1. 添加依赖 在你的 shared 模块的 build.gradle.kts 文件中，添加所需权限模块的依赖。

   // shared/build.gradle.kts
   kotlin {
       sourceSets {
           val commonMain by getting {
               dependencies {
                   // 例如，添加相机和图库权限
                   implementation("io.github.kpermissions:kpermissions-camera:1.0.1")
                   implementation("io.github.kpermissions:kpermissions-gallery:1.0.1")
               }
           }
       }
   }

2. 使用 Compose API 请求权限 在共享 UI 中，你可以使用 rememberPermissionState 和 LaunchedEffect 以声明式方式触发权限请求。

   @Composable
   fun CameraScreen() {
       // 1. 创建权限状态
       val cameraPermission = rememberPermissionState(CameraPermission)
   
       // 2. 在副作用中触发权限请求
       LaunchedEffect(Unit) {
           cameraPermission.launchPermissionRequest { granted ->
               if (granted) {
                   // 权限已授予，可以打开相机
               } else {
                   // 权限被拒绝，可以展示说明或引导用户去设置中开启
               }
           }
       }
   
       // UI 界面
       // ...
   }

📦 方式二：使用 moko-permissions

moko-permissions 功能全面，同样支持 Compose，其 API 与 kPermissions 有所不同。

1. 添加依赖 在你的 shared 模块的 build.gradle.kts 文件中添加核心依赖和 Compose 支持。

   // shared/build.gradle.kts
   kotlin {
       sourceSets {
           val commonMain by getting {
               dependencies {
                   // 核心权限 API
                   implementation("dev.icerock.moko:permissions:0.20.1")
                   // 权限模块，例如相机、位置等
                   implementation("dev.icerock.moko:permissions-camera:0.20.1")
                   implementation("dev.icerock.moko:permissions-location:0.20.1")
                   // 为 Compose Multiplatform 提供扩展
                   implementation("dev.icerock.moko:permissions-compose:0.20.1")
               }
           }
       }
   }

2. 使用 PermissionsController 请求权限 moko-permissions 的核心是 PermissionsController。你需要在共享的 ViewModel 或 Presenter 中持有它的实例。

   // 在共享的 ViewModel 中
   class MyViewModel(private val permissionsController: PermissionsController) {
       fun requestCameraPermission() {
           permissionsController.providePermission(Permission.CAMERA) { result ->
               when (result) {
                   is PermissionResult.Granted -> {
                       // 权限已授予
                   }
                   is PermissionResult.Denied -> {
                       // 权限被拒绝（非永久）
                       // 可以在此展示申请权限的缘由
                   }
                   is PermissionResult.DeniedAlways -> {
                       // 权限被永久拒绝
                       // 需要引导用户去系统设置中手动开启
                       permissionsController.openAppSettings()
                   }
               }
           }
       }
   }

🧱 方式三：使用 expect/actual 自行实现

如果不想引入第三方库，完全可以使用 Kotlin 的 expect/actual 机制来手动封装平台特定的权限 API。

1. 在 commonMain 中定义 expect 接口和状态 首先，定义通用的权限状态枚举和一个 expect 的权限处理器接口。

   // commonMain 代码
   enum class PermissionStatus { GRANTED, DENIED, PERMANENTLY_DENIED }
   
   expect class PlatformPermissionHandler() {
       suspend fun requestPermission(permission: String): PermissionStatus
       fun checkPermission(permission: String): PermissionStatus
   }

2. 在 androidMain 和 iosMain 中提供 actual 实现 然后，分别针对 Android 和 iOS 平台提供这个接口的具体实现。

   • Android 实现 (androidMain)

     // androidMain 代码
     actual class PlatformPermissionHandler(
         private val activity: Activity
     ) {
         actual suspend fun requestPermission(permission: String): PermissionStatus {
             // 使用 Android 的 requestPermissions API 进行请求
             // ...
         }
         // ...
     }

   • iOS 实现 (iosMain)

     // iosMain 代码
     actual class PlatformPermissionHandler {
         actual suspend fun requestPermission(permission: String): PermissionStatus {
             return when (permission) {
                 "camera" -> requestCameraPermission()
                 // ...
                 else -> PermissionStatus.DENIED
             }
         }
     
         private suspend fun requestCameraPermission(): PermissionStatus {
             return suspendCancellableCoroutine { continuation ->
                 AVCaptureDevice.requestAccess(for: .video) { granted ->
                     continuation.resume(if (granted) PermissionStatus.GRANTED else PermissionStatus.DENIED)
                 }
             }
         }
         // ...
     }

📄 平台配置清单

在使用任何权限之前，必须确保在各个平台的工程中进行了正确的配置。这份清单务必逐项检查。

💎 总结与建议

• 项目起步：如果你的项目使用了 Compose Multiplatform，建议从 kPermissions 开始，它的 API 非常现代且与 Compose 结合紧密。
• 成熟稳定：对于追求稳定性和功能全面性的项目，moko-permissions 是久经考验的可靠选择。
• 极致控制：若希望完全掌控权限逻辑或避免引入第三方库，使用 expect/actual 机制手动实现也是一个完全可行的方案。