KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

Flywith24-Permission

★ 36 Open GitHub ↗

使用 ActivityResult API 和 Kotlin 扩展函数实现权限请求

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[activity 1.2.0-beta01](https://developer.android.com/jetpack/androidx/releases/activity#1.2.0-beta01) 后 `register()` 方法调用时机受到了生命周期的限制

![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/c28660b244cf41978f01274174c3a95d~tplv-k3u1fbpfcp-zoom-1.image)

这意味着使用扩展函数的方式将不能使用，因为无法控制扩展函数的调用时机。

基于新版本的行为变化我进行了新的封装，但在易用性上没有达到要求，感兴趣的小伙伴可以去看看：[Flywith24-ActivityResultRequest](https://github.com/Flywith24/Flywith24-ActivityResultRequest)

目前的使用方式是这样，比较繁琐：

![](https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/c45cdb96a7084f80afa93e1835320028~tplv-k3u1fbpfcp-watermark.image)

---
分割线
---

# 以下方式已弃用！！！！！！！！！！！！！！

---
分割线
---

# 使用 Activity Result API + Kotlin 扩展函数 封装权限请求库

## 引入

[![](https://jitpack.io/v/Flywith24/Flywith24-Permission.svg)](https://jitpack.io/#Flywith24/Flywith24-Permission)

1. 在项目根目录的 `build.gradle` 加入

``` groovy
   allprojects {
     repositories {
       //...
       maven { url 'https://jitpack.io' }
     }
   }
   ```

2. 添加依赖

``` groovy
   dependencies {
	  implementation 'com.github.Flywith24:Flywith24-Permission:$version'
	}
   ```

## 更新记录

- 1.0.1 版本支持 Kotlin DSL 写法

## Activity Result API

在  Android Jetpack `Activity 1.2.0-alpha02` 和 `Fragment 1.3.0-alpha02` 中，Google 提供了全新的 **Activity Result API** 来替换 `startActivityForResult()`+`onActivityResult()`和`requestPermissions()`+`onRequestPermissionsResult()`。详情可移步[官方文档](https://developer.android.com/training/basics/intents/result)

## requestPermissions() / onRequestPermissionsResult() 被弃用

紧接着在 `Activity 1.2.0-alpha04` 和 `Fragment 1.3.0-alpha04` 版本中，

`startActivityForResult()`+`onActivityResult()`和`requestPermissions()`+`onRequestPermissionsResult()`被标记为弃用，而在`Fragment 1.3.0-alpha05` 这些标记弃用的方法内部已改为使用 `ActivityResultRegistry` 实现

![](https://gitee.com/flywith24/Album/raw/master/img/20200625201515.png)

![](https://gitee.com/flywith24/Album/raw/master/img/20200625201449.png)

## 新 API 的使用

新的 API 使用非常简单，分为单一权限请求，和多权限请求，Activity 和 Fragment 使用方法相同

### 单一权限请求

``` kotlin
val permission = Manifest.permission.WRITE_EXTERNAL_STORAGE
registerForActivityResult(ActivityResultContracts.RequestPermission()) { result ->
// 请求结果，result 为 boolean true 代表已授权，false 代表未授权       
}.launch(permission)
```

### 多权限请求

``` kotlin
val permissions = arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.CAMERA)

registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { result: MutableMap<String, Boolean> ->
// 请求结果，返回一个map ，其中 key 为权限名称，value 为是否权限是否赋予
}.launch(permissions)
```

## 配合 Kotlin 扩展函数进行封装

配合 Kotlin 的扩展函数，我们可以将权限请求的逻辑进行封装。

开发过程中，我们申请权限时关注的就是权限是否申请成功，如果未申请成功是否勾选了不再询问

因此我们可以加入「权限申请成功」，「权限申请失败且未勾选不再询问」，「权限申请失败且已勾选不再询问」三种状态的回调

``` kotlin
/**
 * [permission] 权限名称
 * [granted] 申请成功
 * [denied] 被拒绝且未勾选不再询问
 * [explained] 被拒绝且勾选不再询问
 */
inline fun Fragment.requestPermission(
    permission: String,
    crossinline granted: (permission: String) -> Unit = {},
    crossinline denied: (permission: String) -> Unit = {},
    crossinline explained: (permission: String) -> Unit = {}

) {
    registerForActivityResult(ActivityResultContracts.RequestPermission()) { result ->
        when {
            result -> granted.invoke(permission)
            shouldShowRequestPermissionRationale(permission) -> denied.invoke(permission)
            else -> explained.invoke(permission)
        }
    }.launch(permission)
}

/**
 * [permissions] 权限数组
 * [allGranted] 所有权限均申请成功
 * [denied] 被拒绝且未勾选不再询问，同时被拒绝且未勾选不再询问的权限列表
 * [explained] 被拒绝且勾选不再询问，同时被拒绝且勾选不再询问的权限列表
 */
inline fun Fragment.requestMultiplePermissions(
    vararg permissions: String,
    crossinline allGranted: () -> Unit = {},
    crossinline denied: (List<String>) -> Unit = {},
    crossinline explained: (List<String>) -> Unit = {}
) {
    registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { result: MutableMap<String, Boolean> ->
        //过滤 value 为 false 的元素并转换为 list
        val deniedList = result.filter { !it.value }.map { it.key }
        when {
            deniedList.isNotEmpty() -> {
                //对被拒绝全选列表进行分组，分组条件为是否勾选不再询问
                val map = deniedList.groupBy { permission ->
                    if (shouldShowRequestPermissionRationale(permission)) DENIED else EXPLAINED
                }
                //被拒接且没勾选不再询问
                map[DENIED]?.let { denied.invoke(it) }
                //被拒接且勾选不再询问
                map[EXPLAINED]?.let { explained.invoke(it) }
            }
            else -> allGranted.invoke()
        }
    }.launch(permissions)
}
```

使用起来是这样的

### 单一权限申请

``` kotlin
requestPermission(Manifest.permission.RECORD_AUDIO,
    granted = { permission ->
        //权限申请成功
        },
    denied = { permission ->
       //权限申请失败且未勾选不再询问，下次可继续申请
    },
    explained = { permission ->
        //权限申请失败且已勾选不再询问，需要向用户解释原因并引导用户开启权限
    })
```

### 多权限申请

``` kotlin
requestMultiplePermissions(Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.CAMERA,
    allGranted = {
        //全部权限均已申请成功
    },
    denied = {list->
        //权限申请失败且未勾选不再询问，下次可继续申请
    },
    explained = {list->
        //权限申请失败且已勾选不再询问，需要向用户解释原因并引导用户开启权限
    })
```

## Kotlin DSL 版本

配合 Kotlin DSL，代码读起来会更容易

### 单一权限申请

``` kotlin
// DSL 模式
permission(Manifest.permission.RECORD_AUDIO) {
    granted = { permission ->
        //权限申请成功
    }
    denied = { permission ->
        //权限申请失败且未勾选不再询问，下次可继续申请
    }
    explained = { permission ->
        //权限申请失败且已勾选不再询问，需要向用户解释原因并引导用户开启权限
    }
}
```

### 多权限申请

``` kotlin
// DSL 模式
permissions(
    Manifest.permission.WRITE_EXTERNAL_STORAGE,
    Manifest.permission.CAMERA
) {
    allGranted = {
       //全部权限均已申请成功
    }
    denied = {list->
       //权限申请失败且未勾选不再询问，下次可继续申请
    }
    explained = {list->
        //权限申请失败且已勾选不再询问，需要向用户解释原因并引导用户开启权限
    }
}
```

## Java 版本

Java 是可以调用 Kotlin 的扩展函数的，为了跟方便地调用，可以在此基础上再封装一层

### 单一权限请求

``` java
PermissionUtils.requestPermission(this, permission, new PermissionResultListener() {
    @Override
    public void granted(String permission) {
        Log.i(TAG, "granted: ");
    }
    @Override
    public void denied(String permission) {
        Log.i(TAG, "denied: ");
    }
    @Override
    public void explained(String permission) {
        Log.i(TAG, "explained: ");
    }
});
```

### 多权限请求

``` java
PermissionUtils.requestMultiplePermissions(this, new MultiPermissionResultListener() {
    @Override
    public void allGranted() {
        Log.i(TAG, "allGranted: ");
    }
    @Override
    public void denied(List<String> list) {
        Log.i(TAG, "denied: " + list.toString());
    }
    @Override
    public void explained(List<String> list) {
        Log.i(TAG, "explained: " + list.toString());
    }
}, permissions);
```

Flywith24-Permission

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README