PermissionDialog【權限申請提示對話框】

版權聲明：本文為HaiyuKing原創文章，轉載請注明出處！

前言

　　隨着Android6.0的普及,權限申請也變成了我們開發中必寫的一段代碼。比如sd卡權限、定位權限、拍照權限，這些幾乎都是每個app必備的。而一般情況下我們都會在需要權限之前申請，然后各種判斷。那既然是一些必備的是權限，我們為何不在我們一次打開app的時候就把這個全部都申請了呢？可是一下申請那么多權限對用戶來說顯然不是很友好，所以我們不妨在申請權限之前告訴一下用戶，好讓用戶有個心理准備。於是借鑒了餓了么的權限申請界面，封裝了一個對話框。

 

　　這個對話框只是用來展現應用當中需要用到的權限列表，不具備申請權限的功能，申請權限請搭配相關第三方庫，比如《 Android6.0運行時權限(基於RxPermission開源庫)》；另外，考慮到這個對話框一般在APP首次使用的時候才會彈出來，所以搭配《 PreferencesUtils【SharedPreferences操作工具類】》實現保存狀態值，用於判斷是否需要顯示這個對話框。

效果圖

代碼分析

PermissionDialog：對話框界面，繼承AlertDialog

使用步驟

一、項目組織結構圖

注意事項：

1、  導入類文件后需要change包名以及重新import R文件路徑

2、  Values目錄下的文件（strings.xml、dimens.xml、colors.xml等），如果項目中存在，則復制里面的內容，不要整個覆蓋

二、導入步驟

1、將PermissionDialog.java文件復制到項目中

package com.why.project.permissiondialog.dialog;

import android.app.Activity;
import android.app.AlertDialog;
import android.content.Context;
import android.graphics.Color;
import android.graphics.ColorMatrixColorFilter;
import android.os.Bundle;
import android.support.v4.content.ContextCompat;
import android.util.DisplayMetrics;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ImageView;
import android.widget.LinearLayout;
import android.widget.ScrollView;
import android.widget.TextView;

import com.why.project.permissiondialog.R;

/**
 * Created by HaiyuKing
 * Used 權限申請對話框
 */
public class PermissionDialog extends AlertDialog {

    //上下文
    private Context mContext;

    //內容的父節點，用於內容較多時可以滾動
    private ScrollView mListScroll;
    //內容
    private LinearLayout mListLayout;
    //確認按鈕
    private TextView mConfirmBtn;

    public PermissionDialog(Context context) {
        //設置對話框樣式
        super(context, R.style.style_permission_dialog);

        //設置為false，按對話框以外的地方不起作用
        setCanceledOnTouchOutside(false);
        //設置為false，按返回鍵不能退出
        setCancelable(false);

        this.mContext = context;
    }

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

