基于 permissionsdispatcher 库，创建的 BasePermissionsActivity 基类。

背景：permissionsdispatcher通过注解的使用方式处理权限申请，在单个页面的时候比较方便。
但是当需要进行权限申请的页面比较多是的时候，每个页面都需要重复相同的代码逻辑。

优点：

  • 直接继承 BasePermissionsActivity
  • 申请默认权限
  • 申请指定权限
  • 重写权限申请成功和失败回调
  • 可重写 onShowRationale() 对用户首次拒绝的权限进行说明

permissionsdispatcher 依赖

  1. dependencies {
  2.     ......
  3.     // 运行时权限
  4.     implementation ("com.github.hotchemi:permissionsdispatcher:3.3.1"){
  5.         exclude module: "support-v13"
  6.     }
  7. }

BasePermissionsActivity 代码

  1. import android.Manifest
  2. import android.support.v7.app.AppCompatActivity
  3. import android.support.v4.app.ActivityCompat
  4. import permissions.dispatcher.*
  5. import android.provider.Settings.ACTION_APPLICATION_DETAILS_SETTINGS
  6. import android.content.Intent
  7. import android.net.Uri
  8. import android.support.v7.app.AlertDialog
  9. /**
  10.  * @author ypw
  11.  * @date 2019-08-29
  12.  * @version 1.11.0
  13.  * @des 动态权限检查基类
  14.  */
  15. abstract class BasePermissionsActivity : AppCompatActivity() {
  17.     /**
  18.      * @author ypw
  19.      * @date 2019-08-29
  20.      * @version 1.11.0
  21.      * @des 默认申请权限
  22.      */
  23.     val needsPermission = arrayOf(
  24.             Manifest.permission.READ_PHONE_STATE,
  25.             Manifest.permission.READ_EXTERNAL_STORAGE,
  26.             Manifest.permission.WRITE_EXTERNAL_STORAGE
  27.     )
  29.     private val requestCode: Int = 0
  31.     /**
  32.      * @author ypw
  33.      * @date 2019-08-29
  34.      * @version 1.11.0
  35.      * @des 请求默认权限
  36.      */
  37.     fun onRequestPermission() {
  38.         onRequestPermission(needsPermission)
  39.     }
  41.     /**
  42.      * @author ypw
  43.      * @date 2019-08-29
  44.      * @version 1.11.0
  45.      * @des 请求指定权限
  46.      */
  47.     fun onRequestPermission(permissions: Array<String>) {
  48.         if (PermissionUtils.hasSelfPermissions(this, *permissions)) {
  49.             onPermissionSuccess()
  50.         } else {
  51.             if (PermissionUtils.shouldShowRequestPermissionRationale(this, *permissions)) {
  52.                 onShowRationale(permissions)
  53.             } else {
  54.                 ActivityCompat.requestPermissions(this, permissions, requestCode)
  55.             }
  56.         }
  57.     }
  59.     /**
  60.      * @author ypw
  61.      * @date 2019-08-29
  62.      * @version 1.11.0
  63.      * @des 权限请求成功后调用
  64.      */
  65.     abstract fun onPermissionSuccess()
  67.     /**
  68.      * @author ypw
  69.      * @date 2019-08-29
  70.      * @version 1.11.0
  71.      * @des 权限请求失败后调用
  72.      */
  73.     abstract fun onPermissionDenied()
  75.     /**
  76.      * @author ypw
  77.      * @date 2019-08-29
  78.      * @version 1.11.0
  79.      * @des 首次权限请求拒绝后，再次权限请求时调用。可向用户进行权限说明
  80.      */
  81.     open fun onShowRationale(permissions: Array<String>) {
  82.         showRationaleDialog {
  83.             ActivityCompat.requestPermissions(this, permissions, requestCode)
  84.         }
  85.     }
  87.     /**
  88.      * @author ypw
  89.      * @date 2019-08-29
  90.      * @version 1.11.0
  91.      * @des 用户拒绝权限请求并勾选不再询问后调用。可向用户进行权限说明，让用户去应用设置打开相应权限
  92.      */
  93.     private fun onNeverAskAgain() {
  94.         showMissingPermissionDialog()
  95.     }
  97.     /**
  98.      * 缺少权限-去APP设置打开
  99.      */
  100.     private fun showMissingPermissionDialog() {
  101.         val builder = AlertDialog.Builder(this)
  102.         builder.setMessage("${getString(R.string.app_name)}缺少必要权限，可能会导致部分功能无法使用\n\n请点击\"设置\"-\"权限\"-打开所需权限")
  103.         builder.setNegativeButton("取消") { _, _ ->
  104.             onPermissionDenied()
  105.         }
  106.         builder.setPositiveButton("设置") { _, _ ->
  107.             startAppSettings()
  108.         }
  109.         builder.setCancelable(false)
  110.         builder.show()
  111.     }
  113.     /**
  114.      * 缺少权限-提示权限说明
  115.      */
  116.     private fun showRationaleDialog(success:() -> Unit) {
  117.         val builder = AlertDialog.Builder(this)
  118.         builder.setMessage("${getString(R.string.app_name)}缺少必要权限，可能会导致部分功能无法使用\n\n请再次确认是否开启")
  119.         builder.setNegativeButton("取消") { _, _ ->
  120.             onPermissionDenied()
  121.         }
  122.         builder.setPositiveButton("去确认") { _, _ ->
  123.             success()
  124.         }
  125.         builder.setCancelable(false)
  126.         builder.show()
  127.     }
  129.     /**
  130.      * 打开系统设置,修改权限
  131.      */
  132.     private fun startAppSettings() {
  133.         val intent = Intent(ACTION_APPLICATION_DETAILS_SETTINGS)
  134.         intent.data = Uri.parse("package:$packageName")
  135.         startActivity(intent)
  136.     }
  138.     override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) {
  139.         super.onRequestPermissionsResult(requestCode, permissions, grantResults)
  140.         if (requestCode == this.requestCode) {
  141.             if (PermissionUtils.verifyPermissions(*grantResults)) {
  142.                 onPermissionSuccess()
  143.             } else {
  144.                 if (!PermissionUtils.shouldShowRequestPermissionRationale(this, *permissions)) {
  145.                     onNeverAskAgain()
  146.                 } else {
  147.                     onPermissionDenied()
  148.                 }
  149.             }
  150.         }
  151.     }
  153. }

