Android元件 ─ 要求權限 Permission (一)

前言：

權限其實沒有想像中的困難 。

在Android版本6.0以上，為了安全設計，就全面要求app要和使用者要求權限。

市面上還出現了像是EasyPermissions這類專門幫你拿取權限的第三方套件。

EasyPermissions官方：https://github.com/googlesamples/easypermissions

但我認為完全沒有必要使用這類的第三方，因為拿取權限並沒有想像中的那麼困難，也真的像那個第三方套件的名稱一樣，真的很Easy。

今日實作影片

這是今日要做的小範本。

---

重點程式碼：

if (permissionCheck != PackageManager.PERMISSION_GRANTED) {   //還沒獲取權限要做什麼呢   //和使用者要求權限   ActivityCompat.requestPermissions(MainActivity.this,                    new String[]{Manifest.permission.CAMERA},                    1); }else{   //以獲取權限要做的事情   Toast.makeText(this, "已經拿到權限囉!", Toast.LENGTH_SHORT).show(); }

/**

*requestPermissions 是用來要求使用者給予權限的方法(method)

*第一個參數 此頁面

*第二個參數 要獲取的權限名稱

*第三個參數 自定義的請求代碼

*/

---

實作：

首先你要先想清楚這個App所要那些權限(permission)。

有分為一般權限和危險權限，也只有危險權限才會跳出視窗和使用者要求使用它。

所有的權限一覽表請洽https://developer.android.com/reference/android/Manifest.permission.html

這邊就先拿相機Camera權限來做示範。

今日要動到的地方main_activity.xml、MainActivity.java、Manifest

main_activity.xml、MainActivity.java、Manifest

STEP 1：在Manifest內設定權限

AndroidManifest

  
    //Manifest
  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.spinner.a015865.permission">

    <uses-permission android:name="android.permission.CAMERA"/>
    <application
       ...
    </application>

</manifest>

STEP 2：實作activity_main.xml

簡單的在一開始的畫面給一個Button吧。

main_activity.xml

main_activity.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.spinner.a015865.qrmaker.MainActivity">

    <TextView
        android:layout_centerInParent="true"
        android:textSize="30dp"
        android:textColor="@android:color/black"
        android:onClick="button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="button" />

</RelativeLayout>

STEP 3：實作MainActivity.java

MainActivity.java

public class MainActivity extends AppCompatActivity {


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

    public void button(View view) {

        //檢查是否取得權限
        int permissionCheck = ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA);

        //沒有權限時
        if (permissionCheck != PackageManager.PERMISSION_GRANTED) {

            ActivityCompat.requestPermissions(MainActivity.this,
                    new String[]{Manifest.permission.CAMERA},
                    1);
        } else {
            Toast.makeText(this, "已經拿到權限囉!", Toast.LENGTH_SHORT).show();
        }
    }
    
}

解析：

int permissionCheck = ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA);

比較需要注意的是，這是一個int值。用來確定是否獲取權限。

如果使用者「同意權限」、「拒絕權限」

●已批准 PERMISSION_GRANTED 
//英文大補帖GRANTED已批准的

●已拒絕 PERMISSION_DENIED

//英文大補帖DENIED已拒絕的

int permissionCheck = ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA);

if (permissionCheck != PackageManager.PERMISSION_GRANTED) {
   //還沒獲取權限要做什麼呢
}else{
   //以獲取權限要做的事情
}

要求權限

如果使用者還沒給予權限，就要求使用者給予，跳視窗提醒它我要權限囉。

//自定義的請求代碼
//private static final int CUSTOM_NUMBER = 1;
if (permissionCheck != PackageManager.PERMISSION_GRANTED) {
   //還沒獲取權限要做什麼呢
     ActivityCompat.requestPermissions(MainActivity.this,
                    new String[]{Manifest.permission.CAMERA},
                    CUSTOM_NUMBER);
}else{
   //以獲取權限要做的事情
   Toast.makeText(this, "已經拿到權限囉!", Toast.LENGTH_SHORT).show();
}

