運行時權(quán)限
從 Android 6.0（API 級別 23）開始，用戶開始在應(yīng)用運行時向其授予權(quán)限侯勉，而不是在應(yīng)用安裝時授予。
系統(tǒng)權(quán)限分為兩類：
- 正常權(quán)限：只需在你應(yīng)用的 Androidmanifest.xml 中列出债蓝，安裝時授權(quán)壳鹤。
- 危險權(quán)限：需要在你應(yīng)用的 Androidmanifest.xml 中列出，并在運行時授權(quán)饰迹。
如需了解更多關(guān)于正常權(quán)限與危險權(quán)限可以參閱這里芳誓。
運行時權(quán)限的加入增加了用戶隱私的安全啊鸭，但同時也給開發(fā)者帶來了一些負擔锹淌，因為多了檢查權(quán)限，請求權(quán)限赠制，處理權(quán)限請求響應(yīng)的步驟赂摆。
于是就出現(xiàn)了一些框架，用于簡化運行時權(quán)限的處理钟些，如 PermissionsDispatcher烟号，Dexter，RxPermissions政恍，easypermissions 等汪拥。
這里只用過 easypermissions 和 PermissionsDispatcher，最終選擇了 PermissionsDispatcher篙耗，原因是使用人數(shù)最多迫筑，api 設(shè)計簡單易用，兼容性較好宗弯，easypermissions 使用起來相對麻煩一些脯燃。
PermissionsDispatcher
PermissionsDispatcher 提供簡單的基于注解的 api 處理 Android Marshmallow 下的運行時權(quán)限（非反射方式）。
一. 集成說明
注意把 ${latest.version} 改為最新版本蒙保。
打開命令行辕棚，cd 到工程根目錄，執(zhí)行 gradlew -version 或者 gradlew -v 命令查看當前工程 gradle 版本邓厕。
根據(jù) gradle 版本進行如下配置：
Android Gradle Plugin >= 2.2
在 app 模塊下的 build.gradle 添加下面的配置：
dependencies {
compile 'com.github.hotchemi:permissionsdispatcher:${latest.version}'
annotationProcessor 'com.github.hotchemi:permissionsdispatcher-processor:${latest.version}'
}
Android Gradle Plugin < 2.2
在 project-level 下的 build.gradle 添加下面配置：
buildscript {
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
}
然后逝嚎，在 app 模塊下的 build.gradle 添加下面配置：
apply plugin: 'android-apt'
dependencies {
compile 'com.github.hotchemi:permissionsdispatcher:${latest.version}'
apt 'com.github.hotchemi:permissionsdispatcher-processor:${latest.version}'
}
二. 使用說明
1. 添加注解
注意：注解的方法不能是 private 的。
相關(guān)注解說明
| 注解 | 是否必須 | 描述 |
|---|---|---|
@RuntimePermissions |
? | 注冊一個 Activity 或 Fragment 用于處理權(quán)限 |
@NeedsPermission |
? | 注解一個方法邑狸，說明需要什么權(quán)限（一個或多個） |
@OnShowRationale |
注解一個方法懈糯，解釋為什么需要這些權(quán)限 | |
@OnPermissionDenied |
注解一個方法涤妒，當用戶拒絕授權(quán)時將調(diào)用該方法 | |
@OnNeverAskAgain |
注解一個方法单雾，當用戶選擇了 "不再提醒" 將調(diào)用該方法 |
示例代碼
@RuntimePermissions
public class MainActivity extends AppCompatActivity {
// 單個權(quán)限
// @NeedsPermission(Manifest.permission.CAMERA)
// 多個權(quán)限
@NeedsPermission({ Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO })
void showCamera() {
getSupportFragmentManager().beginTransaction()
.replace(R.id.sample_content_fragment, CameraPreviewFragment.newInstance())
.addToBackStack("camera")
.commitAllowingStateLoss();
}
// 向用戶說明為什么需要這些權(quán)限（可選）
@OnShowRationale(Manifest.permission.CAMERA)
void showRationaleForCamera(final PermissionRequest request) {
new AlertDialog.Builder(this)
.setMessage(R.string.permission_camera_rationale)
.setPositiveButton(R.string.button_allow, (dialog, button) -> request.proceed())
.setNegativeButton(R.string.button_deny, (dialog, button) -> request.cancel())
.show();
}
// 用戶拒絕授權(quán)回調(diào)（可選）
@OnPermissionDenied(Manifest.permission.CAMERA)
void showDeniedForCamera() {
Toast.makeText(this, R.string.permission_camera_denied, Toast.LENGTH_SHORT).show();
}
// 用戶勾選了“不再提醒”時調(diào)用（可選）
@OnNeverAskAgain(Manifest.permission.CAMERA)
void showNeverAskForCamera() {
Toast.makeText(this, R.string.permission_camera_neverask, Toast.LENGTH_SHORT).show();
}
}
2. 調(diào)用自動生成的輔助類
注解寫好后，Build ——> Make Module ***，PermissionsDispatcher 會生成一個 MainActivityPermissionsDispatcher(Activity Name + PermissionsDispatcher)硅堆，你可以使用它來安全地訪問這些受權(quán)限保護的方法屿储。
你唯一需要做的一件事是將工作委托給這個輔助類：
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
findViewById(R.id.button_camera).setOnClickListener(v -> {
// 調(diào)用帶權(quán)限檢查的 showCamera 方法
MainActivityPermissionsDispatcher.showCameraWithCheck(this);
});
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
// 代理權(quán)限處理到自動生成的方法
MainActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
}
*PermissionDispatcher.*WithCheck 方法對你原來的方法進行了包裝，包了一層權(quán)限檢查的代碼渐逃，你需要做的就是把原來的方法調(diào)用改為 *PermissionDispatcher.*WithCheck够掠。另外，在 onRequestPermissionsResult 中回調(diào) *PermissionsDispatcher.onRequestPermissionsResult 方法茄菊。
三. 獲取特殊權(quán)限
兩個特殊權(quán)限：
-
Manifest.permission.SYSTEM_ALERT_WINDOW：顯示懸浮窗 -
Manifest.permission.WRITE_SETTINGS：讀寫系統(tǒng)設(shè)置
對于這兩個權(quán)限疯潭，在 Android 下默認是需要到 Settings -> Apps 中手動授權(quán)的。由于不同 ROM 情況可能還有點不一樣面殖。
PermissionsDispatcher 對于兩個特殊權(quán)限也做了兼容處理（Android6.0+）竖哩，使用方法如上一樣。
如果需要兼容低版本的 Android 系統(tǒng)或者不同 ROM 可以參考這個開源項目脊僚。
四. maxSdkVersion
<uses-permission> 有一個 maxSdkVersion 屬性相叁，PermissionsDispatcher 對它也做了支持。
比如辽幌，在 Androidmanifest.xml 中定義了如下權(quán)限：
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
android:maxSdkVersion="18" />
注解中添加 maxSdkVersion：
@RuntimePermissions
public class MainActivity extends AppCompatActivity {
@NeedsPermission(value = Manifest.permission.WRITE_EXTERNAL_STORAGE, maxSdkVersion = 18)
void getStorage() {
// ...
}
}
PermissionsDispatcher Plugin
PermissionsDispatcher Plugin 是 PermissionsDispatcher 的輔助插件增淹，支持自動生成權(quán)限檢查相關(guān)代碼。
項目地址：https://github.com/shiraji/permissions-dispatcher-plugin
安裝說明：Android Studio 中打開 Setting乌企，
Plugins ——> Browse repositories...搜索PermissionsDispatcher plugin虑润，點 Install 下載安裝，安裝完成后重啟生效逛犹。
使用說明：
- 在 Activity/Fragment 中端辱，Generate -> Generate Runtime Permissions...
- 選擇權(quán)限并為每個注解輸入方法名
- 點擊 Generate ，完成
使用過程中發(fā)現(xiàn)有兩個小問題需要注意一下：
- 多次生成代碼虽画，
onRequestPermissionsResult方法也會被自動添加多次 - 代碼生成后會提示你是否 rebuild 工程舞蔽，建議選擇取消，
Build ——> Make Module ***相對快些
