在鴻蒙系統上實現權限請求框架—桃夭權限請求框架
本文正在參與優質創作者激勵
一、簡介
桃夭是鴻蒙系統上的一款權限請求框架，對請求權限的代碼進行高度封裝，極大的簡化了申請權限的代碼邏輯，同時支持在Ability、FractionAbility、AbilitySlice、Fractiion里面申請權限。
二、源碼
建議大家把源碼下載下來看看。
三、申請權限的一般步驟
- 判斷是否有權限，如果有權限，直接進行下一步。
- 如果沒有權限，可以彈窗告知用戶申請權限的原因。
- 彈窗告知用戶后，如果用戶同意申請權限，則判斷用戶是否點擊了不再提醒。
- 如果用戶沒有點擊不再提醒，則開始申請權限。
- 如果用戶點擊了不再提醒，則彈窗告知用戶去設置頁面開啟權限，用戶點擊彈窗后，跳轉到設置頁面。
- 重寫onRequestPermissionsFromUserResult方法，判斷用戶是否授予權限。
每次申請權限的時候，都需要經過以上幾個步驟，當申請的權限越來越多，大量的重復代碼就出現了。為了減少重復代碼，我封裝了一個權限請求框架，權限請求框架取名為桃夭。
四、桃夭的使用方式
如下代碼，先添加依賴，然后你只需要告知權限請求框架你需要什么權限，權限請求框架就會告知你權限申請成功還是失敗。你不需要手動判斷是否有權限，不需要彈窗告知用戶申請權限的原因，不需要判斷用戶是否點擊了不再提醒，不需要跳轉設置頁面讓用戶開啟權限，不需要重寫onRequestPermissionsFromUserResult方法。框架把這些代碼邏輯都給做了，你只需要關注權限申請成功還是失敗。
申請權限變得如此之簡單。
添加依賴
- api 'io.gitee.zhongte:taoyao:1.0.1'
申請權限
- // 申請多設備協同權限
- EasyPermission.requestPermission(this, EasyPermission.DISTRIBUTED_DATASYNC, new PermissionAction() {
- @Override
- public void onGranted(List<String> permissions) {
- // 權限申請成功
- }
- @Override
- public void onDenied(List<String> permissions) {
- // 權限申請失敗
- }
- }, SystemPermission.DISTRIBUTED_DATASYNC);
申請權限的時候可能會涉及到兩個彈窗，一個彈窗是用來告知用戶申請權限的原因，另一個彈窗是用來告知用戶去設置頁面開啟權限，這兩個彈窗在不同的應用里面可能長得不一樣，所以這兩個彈窗并沒有被封裝到桃夭框架里面，而是需要使用者根據你的彈窗樣式對桃夭進行二次封裝，我在源碼里面對桃夭框架進行了二次封裝，大家可以把源碼下載下來，參考下我是如何對桃夭框架進行二次封裝的。二次封裝完成后，就可以愉快的使用上面的代碼申請權限了。
五、實現原理
5、1 檢測申請的權限是否在配置文件中聲明
申請的權限必須在配置文件中聲明，否則桃夭會直接拋異常。如何檢測申請的權限是否在配置文件中聲明。
如下代碼，獲取bundleManager對象，通過bundleManager對象獲取應用信息，之后就可以獲取應用在配置文件中聲明的權限了。
- /**
- * 獲取在配置文件中聲明的權限
- *
- * @param context 上下文
- * @return 在配置文件中聲明的權限
- */
- private List<String> getConfigPermissions(Context context) {
- // 獲取bundleManager對象
- IBundleManager bundleManager = context.getBundleManager();
- String bundleName = context.getBundleName();
- try {
- // 獲取應用信息
- BundleInfo bundleInfo = bundleManager.getBundleInfo(bundleName, IBundleManager.GET_BUNDLE_WITH_REQUESTED_PERMISSION);
- // 獲取應用在配置文件中聲明的權限
- List<String> reqPermissionDetails = bundleInfo.reqPermissions;
- if (reqPermissionDetails == null || reqPermissionDetails.isEmpty()) {
- throw new IllegalStateException("請在配置文件中聲明要申請的權限");
- }
- return reqPermissionDetails;
- } catch (RemoteException e) {
- e.printStackTrace();
- }
- return new ArrayList<>();
- }
獲取到在配置文件中聲明的權限后，就可以判斷申請的權限是否在配置文件中了
- /**
- * 檢查申請的權限是否在配置文件中聲明
- *
- * @param permissions 要申請的權限
- */
- private void checkPermissions(String... permissions) {
- if (permissions == null || permissions.length == 0) {
- throw new IllegalArgumentException("請至少申請一個權限");
- }
- // 獲取在配置文件中聲明的權限
- mReqPermissions = getConfigPermissions(mOrigin.getContext());
- if (mReqPermissions.isEmpty()) {
- throw new IllegalStateException("請在配置文件中聲明要申請的權限");
- }
- for (String target : permissions) {
- if (!mReqPermissions.contains(target)) {
- // 沒有在配置中聲明要申請的權限，直接拋異常
- throw new IllegalStateException(String.format("%1$s權限沒有配置文件中聲明", target));
- }
- }
- }
5、2 判斷是否有權限
檢測完權限是否在配置中聲明后，就可以判斷是否有權限了。這里就是通過上下文對象的verifySelfPermission方法來判斷是否有權限，如果沒有權限，可以彈窗告知用戶申請的原因。
- /**
- * 是否有權限
- *
- * @param context
- * @param permissions
- * @return
- */
- @Override
- public boolean hasPermission(Context context, List<String> permissions) {
- for (String permission : permissions) {
- int result = context.verifySelfPermission(permission);
- if (result == IBundleManager.PERMISSION_DENIED) {
- // 沒有權限
- return false;
- }
- }
- return true;
- }
5、3 判斷用戶是否點擊了不再提醒
通過上下文對象的canRequestPermission方法來判斷用戶是否點擊了不再提醒。
- /**
- * 用戶是否點擊了不在提醒
- *
- * @param permission 權限
- * @return
- */
- @Override
- public boolean canRequestPermission(String permission) {
- return mContext.canRequestPermission(permission);
- }
5、4 跳轉到設置頁面
如果用戶點擊了不再提醒，則可以跳轉到設置頁面讓用戶開啟權限
- /**
- * 跳轉到設置頁面
- */
- @Override
- public void gotoSetting() {
- try {
- Intent intent = new Intent();
- intent.setAction(IntentConstants.ACTION_APPLICATION_DETAILS_SETTINGS);
- intent.setUri(Uri.parse("package:" + mOrigin.getContext().getBundleName()));
- mOrigin.startAbility(intent);
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
5、5 啟動透明的Ability申請權限
如果沒有權限，用戶頁面沒有點擊不再提醒，那就可以申請權限了。為了不讓調用者重寫onRequestPermissionsFromUserResult方法，桃夭內部啟動了一個Ability。如下代碼。
- /**
- * 開啟一個透明的Ability來申請權限，這樣外界就不需要重寫onRequestPermissionsFromUserResult方法
- */
- public class PermissionAbility extends Ability {
- private static final int REQUEST_CODE = 0X10;
- public static final String KEY_PERMISSION = "key_permission";
- public static final String KEY_TYPE = "key_type";
- public static final String SENSITIVE_PERMISSION = "sensitive_permission";
- @Override
- public void onStart(Intent intent) {
- super.onStart(intent);
- getWindow().setTransparent(true);
- super.setUIContent(ResourceTable.Layout_ability_permission);
- List<String> permissions = intent.getSerializableParam(KEY_PERMISSION);
- String permissionType = intent.getStringParam(KEY_TYPE);
- // 請求權限
- requestPermissionsFromUser(permissions.toArray(new String[0]), REQUEST_CODE);
- }
- @Override
- public void onRequestPermissionsFromUserResult(int requestCode, String[] permissions, int[] grantResults) {
- super.onRequestPermissionsFromUserResult(requestCode, permissions, grantResults);
- // 權限的回調方法
- Postman.send(permissions, grantResults);
- terminateAbility();
- }
- @Override
- protected void onAbilityResult(int requestCode, int resultCode, Intent resultData) {
- super.onAbilityResult(requestCode, resultCode, resultData);
- }
- }
直接啟動一個Ability會發生頁面跳轉，為了不讓頁面發生跳轉，這里啟動了一個透明的Ability。如何將Ability設置透明，如下代碼。在abilities節點添加metaData，這里最關鍵的是Translucent，也就是透明。
- "abilities": [
- {
- "orientation": "unspecified",
- "name": "com.poetry.taoyao.ability.PermissionAbility",
- "icon": "$media:icon",
- "description": "$string:permissionability_description",
- "label": "$string:taoyao_PermissionAbility",
- "type": "page",
- "launchType": "standard",
- "metaData": {
- "customizeData": [
- {
- "name": "hwc-theme",
- "value": "androidhwext:style/Theme.Emui.Translucent.NoTitleBar"
- }
- ]
- }
- }
僅僅有上面的步驟好不夠，需要在Ability或者AbilitySlice里面將窗口設置成透明。如下代碼。
- getWindow().setTransparent(true);
經過上面兩步，也就是將Ability的主題和窗口都設置成透明，這樣就能將Ability變成透明的了，同時也不會發生頁面跳轉。
5、6 判斷用戶是否授予權限
判斷用戶是否授予權限，可以使用標準的方式來判斷。也就是通過grantResult來判斷用戶是否授予權限。
- @Override
- public boolean hasPermission(int[] grantResults, String... permissions) {
- if (grantResults == null || grantResults.length <= 0) {
- return false;
- }
- for (int grantResult : grantResults) {
- if (grantResult == IBundleManager.PERMISSION_DENIED) {
- return false;
- }
- }
- return true;
- }
其實還有另外的方式來判斷用戶是否授予權限。也就是不管用戶是否授權，直接訪問相關業務。比如，申請錄音權限，當系統回調onRequestPermissionsFromUserResult方法時，直接去錄音，如果發生異常，捕獲異常說明沒有權限。如下代碼：
- /**
- * 通過直接錄音的方式來判斷是否有錄音權限
- *
- * @param context
- * @return
- * @throws Throwable
- */
- @Override
- public boolean test(Context context) throws Throwable {
- AudioStreamInfo audioStreamInfo = new AudioStreamInfo.Builder().encodingFormat(
- AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT)
- .channelMask(AudioStreamInfo.ChannelMask.CHANNEL_IN_STEREO)
- .sampleRate(AUDIO_SAMPLE_RATE)
- .build();
- AudioCapturerInfo audioCapturerInfo = new AudioCapturerInfo.Builder().audioStreamInfo(audioStreamInfo).build();
- try {
- AudioCapturer capturer = new AudioCapturer(audioCapturerInfo);
- // 錄音
- capturer.start();
- new Timer().schedule(new TimerTask() {
- @Override
- public void run() {
- capturer.stop();
- }
- }, AUDIO_RECORDING_TIME);
- // 沒有發生異常，有權限
- return true;
- } catch (Exception e) {
- // 發生異常，無權限
- return false;
- }
- }
桃夭在判斷用戶是否授權時，上面的兩種方式都使用了。
