GoogleSample之Easypermission权限申请使

2017-04-23 本文已影响150人施斌

项目地址:https://github.com/googlesamples/easypermissions

有什么用?

方便开发者为App申请权限

情况是这样的

试想一下,一个App在未经允许的情况下,能获取你的联系人资料,用相机给你拍照上传,这是多么危险的一件事情.支付宝就有这么一个操作,用前置相机悄悄的给你拍照上传.某个版本还能听到"卡擦"一声

Android在发布6.0时,加入了这样一个功能,对于手机的某些敏感资源,如相机,麦克风,联系人资料,电话,短信,相册...需要用户同意,App才能拥有使用相关资源的能力

哪些是权限是需要申请的?

官方文档:https://developer.android.google.cn/guide/topics/security/permissions.html#normal-dangerous

Paste_Image.png

CALENDAR(日历)
CAMERA(相机)
CONTACTS(联系人)
MICROPHONE(音频录制)
PHONE(手机相关)
SENSORS(传感器)
SMS(短信)
STORAGE(存储)

Note:

Android 6.0以前,在项目Manifest.xml文件中添加权限,说明这个App已经有这个权限了,而现在,对于这些危险权限来说,在Manifest中只能算是声明,去告诉系统,这个App需要这个权限,但有没有这个权限,用户来决定.

在Android 6.0版本不写权限申请会怎样?

如果一个App没有相机的权限而去直接调用相机的功能.直接的结果是:导致App崩溃,所以,时常会在App评论中看到:"太流氓了,不给权限就崩溃",类似的评论

怎么用?

1. 引入EasyPermission

dependencies {
  compile 'pub.devrel:easypermissions:0.3.0'
}

2. 重写Activity或Fragment中的onRequestPermissionsResult方法

并在其中调用EasyPermissions.onRequestPermissionsResult来请求回调,必需加

public class UseEasyPermissionMainActivity extends AppCompatActivity {

  private static final String TAG = "UseEasyPermission";
  private static final int RC_CAMERA_AND_RECORD_AUDIO = 10000;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
  }

  @Override
  public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    // Forward results to EasyPermissions
    EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
  }
}

3. 实现EasyPermissions.PermissionCallbacks接口,实现两个方法:

onPermissionsGranted权限申请成功的回调
onPermissionsDenied权限申请拒绝的回调

实际情况是这样,如果我要用相机,首先要去判断有没有相机权限,有就直接开启相机,没有就去申请权限

public class MainActivity extends AppCompatActivity implements EasyPermissions.PermissionCallbacks {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    findViewById(R.id.btn_requst).setOnClickListener(new View.OnClickListener() {
      @Override
      public void onClick(View v) {
        requestPermissions();
      }
    });
  }

  @Override
  public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    // Forward results to EasyPermissions
    EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
  }

  /**
  * 去申请权限
  */
  private void requestPermissions() {
    String[] perms = {Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO};

    //判断有没有权限
    if (EasyPermissions.hasPermissions(this, perms)) {
      // 如果有权限了, 就做你该做的事情
      openCamera();
    } else {
      // 如果没有权限, 就去申请权限
      // this: 上下文
      // Dialog显示的正文
      // RC_CAMERA_AND_RECORD_AUDIO 请求码, 用于回调的时候判断是哪次申请
      // perms 就是你要申请的权限
      EasyPermissions.requestPermissions(this, "写上你需要用权限的理由, 是给用户看的", RC_CAMERA_AND_RECORD_AUDIO, perms);
    }
  }
  /**
  * 权限申请成功的回调
  *
  * @param requestCode 申请权限时的请求码
  * @param perms 申请成功的权限集合
  */
  @Override
  public void onPermissionsGranted(int requestCode, List<String> perms) {
    Log.i(TAG, "onPermissionsGranted: ");
    openCamera();
  }

  /**
  * 权限申请拒绝的回调
  *
  * @param requestCode 申请权限时的请求码
  * @param perms 申请拒绝的权限集合
  */
  @Override
  public void onPermissionsDenied(int requestCode, List<String> perms) {
     Log.i(TAG, "onPermissionsDenied: ");
  }
}

这时候可以把打开相机调用的代码放在onPermissionsGranted中,如果你同时申请了多个权限,也可以在回调中判断做相应的操作:

