Androidでパーミッション許可ダイアログの出し方

Androidでのパーミッションについて

昔（APIレベル < 23）はこんな緩い許可でOKでした。

ただAndroidManifest.xmlに書くだけ
インストール時に自動的に許可される

これは大昔の話。

現在（APIレベル >= 23）はスゴク厳格になってます。

いわゆるパーミッション許可ダイアログの表示必須です。

意外とやり方が面倒だったので、
ここではそのパーミッション許可ダイアログの出し方をまとめました。

このページの目次

許可ダイアログを出す必要があるパーミッションの種類
パーミッション許可ダイアログの表示手順＆コード例
ここまでのまとめ　－　許可ダイアログは必ず表示しよう

許可ダイアログを出す必要があるパーミッションの種類

まずパーミッションと許可ダイアログについて

別に全パーミッションで必須なわけじゃないです。

一部の Dangerousパーミッションに必要になります。

▼ 公式での Dangerousパーミッションの解説

Dangerous パーミッションは、アプリがユーザーの個人情報を含むデータやリソースを必要とする、あるいはユーザーが保存したデータや他のアプリ操作に影響を及ぼす可能性があるケースを対象とします。たとえば、ユーザーのコンテンツを読み取る機能には、Dangerous パーミッションが必要です。アプリが Dangerous パーミッションが必要性であると宣言している場合、ユーザーはアプリに明示的にパーミッションを付与しなければなりません。

引用元　：　https://developer.android.com/guide/topics/security/permissions?hl=ja

『個人情報を含むデータやリソース』

ここが重要なところ

一例（というか全部？）を挙げると、以下の通りです。

※ 抜けてるパーミッションがあれば教えてください。

READ_CALENDAR
WRITE_CALENDAR
CAMERA
READ_CONTACTS
WRITE_CONTACTS
GET_ACCOUNTS
ACCESS_FINE_LOCATION
ACCESS_COARSE_LOCATION
RECORD_AUDIO
READ_PHONE_STATE
CALL_PHONE
READ_CALL_LOG
WRITE_CALL_LOG
ADD_VOICEMAIL
USE_SIP
PROCESS_OUTGOING_CALLS
BODY_SENSORS
READ_EXTERNAL_STORAGE
WRITE_EXTERNAL_STORAGE

アプリを確実にAPIレベル23以降に対応させたいなら・・・

これらパーミッションの許可ダイアログ表示が必要

よく使うのは WRITE_EXTERNAL_STORAGE とかですね。

パーミッション許可ダイアログの表示手順＆コード例

実際にとあるアプリでは、以下２つの権限が必要でした。

WRITE_EXTERNAL_STORAGE
READ_CONTACTS

これを例に取ると、以下手順でダイアログ表示できます。

１．普通にAndroidManifest.xmlに権限追加

まずは AndroidManifest.xml の編集

ここに今まで通りパーミッションを追加します。

▼ ここでは２つのパーミッションを追加

<manifest ...>

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_CONTACTS" />

    <application...

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

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

<application...

Android6.0以上では、これだけでは不完全です。

起動時にも許可を取るコードが必要になりました。

２．許可ダイアログを起動時に表示する

そしたら次からが肝心な処理です。

許可ダイアログの表示

以下の条件に当てはまるなら、表示しないとダメです。

Android6.0以降に対応させる場合
APIレベル23以降に対応させる場合
そのうえで許可を取れていない場合

実際には onCreate 内にこういうコード書いてみました。

▼ onCreate内にて・・・

/// パーミッション許可を取る
if (Build.VERSION.SDK_INT >= 23) {
    if(ActivityCompat.checkSelfPermission(this,
            Manifest.permission.WRITE_EXTERNAL_STORAGE)
            != PackageManager.PERMISSION_GRANTED
       || ActivityCompat.checkSelfPermission(this,
            Manifest.permission.READ_CONTACTS)
            != PackageManager.PERMISSION_GRANTED)
    {
        ActivityCompat.requestPermissions(this,
            new String[]{
                Manifest.permission.WRITE_EXTERNAL_STORAGE,
                Manifest.permission.READ_CONTACTS
            },
            PERMISSION_WRITE_EX_STR);
    }
}

/// パーミッション許可を取る

