本库是使用Kotlin语音开发的。可以优雅的申请Android6.0中的动态权限。
点击下载或扫码下载DemoApk
- 修复在某为手机上Fragment的事物执行完毕后并没有立即执行Fragment的onCreate声明周期而导致的Bug。
- 适配registerForActivityResult。
- 仅支持FragmentActivity的子类和AndroidX中的Fragment。
- 修复检测GPS开关开启状态不准确的Bug。
- 修复因权限路由销毁时机不正确而导致的Bug:IllegalStateException: Fragment AndroidxPermissionRouter。
1.onReslult回调的result处理逻辑。
1.优化startActivity接口。
- 修复使用时在Fragment中使用Activity创建OkPermission会出现IllegalStateException: FragmentManager is already executing transactions的Bug。
- 优化代码逻辑，提升性能增加健壮性、稳定性。
修复使用时偶现IllegalStateException: FragmentManager is already executing transactions的Bug。
修复在Fragment中使用时会出现IllegalStateException: FragmentManager is already executing transactions的Bug。
1.增加自定义权限OkPermission.permission.GPS，用法和普通权限一样，支持检测是否已经授权，支持检测并申请(如果用户没有打开GPS开关则会引导用户去开启)。
2.增加isGranted():Boolean方法，用于判断权限是否已经被授权,以及checkAndApplyOnly()方法用户只申请权限不关心结果。
3.将经常需要在一起申请的权限进行编组，方便调用(后续会不断增加)。具体如下：
//包含Manifest.permission.READ_EXTERNAL_STORAGE, Manifest.permission.WRITE_EXTERNAL_STORAGE两个权限。
OkPermission.permission_group.EXTERNAL_STORAGE
//包含OkPermission.permission_group.EXTERNAL_STORAGE权限组外加Manifest.permission.CAMERA权限。
OkPermission.permission_group.CAMERA_FOR_PICTURE
//包含OkPermission.permission_group.CAMERA_FOR_PICTURE权限组外加Manifest.permission.RECORD_AUDIO权限。
OkPermission.permission_group.CAMERA_FOR_VIDEO
//包含Manifest.permission.ACCESS_COARSE_LOCATION, Manifest.permission.ACCESS_FINE_LOCATION两个权限。
OkPermission.permission_group.ACCESS_LOCATION增加对Manifest.permission.WRITE_SETTINGS权限的适配
由于在某些场景下我们要启动的页面并不是我们自己的页面，而是系统页面或者是第三方应用的页面，而这种情况下我们只能且必须得到Intent。 此时我们只需要将泛型设置为Intent即可，栗子：
OkActivityResult.startActivity<Intent>(activity, Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI)) { resultCode, data ->
if (resultCode == Activity.RESULT_OK && data != null) {
val pictureUri = data.data
//do something use the pictureUri.
}
}1.从3.1.0开始，全面迁移至Androidx，如果您的项目还没有迁移至Androidx请使用3.0.4或之前的版本。
2.更加好用的OkActivityResult,result回调不再返回Intent，而是直接返回通过泛型指定数据类型。 您需要在要返回结果的页面调用OkActivityResult.setResultData(activity, data)方法为调起页面返回数据(推荐)， 或则使用OkActivityResult.KEY_RESULT_DATA作为键为Intent塞值。
3.为OkActivityResult的startActivity方法和startActivityOrException方法分别增加不需要携带数据的回调重 载(如果你只需要关心ResultCode不需要带回任何数据可以使用，这样你就无需指定泛型，简化代码书写)。
1.为with方法增加一个参数为Context的重载，将是否为Activity的判断进行内聚。
2.OkActivityResult启动Activity时支持options参数，且无需做版本判断。
3.OkActivityResult增加一系列setResult方法以及getResultData方法，使其更加易用。
4.启动Activity后的回调函数中默认不再有Exception，并将方法名更改为"startActivity"和“startActivityOrException”。
修复8.0以下申请通知权限时如果设置了Channel的话会导致多次打开通知权限设置页面的bug。
优化通知权限的申请，将检查权限由回调的方式改为返回的方式。
对外暴露检测权限的接口。
适配悬浮窗权限、通知权限，框架重构，扩展性强。
适配Android8.0的Apk安装权限。
增加自定义弹窗的接口，支持自定义弹窗。
优化权限申请流程。
allprojects {
repositories {
//... 省略N行代码
maven { url 'https://jitpack.io' }
}
}dependencies {
implementation 'com.github.kelinZhou:OkPermission:${Last Version Here!}'
}例如下面获取拨打电话和调用相机的权限。
OkPermission.with(this)
.addDefaultPermissions(
Manifest.permission.CALL_PHONE,
Manifest.permission.CAMERA
).checkAndApply { granted, permissions ->
if (granted) {
Toast.makeText(this, "权限已全部获取", Toast.LENGTH_SHORT).show()
} else {
Toast.makeText(this, "未获取全部权限", Toast.LENGTH_SHORT).show()
}
}当用户拒绝权限且不再提醒后会引导用户前往设置页面。引导时会有弹窗，而这个弹窗是可以自定义的。 如果要自定义可以向下面这样。
OkPermission.with(this)
.addDefaultPermissions(
Manifest.permission.CALL_PHONE,
Manifest.permission.CAMERA
)
.interceptMissingPermissionDialog {
AlertDialog.Builder(this)
.setCancelable(false)
.setTitle("帮助")
.setMessage("缺少拨打电话和拍照权限，请前往设置。")
.setNegativeButton("退出") { _, _ ->
it.continueWorking(false)
}
.setPositiveButton("设置") { _, _ ->
it.continueWorking(true)
}.show()
}.checkAndApply { granted, permissions ->
if (permissions.isEmpty()) {
Toast.makeText(this, "权限已全部获取", Toast.LENGTH_SHORT).show()
} else {
Toast.makeText(this, "未获取全部权限", Toast.LENGTH_SHORT).show()
}
}支持APK安装权限，且已适配我手头上现有的手机。
OkPermission.with(this)
.addDefaultPermissions(Manifest.permission.REQUEST_INSTALL_PACKAGES)
.checkAndApply { granted, permissions ->
if (granted) {
Toast.makeText(this, "可以安装APK了", Toast.LENGTH_SHORT).show()
} else {
Toast.makeText(this, "没有安装APK权限", Toast.LENGTH_SHORT).show()
}
}支持通知权限且支持Android8.0中Channel且支持多个Channel。
OkPermission.with(this)
.addNotificationPermission(false, "Channel1", "Channel2", "Channel3"/*ChannelN ……*/)
.checkAndApply { granted, permissions ->
if (granted) {
Toast.makeText(this, "用户已同意了全部的通知权限", Toast.LENGTH_SHORT).show()
} else {
Toast.makeText(this, "用户拒绝了通知权限", Toast.LENGTH_SHORT).show()
}
}支持悬浮窗权限。
OkPermission.with(this)
.addDefaultPermissions(Manifest.permission.SYSTEM_ALERT_WINDOW)
.checkAndApply { granted, permissions ->
if (granted) {
Toast.makeText(this, "悬浮窗权限已开启", Toast.LENGTH_SHORT).show()
} else {
Toast.makeText(this, "悬浮窗权限已禁用", Toast.LENGTH_SHORT).show()
}
}支持检测某些权限是否已开启。
val granted = OkPermission.with(this)
.addDefaultPermissions(
Manifest.permission.CALL_PHONE,
Manifest.permission.CAMERA,
Manifest.permission.REQUEST_INSTALL_PACKAGES
).check()
.isEmpty()
if (granted) {
Toast.makeText(this, "可以使用全部的权限", Toast.LENGTH_SHORT).show()
}支持跳转到指定的权限设置页面，且已适配目前手头上的全部手机。
//跳转到权限设置页面，如果跳转失败则会跳转到应用详情页。
OkPermission.gotoPermissionSettingPage(this)
//跳转到Apk安装权限设置页面，需要判断当前SDK版本。
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
OkPermission.gotoInstallPermissionPage(this)
} else {
Toast.makeText(this, "当前系统版本过低", Toast.LENGTH_SHORT).show()
}
//跳转到通知权限设置页面，可以指定ChannelId，如果指定这跳转到指定Channel的通知设置页面，如果不指定这跳转到通知的总开关设置页面。
OkPermission.gotoNotificationPermissionPage(this/*, "ChannelId"*/)
//跳转到悬浮窗权限设置页面。
OkPermission.gotoSystemWindowPermissionPage(this)所有设置页面的跳转均已适配我手头上现有的手机，如果你发现了未适配的手机可以通过自定义SettingIntentGenerator类来实现，并请求你将适配代码
也就是你自定义的SettingIntentGenerator类贴到Issues里面或发送到我邮箱kelin410@163.com，万分感谢。
下面是自定义SettingIntentGenerator的用法。
OkPermission.with(this)
.addDefaultPermissions(
Manifest.permission.CALL_PHONE,
Manifest.permission.CAMERA
).interceptSettingIntentGenerator { permission ->
if (isMiUi10) {//先判读是不是自己想要拦截的系统
MiUi10SettingIntentGenerator() //返回你的适配方案。
} else {
null
}
}
.checkAndApply { granted, permissions ->
if (granted) {
Toast.makeText(this, "权限已全部获取", Toast.LENGTH_SHORT).show()
} else {
Toast.makeText(this, "未获取全部权限", Toast.LENGTH_SHORT).show()
}
}为了监听某个权限设置页面用户操作后(执行onActivityResult方法时)重新校验权限是否已经开启，所以内部封装了一个具有完善的功能的处理onActivityResult组件， 核心类为OkActivityResult。使用该组件可以通过回调的方式接受到onActivityResult的数据，并且可以直接通过泛型指定数据类型，避免类型强转。
####使用方法 当你需要调起某个目标页面而不需要向目标页面传递任何数据且不需要从目标页面获取数据时。
OkActivityResult.startActivity(this, MainActivity::class.java) { resultCode ->
if (resultCode == Activity.RESULT_OK) {
//Do something……
}
}当你需要调起某个目标页面而不需要向目标页面传递任何数据但需要从目标页面获取数据时。
OkActivityResult.startActivity<Person>(this, PersonSelectorActivity::class.java) { resultCode, person ->
if (person != null) {
//Do something……
}
}如果你需要向目标页面传递一些数据你只需要将kotlin XXXActivity::class.java替换成Intent即可。
val intent = Intent(this, PersonSelectorActivit::class.java)
intent.putExtra("age", 18)
OkActivityResult.startActivity(this, intent) { resultCode, person ->
if (person != null) {
//Do something……
}
}如果你不确定你要调起的某个页面是否存在，当不存在时你需要自己处理异常时，你需要调用kotlin startActivityOrException方法。
OkActivityResult.startActivityOrException(this, Intent(Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES, Uri.parse("package:${context.packageName}"))) { resultCode, e ->
if (e != null) {
// Handle Activity not found.
} else {
//Do something……
}
}补充你需要在目标页面中调用kotlin OkActivityResult.setResultData(activity, person)方法才能在发起页面获取到数据。
如果你觉得该库对你有用，欢迎给和Star。如果你有新的适配代码也感谢提供(提交Issues或发邮件给我都行)。感谢！！！
Copyright 2016 kelin410@163.com
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.