/**
* 权限申请成功的回调
*
* @param requestCode 申请权限时的请求码
* @param perms 申请成功的权限集合
*/
@Override
public void onPermissionsGranted(int requestCode, List<String> perms) {
  Log.i(TAG, "onPermissionsGranted: ");
  if (requestCode != RC_CAMERA_AND_RECORD_AUDIO) {
    return;
  }
  for (int i = 0; i < perms.size(); i++) {
    if (perms.get(i).equals(Manifest.permission.CAMERA)) {
      Log.i(TAG, "onPermissionsGranted: " + "相机权限成功");
      openCamera();

    } else if (perms.get(i).equals(Manifest.permission.RECORD_AUDIO)) {
      Log.i(TAG, "onPermissionsGranted: " + "录制音频权限成功");
    }
  }
}

/**
* 权限申请拒绝的回调
*
* @param requestCode 申请权限时的请求码
* @param perms 申请拒绝的权限集合
*/
@Override
public void onPermissionsDenied(int requestCode, List<String> perms) {
  Log.i(TAG, "onPermissionsDenied: ");

  if (requestCode != RC_CAMERA_AND_RECORD_AUDIO) {
    return;
  }

  for (int i = 0; i < perms.size(); i++) {
    if (perms.get(i).equals(Manifest.permission.CAMERA)) {
      Log.i(TAG, "onPermissionsDenied: " + "相机权限拒绝");
    } else if (perms.get(i).equals(Manifest.permission.RECORD_AUDIO)) {
      Log.i(TAG, "onPermissionsDenied: " + "录制音频权限拒绝");
    }
  }
}

还有一个问题是:如果权限申请对话一直弹,用户也觉得烦,这时候Android在对话框上加了一个不在询问的勾选框,这时候在怎么requestPermission都不会弹出那个让用户选择允许或者拒绝的对话框了.App还需要使用相机的权限只能去:设置->应用->当前应用->权限,里面去开启权限,这时候可以在申请拒绝的回调onPermissionsDenied中做相应的引导操作:转跳到设置页面去手动开启权限.

/**
* 权限申请拒绝的回调
*
* @param requestCode 申请权限时的请求码
* @param perms 申请拒绝的权限集合
*/
@Override
public void onPermissionsDenied(int requestCode, List<String> perms) {
  Log.i(TAG, "onPermissionsDenied: ");
  //如果有一些权限被永久的拒绝, 就需要转跳到 设置-->应用-->对应的App下去开启权限
  if (EasyPermissions.somePermissionPermanentlyDenied(this, perms)) {
    new AppSettingsDialog.Builder(this)
      .setTitle("权限已经被您拒绝")
      .setRationale("如果不打开权限则无法使用该功能,点击确定去打开权限")
      .setRequestCode(10001)//用于onActivityResult回调做其它对应相关的操作
      .build()
      .show();
  }
}

最后,从设置页面转跳回来也可以做一些相应的操作

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  if (requestCode == 10001) {
    Toast.makeText(this, " 从开启权限的页面转跳回来 ", Toast.LENGTH_SHORT).show();
  }
}

所有流程图大致如下

EasyPermission.png

图中1,2,3所指情况:

App从未申请过权限,第一次申请权限时
App权限申请被拒绝过
App申请权限时,用户勾选了不在询问选项,并拒绝

最后EasyPermission还提供了一个可供选择的注解:AfterPermissionGranted

方法注解,注解中参数是申请权限的请求码.
被@AfterPermissionGranted注解的方法会在请求码中的所有权限申请成功之后被调用

/**
* 去申请权限
*/
@AfterPermissionGranted(RC_CAMERA_AND_RECORD_AUDIO)
private void requestPermissions() {
  String[] perms = {Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO};

  //判断有没有权限
  if (EasyPermissions.hasPermissions(this, perms)) {
    // 如果有权限了, 就做你该做的事情
    // doing something
    openCamera();
  } else {
    // 如果没有权限, 就去申请权限
    // this: 上下文
    // Dialog显示的正文
    // RC_CAMERA_AND_RECORD_AUDIO 请求码, 用于回调的时候判断是哪次申请
    // perms 就是你要申请的权限
    EasyPermissions.requestPermissions(this, "写上你需要用权限的理由, 是给用户看的", RC_CAMERA_AND_RECORD_AUDIO, perms);
  }
}

代码地址:https://github.com/Shib90/EasyPermissionDemo