if (Build.VERSION.SDK_INT >= 23) {

if(ActivityCompat.checkSelfPermission(this,

Manifest.permission.WRITE_EXTERNAL_STORAGE)

!= PackageManager.PERMISSION_GRANTED

|| ActivityCompat.checkSelfPermission(this,

Manifest.permission.READ_CONTACTS)

!= PackageManager.PERMISSION_GRANTED)

{

ActivityCompat.requestPermissions(this,

new String[]{

Manifest.permission.WRITE_EXTERNAL_STORAGE,

Manifest.permission.READ_CONTACTS

PERMISSION_WRITE_EX_STR);

}

▼ またActivityの内側に定数も宣言しておく

/// こんな風に定数を宣言
private static final int PERMISSION_WRITE_EX_STR = 1;

1 2	/// こんな風に定数を宣言 private static final int PERMISSION_WRITE_EX_STR = 1;

ちなみに対応は Build.VERSION.SDK_INT >= 23 だけでOK。

それ以前のバージョンでは許可ダイアログは不要なようです。

３．許可ダイアログの結果を受け取る

許可ダイアログを表示したら・・・

その許可ダイアログの結果受け取りが必要

結果には大きく分けて次の２種類があります。

許可が取れた場合
＝＞　そのまま通常通りにアプリを起動する
許可が取れなかった場合
＝＞　再度許可を取ったりトースト表示したり

結果は onRequestPermissionsResult をオーバーライドして受け取り可能です。

実際に書いてみたコードは以下のようなもの

▼ Actiivty内でオーバーライド

@Override
public void onRequestPermissionsResult(
    int requestCode, String[] permission, int[] grantResults
){
    if (grantResults.length <= 0) { return; }
    switch(requestCode){
        case PERMISSION_WRITE_EX_STR: {
            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                /// 許可が取れた場合・・・
                /// 必要な処理を書いておく
            } else {
                /// 許可が取れなかった場合・・・
                Toast.makeText(this,
                        "アプリを起動できません....", Toast.LENGTH_LONG).show();
                finish();
            }
        }
        return;
    }
}

@Override

public void onRequestPermissionsResult(

int requestCode, String[] permission, int[] grantResults

){

if (grantResults.length <= 0) { return; }

switch(requestCode){

case PERMISSION_WRITE_EX_STR: {

if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {

/// 許可が取れた場合・・・

/// 必要な処理を書いておく

} else {

/// 許可が取れなかった場合・・・

Toast.makeText(this,

"アプリを起動できません....", Toast.LENGTH_LONG).show();

finish();

}

return;

}

こういう感じ。

許可が取れない場合はトースト表示してます。

実際にこのコードを追加すると・・・

起動時にこんなダイアログが表示されます。

▼ WRITE_EXTERNAL_STORAGE の許可ダイアログ

▼ READ_CONTACTS の許可ダイアログ

よく見かけるダイアログが表示できました。

これで心置きなくアプリリリースできます。

ここまでのまとめ　－　許可ダイアログは必ず表示しよう

という訳で許可ダイアログ表示についてでした。

Android6.0以降に対応させたい
個人情報を含むデータにアクセスする

そんな場合はパーミッションリクエスト必須ですね。

アプリ公開前に必ず実装するようにしたいです。

Rocky

はじめまして。
この度、Androidアプリ開発を久しぶりに行いまして権限周りにつまずきこのページにたどり着きました。どのプログラムをどことどこの間に書く・・・と書かれていてとてもわかり易かったです。
さて、上記のプログラムを書いたのですが、権限ダイアログが表示されずにすぐに「アプリを起動できません」とトーストが出てアプリが終了してしまいます。何が原因でしょうか？
今回私が作っているアプリでは”WRITE_SETTINGS”という権限が必要となっています。

もしわかればご教授ください。

9月 6, 2021 7:49 pm

ぴー助

はじめまして。
コメントありがとうございます。

まずそういった「起動できません」というエラーが出る場合、それだけでコードの問題個所を特定するのはほぼ不可能です。まずはエラーログ確認が大事ですね。ただしadb接続などが必須であり、デバッグ環境以外ではログ出力・エラー確認ができないので注意が必要です。（参考 – Wifiによるadb接続について : https://pisuke-code.com/android-use-adb-over-wifi/）

エラー原因というのは実際のコード・開発環境依存なので断言することはできません。開発環境（Android Studioなど）でのログ出力・エラーログ確認の方法を調べ、コードのどこに原因があるのか調べられた方がいいと思います。（仮に推測するならnull参照などの実行時エラーかもしれません）

9月 6, 2021 8:58 pm

お世話になります。
ご返信遅くなりまして申し訳ございません。

情報不足な状態でのご質問失礼致しました。
はじめに質問させて頂きましたパーミッションについて自分でも調べたところ、自分のアプリで求められているパーミッションがよくあるダイアログで許可するものではありませんでした。
外部リンクの貼り付けではありますが、以下リンク内の「システム設定の変更」のパーミッションです。
https://qiita.com/KeithYokoma/items/b434db6b501f369d3d20

こちらはよくあるダイアログでの許可は不可のようです。しかし、パーミッションが許可状態にあるのかを判定してアプリ起動時にダイアログを表示するなどできたらと思っています。

9月 10, 2021 7:10 pm

Androidでパーミッション許可ダイアログの出し方

許可ダイアログを出す必要があるパーミッションの種類

パーミッション許可ダイアログの表示手順＆コード例

１．普通にAndroidManifest.xmlに権限追加

２．許可ダイアログを起動時に表示する

３．許可ダイアログの結果を受け取る

ここまでのまとめ　－　許可ダイアログは必ず表示しよう

関連記事

プロフィール

人気記事

検索してみる

許可ダイアログを出す必要があるパーミッションの種類

パーミッション許可ダイアログの表示手順＆コード例

１．普通にAndroidManifest.xmlに権限追加

２．許可ダイアログを起動時に表示する

３．許可ダイアログの結果を受け取る

ここまでのまとめ － 許可ダイアログは必ず表示しよう

関連記事

プロフィール

人気記事

検索してみる

ここまでのまとめ　－　許可ダイアログは必ず表示しよう