        initViews();
        initDatas();
        initEvents();
    }

    /**初始化view*/
    private void initViews() {
        mListScroll = findViewById(R.id.permission_dialog_list_scroll);
        mListLayout = findViewById(R.id.layout_list);
        mConfirmBtn = findViewById(R.id.dialog_confirm_btn);
    }

    /**初始化數據*/
    private void initDatas() {

        //獲取圖標的顏色值
        int mFilterColor = ContextCompat.getColor(mContext,R.color.permission_dialog_img_color);
        int blue = Color.blue(mFilterColor);
        int green = Color.green(mFilterColor);
        int red = Color.red(mFilterColor);
        float[] cm = new float[]{
                1, 0, 0, 0, red,// 紅色值
                0, 1, 0, 0, green,// 綠色值
                0, 0, 1, 0, blue,// 藍色值
                0, 0, 0, 1, 1 // 透明度
        };
        ColorMatrixColorFilter filter = new ColorMatrixColorFilter(cm);

        //初始化權限列表區域
        int[] permissionImgIds = mContext.getResources().getIntArray(R.array.permission_icon);
        String[] permissionTitles = mContext.getResources().getStringArray(R.array.permission_title);
        String[] permissionInfos = mContext.getResources().getStringArray(R.array.permission_info);

        for(int i = 0; i < permissionImgIds.length; i++){
            String title = permissionTitles[i];
            String info = permissionInfos[i];

            View itemView = View.inflate(mContext,R.layout.permission_list_item,null);
            ((ImageView)itemView.findViewById(R.id.item_img)).setImageResource(mContext.getResources().obtainTypedArray(R.array.permission_icon).getResourceId(i, 0));
            ((ImageView)itemView.findViewById(R.id.item_img)).setColorFilter(filter);//設置圖標的顏色
            ((TextView)itemView.findViewById(R.id.item_title)).setText(title);
            ((TextView)itemView.findViewById(R.id.item_info)).setText(info);

            mListLayout.addView(itemView);
        }

        //設置內容區域的父節點的高度和內容文本大小
        final DisplayMetrics display = new DisplayMetrics();
        ((Activity)this.mContext).getWindowManager().getDefaultDisplay().getMetrics(display);
        final int screenHeight = display.heightPixels;
        //先設置寬度，然后再調整高度
        mListScroll.setLayoutParams(new LinearLayout.LayoutParams(display.widthPixels - mContext.getResources().getDimensionPixelOffset(R.dimen.permission_dialog_margin) * 2,
                ViewGroup.LayoutParams.WRAP_CONTENT));

        //runnable中的方法會在View的measure、layout等事件后觸發
        mListScroll.post(new Runnable() {
            @Override
            public void run() {
                if (mListScroll.getMeasuredHeight() > screenHeight / 2) {
                    mListScroll.setLayoutParams(new LinearLayout.LayoutParams(display.widthPixels - mContext.getResources().getDimensionPixelOffset(R.dimen.permission_dialog_margin) * 2,
                            screenHeight / 2));
                }else{
                    //屏幕寬度減去外邊距*2
                    mListScroll.setLayoutParams(new LinearLayout.LayoutParams(display.widthPixels - mContext.getResources().getDimensionPixelOffset(R.dimen.permission_dialog_margin) * 2,
                            ViewGroup.LayoutParams.WRAP_CONTENT));
                }
            }
        });

    }

    /**初始化監聽事件*/
    private void initEvents() {
        mConfirmBtn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                if(mOnCertainButtonClickListener != null){
                    mOnCertainButtonClickListener.onCertainButtonClick();
                }
                dismiss();
            }
        });
    }

    @Override
    public void dismiss() {
        super.dismiss();
    }

    public static abstract interface OnCertainButtonClickListener
    {
        //確認按鈕的點擊事件接口
        public abstract void onCertainButtonClick();
    }

    private OnCertainButtonClickListener mOnCertainButtonClickListener;

    public void setOnCertainButtonClickListener(OnCertainButtonClickListener mOnCertainButtonClickListener)
    {
        this.mOnCertainButtonClickListener = mOnCertainButtonClickListener;
    }

}

2、將permission_dialog_bg.xml、permission_dialog_one_btn_bg.xml復制到drawable目錄下

3、將圖片資源復制到drawable-xxhdpi目錄下

4、將permission_dialog_layout.xml、permission_list_item.xml布局文件復制到項目中

5、在arrays.xml中添加以下代碼【根據實際情況，通過注釋控制圖標的個數，標題、說明數組需要和圖標數組一一對應】

<?xml version="1.0" encoding="utf-8"?>
<resources>
    
    <!-- 權限圖標【可根據實際情況修改】 -->
    <integer-array name="permission_icon">
        <item>@drawable/permission_ic_storage</item>
        <item>@drawable/permission_ic_camera</item>
        <item>@drawable/permission_ic_location</item>
        <item>@drawable/permission_ic_phone</item>
        <item>@drawable/permission_ic_micro_phone</item>
        <item>@drawable/permission_ic_calendar</item>
        <item>@drawable/permission_ic_contacts</item>
        <item>@drawable/permission_ic_sms</item>
        <item>@drawable/permission_ic_sensors</item>
    </integer-array>

    <!-- 權限標題【可根據實際情況修改】 -->
    <string-array name="permission_title">
        <item>文件存儲</item>
        <item>相機相冊</item>
        <item>位置信息</item>
        <item>電話狀態</item>
        <item>錄制聲音</item>
        <item>日程信息</item>
        <item>通訊錄</item>
        <item>短信信息</item>
        <item>傳感器</item>
    </string-array>

    <!-- 權限說明（這里應該是根據項目的實際情況，簡要說明下該權限主要用於什么場景或者功能）【可根據實際情況修改】 -->
    <string-array name="permission_info">
        <item>允許應用讀取、寫入外部存儲</item>
        <item>允許應用訪問攝像頭進行拍照</item>
        <item>允許應用獲取定位信息</item>
        <item>允許應用訪問電話狀態</item>
        <item>允許應用通過手機或耳機的麥克錄制聲音</item>
        <item>允許應用讀取用戶的日程信息</item>
        <item>允許應用訪問聯系人通訊錄信息</item>
        <item>允許應用獲取短信信息</item>
        <item>允許應用獲取傳感器信息</item>
    </string-array>
    