简单用例

  1. import android.Manifest
  2. import android.os.Bundle
  3. import android.view.View
  5. class MainActivity : BasePermissionsActivity() {
  7.     override fun onCreate(savedInstanceState: Bundle?) {
  8.         super.onCreate(savedInstanceState)
  9.         setContentView(R.layout.activity_main)
  10.     }
  12.     fun onClick(v: View) {
  13.         val permission = arrayOf(
  14.                 Manifest.permission.READ_PHONE_STATE,
  15.                 Manifest.permission.READ_EXTERNAL_STORAGE,
  16.                 Manifest.permission.WRITE_EXTERNAL_STORAGE
  17.         )
  18.         onRequestPermission(permission)
  19.     }
  21.     override fun onPermissionSuccess() {
  22.         println("权限请求成功")
  23.     }
  25.     override fun onPermissionDenied() {
  26.         println("权限请求失败")
  27.     }
  29. }

运行时权限

  1. group:android.permission-group.CONTACTS
  2. permission:android.permission.WRITE_CONTACTS
  3. permission:android.permission.GET_ACCOUNTS
  4. permission:android.permission.READ_CONTACTS
  6. group:android.permission-group.PHONE
  7. permission:android.permission.READ_CALL_LOG
  8. permission:android.permission.READ_PHONE_STATE
  9. permission:android.permission.CALL_PHONE
  10. permission:android.permission.WRITE_CALL_LOG
  11. permission:android.permission.USE_SIP
  12. permission:android.permission.PROCESS_OUTGOING_CALLS
  13. permission:com.android.voicemail.permission.ADD_VOICEMAIL
  15. group:android.permission-group.CALENDAR
  16. permission:android.permission.READ_CALENDAR
  17. permission:android.permission.WRITE_CALENDAR
  19. group:android.permission-group.CAMERA
  20. permission:android.permission.CAMERA
  22. group:android.permission-group.SENSORS
  23. permission:android.permission.BODY_SENSORS
  25. group:android.permission-group.LOCATION
  26. permission:android.permission.ACCESS_FINE_LOCATION
  27. permission:android.permission.ACCESS_COARSE_LOCATION
  29. group:android.permission-group.STORAGE
  30. permission:android.permission.READ_EXTERNAL_STORAGE
  31. permission:android.permission.WRITE_EXTERNAL_STORAGE
  33. group:android.permission-group.MICROPHONE
  34. permission:android.permission.RECORD_AUDIO
  36. group:android.permission-group.SMS
  37. permission:android.permission.READ_SMS
  38. permission:android.permission.RECEIVE_WAP_PUSH
  39. permission:android.permission.RECEIVE_MMS
  40. permission:android.permission.RECEIVE_SMS
  41. permission:android.permission.SEND_SMS
  42. permission:android.permission.READ_CELL_BROADCASTS

普通权限

  1. ACCESS_LOCATION_EXTRA_COMMANDS 定位权限
  2. ACCESS_NETWORK_STATE 网络状态权限
  3. ACCESS_NOTIFICATION_POLICY 通知 APP通知显示在状态栏
  4. ACCESS_WIFI_STATE WiFi状态权限
  5. BLUETOOTH 使用蓝牙权限
  6. BLUETOOTH_ADMIN 控制蓝牙开关
  7. BROADCAST_STICKY 粘性广播
  8. CHANGE_NETWORK_STATE 改变网络状态
  9. CHANGE_WIFI_MULTICAST_STATE 改变WiFi多播状态，应该是控制手机热点（猜测）
  10. CHANGE_WIFI_STATE 控制WiFi开关，改变WiFi状态
  11. DISABLE_KEYGUARD 改变键盘为不可用
  12. EXPAND_STATUS_BAR 扩展bar的状态
  13. GET_PACKAGE_SIZE 获取应用安装包大小
  14. INTERNET 网络权限
  15. KILL_BACKGROUND_PROCESSES 杀死后台进程
  16. MODIFY_AUDIO_SETTINGS 改变音频输出设置
  17. NFC 支付
  18. READ_SYNC_SETTINGS 获取手机设置信息
  19. READ_SYNC_STATS 数据统计
  20. RECEIVE_BOOT_COMPLETED 监听启动广播
  21. REORDER_TASKS 创建新栈
  22. REQUEST_INSTALL_PACKAGES 安装应用程序
  23. SET_TIME_ZONE 允许应用程序设置系统时间区域
  24. SET_WALLPAPER 设置壁纸
  25. SET_WALLPAPER_HINTS 设置壁纸上的提示信息，个性化语言
  26. TRANSMIT_IR 红外发射
  27. USE_FINGERPRINT 指纹识别
  28. VIBRATE 震动
  29. WAKE_LOCK 锁屏
  30. WRITE_SYNC_SETTINGS 改变设置
  31. SET_ALARM 设置警告提示
  32. INSTALL_SHORTCUT 创建快捷方式
  33. UNINSTALL_SHORTCUT 删除快捷方式
  35. 以上这些只是普通权限，我们开发的时候，正常使用就行了，需要的权限在清单文件配置即可。