安卓权限申请处理框架Android-UsesPermission

简介: 安卓权限申请处理框架Android-UsesPermission 安卓权限申请封装处理框架。测试支持4.0+。项目源于正式处理Android权限问题时,没找到简单、能满足被拒绝权限自动会到系统设置处理的框架,按自己的编程习惯造一个熟悉的轮子还是蛮好的。

安卓权限申请处理框架Android-UsesPermission

安卓权限申请封装处理框架。测试支持4.0+。项目源于正式处理Android权限问题时,没找到简单、能满足被拒绝权限自动会到系统设置处理的框架,按自己的编程习惯造一个熟悉的轮子还是蛮好的。第一次使用Android Studio,还是Eclipse敲代码爽。来自一个(独爱HTML+CSS来构建用户界面的)Android很早入门的新手。

项目用到了XXPermissions中的权限列表、国产手机权限设置页面跳转列表,借鉴了其中的权限结果onRequestPermissionsResult的接收方式。

Github:https://github.com/xiangyuecn/Android-UsesPermission

特性

  1. 一个函数调用处理权限申请的所有问题,被拒绝的权限重复询问,被永久拒绝的权限(记住选择、不再询问)打开App授权系统设置。
  2. 函数式调用,代码简洁明晰,阅读源码不用跳来跳去。
  3. 明确的授权结果回调,要么有(True),要么没有(False)。
  4. 默认0界面,调用者无需知道、提供、导入任何界面包括文件,但可深度定制。
  5. 中性,默认非弓虽J式、有回旋余地的对待拒绝权限的场景。
  6. 理论上支持任何Android版本(但仅在 4.0 - 9.0 模拟器上进行了测试)。

演示

可直接编译test_app项目进行测试,或者下载.assets/test_app-debug-xxx.apk测试安装包。

快速使用

直接复制lib_comm/src/main/java/ecomm/lib_comm/permission里面的文件到你的程序里面即可使用。

示例代码

//假设需要获取摄像头、录音权限,直接在调用的地方实现抽象类,调用逻辑能简单直观不少

new UsesPermission(MainActivity.this, Permission.CAMERA, Permission.RECORD_AUDIO){
    @Override
    protected void onTrue(@NonNull ArrayList<String> lowerPermissions) {
        //获取了全部权限执后行此函数,
    }

    @Override
    protected void onFalse(@NonNull ArrayList<String> rejectFinalPermissions, @NonNull ArrayList<String> rejectPermissions, @NonNull ArrayList<String> invalidPermissions) {
        //未全部授权时执行此函数
    }

    //要么实现上面两个方法即可,onTrue或onFalse只会有一个会被调用一次
    //要么仅仅实现下面这个方法,不管授权了几个权限都会调用一次

    @Override
    protected void onComplete(@NonNull ArrayList<String> resolvePermissions, @NonNull ArrayList<String> lowerPermissions, @NonNull ArrayList<String> rejectFinalPermissions, @NonNull ArrayList<String> rejectPermissions, @NonNull ArrayList<String> invalidPermissions) {
        //完成回调,可能全部已授权、全部未授权、或者部分已授权
        //通过resolvePermissions.contains(Permission.XXX)来判断权限是否已授权
    }
};

默认行为逻辑

  1. 先直接发起权限申请
    • 普通权限(没永久拒绝的权限)如果被拒绝(非永久拒绝),后续会安排再弹框申请一次(防用户误选)。
    • 如果授权结果有被永久拒绝的,这部分权限会和第二步权限申请一起弹框跳转到App授权系统设置。
  2. 弹一次框处理被永久拒绝的权限(弹一次够了),跳转到App授权系统设置界面。

可参考重写onTips方法修改此行为,做到不弹提示或者多次弹提示授权。

UsesPermission类文档

import ecomm.lib_comm.permission.Permission;

这个类对外只有一个构造函数,直接new直接调起授权请求。使用过程中只需重写这个类的相应函数来控制授权请求行为。无多余、也不提供对外控制的方法。

构造函数

UsesPermission(activity,permissions,defaultTips="")

调用构造函数立即会调起授权请求,对permissions列表中的权限进行申请。

请求过程中会根据onTips返回的结果来控制提示信息、和授权请求流程,defaultTipsonTips默认实现使用到的提示信息默认值,默认为""字符串;具体逻辑参考onTips

回调类可重写函数

这些函数都是可以选择重写,默认提供了空实现,不实现也没关系。

void onTrue(lowerPermissions)

权限已全部授权时的回调,不管什么情况,onTrueonFalse肯定有一个会回调。注意:方法内跟API版本有关的方法调用,应自行判断API版本,因为低版本API中高版本权限请求全部会放行。

lowerPermissions:如果是在低版本API上处理不支持的高版本新权限时,会忽略此项权限的检测的检测,默许放行,此时本参数将带上此权限。

void onFalse(rejectFinalPermissions,rejectPermissions,invalidPermissions)

未授权时回调,不管什么情况,True和False肯定有一个会回调