/**

*requestPermissions 是用來要求使用者給予權限的方法(method)

*第一個參數 此頁面

*第二個參數 要獲取的權限名稱

*第三個參數 自定義的請求代碼(後面會用到)

*/

很簡單吧。

Demo：
https://drive.google.com/open?id=0Byk75IYx-dKXelNXaE05aTBMOUk

---

客製化用法 一：允許或拒絕之後的動作(onRequestPermissionsResult )

上面已經可以獲取你想要的權限無礙了。

再來講一些比較客製化獲取權限的方式。

按下允許或是拒絕都可以幹些什麼事情。
我這邊是讓他們跳出Toast

 

在MainActivity.java內，多複寫一個繼承的方法。

/**
     * public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults)
     * 複寫請求授權後執行的方法
     * 第一個參數是請求代碼
     * 第二個參數是請求授權的名稱
     * 第三個參數是請求授權的結果，PERMISSION_GRANTED或PERMISSION_DENTED
     */
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        //這個"CUSTOM_NUMBER"就是上述的自訂意義的請求代碼
        // private static final int CUSTOM_NUMBER = 1;
        if (requestCode == CUSTOM_NUMBER) {
            //假如允許了
            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                //do something
                Toast.makeText(this, "已經拿到CAMERA權限囉!", Toast.LENGTH_SHORT).show();
            } 
            //假如拒絕了
            else {
                //do something
                Toast.makeText(this, "CAMERA權限FAIL", Toast.LENGTH_SHORT).show();
            }
        }
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    }

客製化用法 二 ：半客製化要求使用者給予權限(shouldShowRequestPermissionRationale)

為什麼前面加一個「半」呢？

因為不是真正的你想的那樣。

這是當你第一次和使用者伸手要權限被拒絕時，第二次要求的時刻，才會跳出的視窗。

大致上的用法就是請你再詳細解釋一下為什麼需要用到這個權限。

在MainActitivy.java內Button裡面的requestPermissions方法

//
if (permissionCheck != PackageManager.PERMISSION_GRANTED) {
   //在這裡面做文章
 }

Button方法

//
    public void button (View view) {
        //檢查是否取得權限
        int permissionCheck = ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA);

        //沒有權限時
        if (permissionCheck != PackageManager.PERMISSION_GRANTED) {
            //如果使用者第二次點擊功能呼叫權限視窗，就會跳出shouldShowRequestPermissionRationale
            if (ActivityCompat.shouldShowRequestPermissionRationale(MainActivity.this,
                    Manifest.permission.CAMERA)) {
                //創建Dialog解釋視窗
                new AlertDialog.Builder(MainActivity.this)
                        .setMessage("單純使用在拍照功能，如果您不給我相機的權限，您將無法使用此功能")
                        .setPositiveButton("OK", new DialogInterface.OnClickListener() {
                            @Override
                            public void onClick(DialogInterface dialog, int which) {
                                ActivityCompat.requestPermissions(MainActivity.this,
                                        new String[]{Manifest.permission.CAMERA},
                                        CUSTOM_NUMBER);
                            }
                        })
                        .setNegativeButton("No", new DialogInterface.OnClickListener() {
                            @Override
                            public void onClick(DialogInterface dialog, int which) {
                                finish();
                            }
                        })
                        .show();
            } else {
                ActivityCompat.requestPermissions(MainActivity.this,
                        new String[]{Manifest.permission.CAMERA},
                        CUSTOM_NUMBER);
            }
        } else {
            Toast.makeText(this, "已經拿到權限囉!", Toast.LENGTH_SHORT).show();
        }
    }

Demo:
https://drive.google.com/open?id=0Byk75IYx-dKXR2dtMmdFNVJndXM

---

總結：

下一篇講一下我最常用的方法，一個按鈕解決切畫面和要求權限雙重效果。
其實就是封裝一下Permission和Intent而已。

在第二篇做說明。

有問題歡迎提出唷！

文獻：
https://developer.android.com/reference/android/Manifest.permission.html
https://developer.android.com/guide/topics/permissions/index.html
https://developer.android.com/guide/topics/manifest/uses-permission-element.html