</resources>

 6、在colors.xml中添加以下代碼【根據實際情況設置圖標和按鈕的背景顏色值】

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="colorPrimary">#008577</color>
    <color name="colorPrimaryDark">#00574B</color>
    <color name="colorAccent">#D81B60</color>

    <!-- ==================權限申請對話框（alertdialog）================== -->
    <!-- 對話框的填充顏色 -->
    <color name="permission_dialog_solid_color">#ffffffff</color>
    <!-- 對話框的標題顏色 -->
    <color name="permission_dialog_title_color">#000000</color>
    <!-- 對話框的描述顏色 -->
    <color name="permission_dialog_message_color">#87000000</color>
    <!-- 對話框的圖標顏色【可根據實際情況修改】 -->
    <color name="permission_dialog_img_color">#000000</color>
    <!-- 對話框的按鈕背景顏色【可根據實際情況修改】 -->
    <color name="permission_dialog_btn_bg_color">#07b4a2</color>
    <!-- 對話框的按鈕文字顏色 -->
    <color name="permission_dialog_btn_text_color">#FFFFFF</color>

</resources>

 7、在dimens.xml中添加以下代碼

<resources>
    <!-- Default screen margins, per the Android Design guidelines. -->
    <dimen name="activity_horizontal_margin">16dp</dimen>
    <dimen name="activity_vertical_margin">16dp</dimen>

    <!-- ==================權限申請對話框（alertdialog）================== -->
    <!-- 對話框的圓角角度 -->
    <dimen name="permission_dialog_corners">8dp</dimen>
    <!-- 對話框的整體外邊距 -->
    <dimen name="permission_dialog_margin">30dp</dimen>
    <!-- 對話框的標題內邊距 -->
    <dimen name="permission_dialog_title_padding">15dp</dimen>
    <!-- 對話框的標題文本大小 -->
    <dimen name="permission_dialog_title_text_size">22sp</dimen>
    <!-- 對話框的描述文本大小 -->
    <dimen name="permission_dialog_message_text_size">16sp</dimen>
    <!-- 對話框的按鈕內邊距 -->
    <dimen name="permission_dialog_btn_padding">8dp</dimen>
    <!-- 對話框的按鈕大小 -->
    <dimen name="permission_dialog_btn_text_size">16sp</dimen>

</resources>

8、在strings.xml中添加以下代碼

<resources>
    <string name="app_name">PermissionDialog</string>

    <!-- ==================權限申請對話框（alertdialog）================== -->
    <string name="permission_dialog_title">權限申請</string>
    <string name="permission_dialog_message">為了您能正常使用，需要以下權限</string>
</resources>

9、在styles.xml中添加以下代碼

<resources>

    <!-- Base application theme. -->
    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <!-- Customize your theme here. -->
        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
        <item name="colorAccent">@color/colorAccent</item>
    </style>

    <!-- ==================權限申請對話框（alertdialog）================== -->
    <style name="style_permission_dialog">
        <!-- Dialog的windowFrame框為無 -->
        <item name="android:windowFrame">@null</item>
        <!-- 是否顯示title -->
        <item name="android:windowNoTitle">false</item>
        <!-- 是否浮現在activity之上 -->
        <item name="android:windowIsFloating">true</item>
        <!-- 半透明 -->
        <item name="android:windowIsTranslucent">true</item>
        <!-- 設置dialog的背景：#00000000透明色 -->
        <item name="android:windowBackground">@android:color/transparent</item>
        <!-- 背景變灰：整個屏幕變灰，配合setCanceledOnTouchOutside(false) -->
        <item name="android:backgroundDimEnabled">true</item>
    </style>

</resources>

三、使用方法

在代碼中調用如下：

package com.why.project.permissiondialog;

import android.os.Build;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;

import com.why.project.permissiondialog.dialog.PermissionDialog;

public class MainActivity extends AppCompatActivity {

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

        findViewById(R.id.btn_showdialog).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                boolean hasShow = PreferencesUtils.getBoolean(MainActivity.this,PreferencesUtils.HAS_SHOW_PREMISSION_DIALOG,false); if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && ! hasShow){ PermissionDialog permissionDialog = new PermissionDialog(MainActivity.this); permissionDialog.setOnCertainButtonClickListener(new PermissionDialog.OnCertainButtonClickListener() { @Override public void onCertainButtonClick() { //搭配SharedPreferences 將狀態值記錄下來，實現APP首次打開的時候才會彈出這個對話框
                            PreferencesUtils.putBoolean(MainActivity.this,PreferencesUtils.HAS_SHOW_PREMISSION_DIALOG,true); //調用運行時權限申請框架
 } }); permissionDialog.show(); }else{ //調用運行時權限申請框架
 }
            }
        });
    }
}

 注意：

實際項目中，需要手動調整arrays.xml文件中的權限數組個數，不顯示的注釋掉，保證三個數組的一一對應；

根據項目的主題顏色，調整colors.xml文件中的圖標、按鈕的背景顏色值；

混淆配置

無

參考資料

一行代碼搞定漂亮的Android6.0權限申請界面

Android-使用 SetColorFilter 神奇地改變圖片的顏色

項目demo下載地址

https://github.com/haiyuKing/PermissionDialog