rejectFinalPermissions:被永久拒绝的权限列表,为rejectPermissions的子集,空数组代表没有此项。

rejectPermissions:被拒绝的权限列表,空数组代表没有此项。

invalidPermissions:未在manifest里声明的权限列表,不会出现在rejectFinalPermissions中,空数组代表没有此项。

void onComplete(resolvePermissions,lowerPermissions,rejectFinalPermissions,rejectPermissions,invalidPermissions)

授权完成时回调,会在onTrueonFalse之一回调后调用。

resolvePermissions:已授权的权限列表。

lowerPermissions:参考onTrue,为resolvePermissions的子集。

剩余参数参考onFalse

控制类可重写函数

这些函数都是用来控制授权行为,都提供了默认实现。

String onTips(viewTipsCount,permissions,isFinal)

整个类里面最核心,逻辑最复杂的一个方法(虽然默认实现只有3行代码)。此方法控制着整个权限请求的流程,弹不弹提示,尝不尝试重新申请,都是它说了算。

授权请求发起前会回调此方法,用来生成设置提示信息,也是来决定是否提示和进行授权。如果返回null,代表不进行下下一步操作;返回字符串会进行提示然后进行请求授权。注意:这个方法,会有不同权限进行多次调用;如果用户选点击了取消默认这些权限不会再调起请求(可重写onCancelTips修改此行为)。

默认行为为:

  1. 先直接发起权限申请 viewTipsCount=0
    • 普通权限(非永久拒绝)如果被拒绝(非永久拒绝),后续会安排再弹框申请一次(防误选)。
    • 如果结果有被永久拒绝,这部分权限会和后面的永久权限申请一起弹框处理。
  2. 弹一次框处理被永久拒绝的权限(弹一次够了),跳转到App授权系统设置界面 viewTipsCount=1+
@param viewTipsCount 0-n 是第几次准备弹提示框。
         0:申请前的引导提示,返回null代表不弹提示,直接调起授权。
             注意:第0次包含所有权限(不含带自定义授权请求的权限),无法区分是不是永久拒绝的权限。
         1+:被永久拒绝的权限申请,或普通权限上一轮被拒。
             注意:为1的时候,如果权限带自定义的授权请求方式,就算返回了null,也会进行提示并调用授权请求。

@param permissions 被拒绝的权限列表
@param isFinal 这个权限列表是不是永久被拒绝的权限,true是,false为未永久拒绝

@return 返回提示信息;返回值为null不进行申请;为空字符串时自动生成合理的提示。
     字符串内容支持特定占位符:
         {Auto}:用自动生成提示内容替换
         {Names}:自动替换被拒绝的权限名称
                如:'xx"{Names}"xx' => 'xx"权限名1,权限名2,权限名3"xx'

String onCancelTips(viewCancelCount,permissions,isFinal)

不建议重写,取消了也弹提示真不友好,弹出了提示时,用户点击了取消时的额外提示信息。返回null彻底不再调起提示,默认就是返回null。这个回调的用法和onTips一模一样,只是这个仅仅作用在点击了取消时。注意:重写这个方法应该慎重,最多viewCancelCount几次后就返回null,避免出现无法取消永远弹框的问题。

viewCancelCount 1-n 当前这次请求是第几次取消。

String onTipsDialogView(tips,isCancel,viewTipsCount,permissions,isFinal,okCall,cancelCall)

授权提示弹框,重写此方法自定义弹框行为,默认使用系统AlertDialog弹框。只要求必须回调okCallcancelCall中的任何一个,怎么显示界面、显示多少个界面 -> 随意。

Permission类文档

import ecomm.lib_comm.permission.Permission;

这个类封装了8.0版本的危险权限列表,并且提供了对应的权限名称映射。

权限列表

使用过程中推荐使用这个类里面定义的权限,比如Permission.CAMERA。如果用Manifest.permission.CAMERA也可以,他们是等价的。

静态方法

String QueryName(permission)

查询权限对应的名称,比如Permission.CAMERA对应的名称为相机

String QueryNames(permissions)

获取权限名称列表,如权限名1,权限名2,权限名3,此方法用于方便的生成授权提示信息。

最佳实践

使用默认实现

不重写onTips即为默认实现。

请求授权时直接弹出请求,用户如果点了拒绝(非永久),后续还会弹一次提示,防止误点。如果有被永久拒绝的权限,会弹提示,转到系统设置。

授权前先提示

在调起授权前先弹提示,其他行为和默认实现一样。重写onTips方法:

@Override
protected String onTips(int viewTipsCount, @NonNull ArrayList<String> permissions, boolean isFinal) {
    if(viewTipsCount<=1) {
        return "";
    }
    return null;
}

不授权永远弹提示

如果不授权功能是没法使用的场景,可以一直弹提示,直到用户点击了取消为止(可重写onCancelTips让无法取消,但不建议)。重写onTips方法:

