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

版權聲明:本文爲HaiyuKing原創文章,轉載請註明出處!html

前言

  隨着Android6.0的普及,權限申請也變成了咱們開發中必寫的一段代碼。好比sd卡權限、定位權限、拍照權限,這些幾乎都是每一個app必備的。而通常狀況下咱們都會在須要權限以前申請,而後各類判斷。那既然是一些必備的是權限,咱們爲什麼不在咱們一次打開app的時候就把這個所有都申請了呢?但是一下申請那麼多權限對用戶來講顯然不是很友好,因此咱們不妨在申請權限以前告訴一下用戶,好讓用戶有個心理準備。因而借鑑了餓了麼的權限申請界面,封裝了一個對話框。
 
  這個對話框只是用來展示應用當中須要用到的權限列表,不具有申請權限的功能,申請權限請搭配相關第三方庫,好比《 Android6.0運行時權限(基於RxPermission開源庫)》;另外,考慮到這個對話框通常在APP首次使用的時候纔會彈出來,因此搭配《 PreferencesUtils【SharedPreferences操做工具類】》實現保存狀態值,用於判斷是否須要顯示這個對話框。

效果圖

代碼分析

PermissionDialog:對話框界面,繼承AlertDialogjava

使用步驟

1、項目組織結構圖

注意事項:android

一、  導入類文件後須要change包名以及從新import R文件路徑git

二、  Values目錄下的文件(strings.xml、dimens.xml、colors.xml等),若是項目中存在,則複製裏面的內容,不要整個覆蓋github

2、導入步驟

一、將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;
    }

}
PermissionDialog.java

二、將permission_dialog_bg.xml、permission_dialog_one_btn_bg.xml複製到drawable目錄下

三、將圖片資源複製到drawable-xxhdpi目錄下

四、將permission_dialog_layout.xml、permission_list_item.xml佈局文件複製到項目中

五、在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>

 六、在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>

 七、在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>

八、在strings.xml中添加如下代碼

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

    <!-- ==================權限申請對話框(alertdialog)================== -->
    <string name="permission_dialog_title">權限申請</string>
    <string name="permission_dialog_message">爲了您能正常使用,須要如下權限</string>
</resources>

九、在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>

3、使用方法

在代碼中調用以下:數組

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{ //調用運行時權限申請框架
 }
            }
        });
    }
}

 注意:app

實際項目中,須要手動調整arrays.xml文件中的權限數組個數,不顯示的註釋掉,保證三個數組的一一對應;框架

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

混淆配置

工具

參考資料

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

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

項目demo下載地址

https://github.com/haiyuKing/PermissionDialog

相關文章
相關標籤/搜索