在上一篇中簡單介紹了運行時權(quán)限借跪,今天就講講怎么去申請權(quán)限。這個項目中本來用了一個第三方的權(quán)限框架酌壕,但是不太好用掏愁,我就在github上選擇了start最多的PermissionsDispatcher 歇由。這個框架非常好用,下面來了解下它的用法果港。
配置
首先呢就是在項目的build.gradle文件里添加
dependencies {
compile("com.github.hotchemi:permissionsdispatcher:${latest.version}") {
// if you don't use android.app.Fragment you can exclude support for them
exclude module: "support-v13"
}
annotationProcessor "com.github.hotchemi:permissionsdispatcher-processor:${latest.version}"
}
repositories {
jcenter()
maven { url 'http://oss.jfrog.org/artifactory/oss-snapshot-local/' }
}
其中${latest.version}要換成版本號沦泌,當(dāng)前最新的版本號為3.0.1 。Rebuild一下工程就好了辛掠。
介紹
注解 | 是否必須 | 描述 |
---|---|---|
@RuntimePermissions | ? | 注冊一個 Activity 或 Fragment 用于處理權(quán)限 |
@NeedsPermission | ? | 注解一個方法谢谦,說明需要什么權(quán)限(一個或多個) |
@OnShowRationale | 注解一個方法,解釋為什么需要這些權(quán)限 | |
@OnPermissionDenied | 注解一個方法萝衩,當(dāng)用戶拒絕授權(quán)時將調(diào)用該方法 | |
@OnNeverAskAgain | 注解一個方法回挽,當(dāng)用戶選擇了 "不再提醒" 將調(diào)用該方法 |
示例
@RuntimePermissions
public class UserInfoTokenActivity extends BaseActivity{
...
@NeedsPermission(Manifest.permission.CAMERA)
void openCamera() {
UtilTools.getImageFromCamera(this);
}
@OnShowRationale(Manifest.permission.CAMERA)
void showRationale(final PermissionRequest request) {
request.proceed();
}
@OnPermissionDenied(Manifest.permission.CAMERA)
void showDeniedForStorage() {
AppUtils.showRequestPermissionDialog(this, String.format(
getString(R.string.camera_permission_message), getString(R.string.app_name)));
}
@OnNeverAskAgain(Manifest.permission.CAMERA)
void showNeverAskForStorage() {
AppUtils.showRequestPermissionDialog(this, String.format(
getString(R.string.camera_permission_message), getString(R.string.app_name)));
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
UserInfoTokenActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
}
...
}
注意:
- 類前加RuntimePermissions注解;
- 加注解的方法千萬不要寫成private
- OnShowRationale注解的方法有參數(shù)猩谊,開始我沒注意千劈,怎么也不能生成UserInfoTokenActivityPermissionsDispatcher這個類;
- 不要直接調(diào)用注解的方法牌捷,要通過如下方式調(diào)用:
UserInfoTokenActivityPermissionsDispatcher.
openCameraWithPermissionCheck(UserInfoTokenActivity.this);
效果
調(diào)用需要權(quán)限的方法(用NeedsPermission注解的)時墙牌,如果已經(jīng)授予該權(quán)限,直接執(zhí)行這個方法暗甥,如果沒有該權(quán)限喜滨,會彈出授權(quán)提示框:
點擊按鈕會執(zhí)行OnShowRationale注解的方法,我這個里邊就讓方法繼續(xù)執(zhí)行了撤防,即顯示拍照虽风。如果點擊“拒絕”就會執(zhí)行OnPermissionDenied注解的方法,我這個方法里是仿照微信寫的即碗,彈出提示框焰情,如下:
其中,AppUtils代碼如下:
import android.app.AlertDialog;
import android.content.Context;
import android.content.DialogInterface;
import android.content.Intent;
import android.provider.Settings;
import android.support.v4.content.ContextCompat;
/**
* 作者:WangJintao
* 時間:2017/10/13
* 郵箱:wangjintao1988@163.com
*/
public class AppUtils {
public static void showRequestPermissionDialog(final Context context, String message) {
AlertDialog dialog = new AlertDialog.Builder(context).setPositiveButton(context.getString(R.string.go_setting), new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
//打開應(yīng)用列表
AppUtils.openAppSettingList(context);
dialog.dismiss();
}
})
.setNegativeButton(context.getString(R.string.cancel), new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
dialog.dismiss();
}
})
.setCancelable(false)
.setMessage(message)
.setTitle(R.string.permission_title)
.show();
//設(shè)置按鈕顏色
dialog.getButton(AlertDialog.BUTTON_NEGATIVE).setTextColor(ContextCompat.getColor(context, R.color.black));
dialog.getButton(AlertDialog.BUTTON_POSITIVE).setTextColor(ContextCompat.getColor(context, R.color.main_color));
}
public static void openAppSettingList(Context context) {
Intent intent = new Intent(Settings.ACTION_APPLICATION_SETTINGS);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
}
}
點擊“不再詢問”執(zhí)行OnNeverAskAgain注解的方法剥懒,參考微信執(zhí)行的也是彈出提示框内舟。
關(guān)于應(yīng)用安裝時權(quán)限申請的說明
在我這個APP里,定位和電話權(quán)限是必須的初橘,所以安裝后就必須申請验游,PermissionsDispatcher可以同時申請多個權(quán)限,但是我沒這樣用保檐,我還是用的一個個申請耕蝉,先去申請電話權(quán)限,如果用戶點擊“拒絕”彈出提示框夜只,用戶再點擊提示框中的取消垒在,就關(guān)閉這個APP,點擊去設(shè)置再跳轉(zhuǎn)到設(shè)置界面扔亥,如果開始用戶就點擊了“允許”场躯,然后再去申請定位權(quán)限谈为,運行效果與微信一致。