protected String onTips(int viewTipsCount, @NonNull ArrayList<String> permissions, boolean isFinal) {
    if(viewTipsCount>0) {//如果需要授权调起前先提醒,直接把这个if去掉就行了
        return "";
    }
    return null;
}

静默方式授权

如果权限被拒绝,不弹任何提示,也不跳转权限系统设置界面。仅仅用来调起授权请求。但对于需要引导才能进行权限设置的除外(如安装、悬浮窗权限)。重写onTips方法:

protected String onTips(int viewTipsCount, @NonNull ArrayList<String> permissions, boolean isFinal) {
    return null;
}

自定义提示界面

默认实现在弹提示的时候使用的是系统AlertDialog弹框,可重写onTipsDialogView方法来使用自己的提示界面。比如HiPermission的这种蛮美观友好的界面:

这个库不提供界面实现,需要自行实现。

更多实现

参考test_app目录中的MainActivity,里面有已实现的代码。

相关源码请前往Github查阅,如果这个库有帮助到您,请 Star 一下。

原文地址https://www.cnblogs.com/xiangyuecn/p/10495580.html

相关文章
|
4月前
|
物联网 区块链 vr&ar
未来已来:探索区块链、物联网与虚拟现实技术的融合与应用安卓与iOS开发中的跨平台框架选择
【8月更文挑战第30天】在科技的巨轮下,新技术不断涌现,引领着社会进步。本文将聚焦于当前最前沿的技术——区块链、物联网和虚拟现实,探讨它们各自的发展趋势及其在未来可能的应用场景。我们将从这些技术的基本定义出发,逐步深入到它们的相互作用和集成应用,最后展望它们如何共同塑造一个全新的数字生态系统。
|
29天前
|
算法 JavaScript Android开发
|
2月前
|
Java 程序员 API
Android|集成 slf4j + logback 作为日志框架
做个简单改造,统一 Android APP 和 Java 后端项目打印日志的体验。
106 1
|
3月前
|
前端开发 Java 数据库
💡Android开发者必看!掌握这5大框架,轻松打造爆款应用不是梦!🏆
在Android开发领域,框架犹如指路明灯,助力开发者加速应用开发并提升品质。本文将介绍五大必备框架:Retrofit简化网络请求,Room优化数据库访问,MVVM架构提高代码可维护性,Dagger 2管理依赖注入,Jetpack Compose革新UI开发。掌握这些框架,助你在竞争激烈的市场中脱颖而出,打造爆款应用。
390 3
|
3月前
|
存储 API Android开发
"解锁Android权限迷宫:一场惊心动魄的动态权限请求之旅,让你的应用从平凡跃升至用户心尖的宠儿!"
随着Android系统的更新,权限管理成为应用开发的关键。尤其在Android 6.0(API 级别 23)后,动态权限请求机制的引入提升了用户隐私保护,要求开发者进行更精细的权限管理。
72 2
|
3月前
|
编译器 Android开发 开发者
带你了解Android Jetpack库中的依赖注入框架:Hilt
本文介绍了Hilt,这是Google为Android开发的依赖注入框架,基于Dagger构建,旨在简化依赖注入过程。Hilt通过自动化的组件和注解减少了DI的样板代码,提高了应用的可测试性和可维护性。文章详细讲解了Hilt的主要概念、基本用法及原理,帮助开发者更好地理解和应用Hilt。
88 8
|
4月前
|
设计模式 Java Android开发
探索安卓应用开发:从新手到专家的旅程探索iOS开发中的SwiftUI框架
【8月更文挑战第29天】本文旨在通过一个易于理解的旅程比喻,带领读者深入探讨安卓应用开发的各个方面。我们将从基础概念入手,逐步过渡到高级技术,最后讨论如何维护和推广你的应用。无论你是编程新手还是有经验的开发者,这篇文章都将为你提供有价值的见解和实用的代码示例。让我们一起开始这段激动人心的旅程吧!
|
4月前
|
Android开发
我的Android进阶修炼:安卓启动流程之init(1)
本文深入分析了Android系统中的init进程,包括其源码结构、主要功能以及启动流程的详细注解,旨在帮助读者理解init作为用户空间的1号进程在Android启动过程中的关键作用。
75 1
|
4月前
|
Android开发
基于Amlogic 安卓9.0, 驱动简说(三):使用misc框架,让驱动更简单
如何使用Amlogic T972安卓9.0系统上的misc框架来简化驱动程序开发,通过misc框架自动分配设备号并创建设备文件,从而减少代码量并避免设备号冲突。
52 0
基于Amlogic 安卓9.0, 驱动简说(三):使用misc框架,让驱动更简单
|
4月前
|
存储 前端开发 Java
Android MVVM框架详解与应用
在Android开发中,随着应用复杂度的增加,如何有效地组织和管理代码成为了一个重要的问题。MVVM(Model-View-ViewModel)架构模式因其清晰的结构和高效的开发效率,逐渐成为Android开发者们青睐的架构模式之一。本文将详细介绍Android MVVM框架的基本概念、优势、实现流程以及一个实际案例。
119 0