外部ストレージへアクセスするアプリは、パーミッション（許可）をユーザーから取得する必要があります。
パーミッションを得たアプリは、許可された権限の範囲内で、ストレージへアクセスが可能です。
これらは、ユーザーデータのプライバシー保護と密接に関係しています。
プライバシー保護をより強固にするために、パーミッションと権限の範囲の仕様は改変されてきました。
今回は、改変の歴史を辿りつつ、「パーミッションと権限の範囲」について、まとめます。
※環境：Android Studio Narwhal | 2025.1.1 Patch 1
目次
スポンサーリンク
パーミッションと権限の範囲
パーミッション
外部ストレージはアプリ間で共有するデータを保存する領域です。
データを「他のアプリと共有する」は「他のアプリに公開する」と同意です。悪意のあるアプリがインストールされた場合に、このアプリを経由してデータ（個人情報）が漏洩します。
ですので、秘匿性の高いデータの保存に適しません。
このセキュリティ上の問題点を承知の上で、外部ストレージへデータを保存するためには、アプリがユーザーからパーミッション（許可）を取得し、外部ストレージへアクセスする権限を持つ必要があります。
スポンサーリンク
権限の範囲
パーミッションを取得したアプリは、パーミッションが示す権限の範囲内で、ストレージのアクセスが可能です。
以下の表はパーミッションと権限の範囲を表しています。
API≦28API＝29API＝30～32API≧33
| 外部ストレージ プライマリ /storage/emulated/ユーザーID | Java / Android API | Media Store API | SAF | |
|---|---|---|---|---|
| メディアデータ | Pictures | 他：△ｗｒｐ | 他：◎ｗｒｐ | 他：△ｗｒ |
| DCIM | ||||
| Movies | ||||
| Music | ||||
| Alarms | ||||
| Notifications | ||||
| Podcasts | ||||
| Ringtones | ||||
| Audiobooks（API≧30） | ||||
| Recordings（API≧31） | ||||
| ドキュメント 他のファイル | Downloads | 他：○ｗｒｐ | 他：◎ｗｒｐ | 他：◎ｗｒ |
| Documants | ||||
| Android （Android/dataを除く） | ||||
| ユーザーフォルダ | ||||
| ユーザーファイル | ||||
| アプリ別 Android/data/パッケージ名/files | 他：△ｗｒｐ | 他：○ｗｒ |
||
| ※自：自アプリのファイル 他：他アプリのファイル ◎：アクセスできる（最適） ○：アクセスできる △：アクセスできる（不適または制限有） ×：アクセスできない 空：アクセスできない（サポート外） ｗ：書き込みできる ｒ：読み出しできる ｐ：パーミッションが必要 |
||||
| 外部ストレージ プライマリ /storage/emulated/ユーザーID | Java / Android API | Media Store API | SAF | |
|---|---|---|---|---|
| メディアデータ | Pictures | 他：× | 他：◎ ｒｐ | 他：△ｗｒ |
| DCIM | ||||
| Movies | ||||
| Music | ||||
| Alarms | ||||
| Notifications | ||||
| Podcasts | ||||
| Ringtones | ||||
| Audiobooks（API≧30） | ||||
| Recordings（API≧31） | ||||
| ドキュメント 他のファイル | Downloads | 他：× | 他：× | 他：◎ｗｒ |
| Documants | ||||
| Android （Android/dataを除く） | ||||
| ユーザーフォルダ | ||||
| ユーザーファイル | ||||
| アプリ別 Android/data/パッケージ名/files | 他：× | 他：○ｗｒ |
||
| ※自：自アプリのファイル 他：他アプリのファイル ◎：アクセスできる（最適） ○：アクセスできる △：アクセスできる（不適または制限有） ×：アクセスできない 空：アクセスできない（サポート外） ｗ：書き込みできる ｒ：読み出しできる ｐ：パーミッションが必要 |
||||
| 外部ストレージ プライマリ /storage/emulated/ユーザーID | Java / Android API | Media Store API | SAF | |
|---|---|---|---|---|
| メディアデータ | Pictures | 他：× | 他：◎ ｒｐ ※１ | 他：△ｗｒ |
| DCIM | ||||
| Movies | ||||
| Music | ||||
| Alarms | ||||
| Notifications | ||||
| Podcasts | ||||
| Ringtones | ||||
| Audiobooks（API≧30） | ||||
| Recordings（API≧31） | ||||
| ドキュメント 他のファイル | Downloads | 他：× | 他：× | 他：◎ｗｒ |
| Documants | ||||
| Android （Android/dataを除く） | 他：× | |||
| ユーザーフォルダ | ||||
| ユーザーファイル | ||||
| アプリ別 Android/data/パッケージ名/files | 他：× | 他：× |
||
| ※自：自アプリのファイル 他：他アプリのファイル ◎：アクセスできる（最適） ○：アクセスできる △：アクセスできる（不適または制限有） ×：アクセスできない 空：アクセスできない（サポート外） ｗ：書き込みできる ｒ：読み出しできる ｐ：パーミッションが必要 ※１：書き込みはURI（ファイル）毎にアクセス許可が必要、通常のパーミッションとは別 |
||||
| 外部ストレージ プライマリ /storage/emulated/ユーザーID | Java / Android API | Media Store API | SAF | |
|---|---|---|---|---|
| メディアデータ | Pictures | 他：× | 他：◎ ｒｐ ※１ | 他：△ｗｒ |
| DCIM | ||||
| Movies | ||||
| Music | ||||
| Alarms | ||||
| Notifications | ||||
| Podcasts | ||||
| Ringtones | ||||
| Audiobooks（API≧30） | ||||
| Recordings（API≧31） | ||||
| ドキュメント 他のファイル | Downloads | 他：× | 他：× | 他：◎ｗｒ |
| Documants | ||||
| Android （Android/dataを除く） | 他：× | |||
| ユーザーフォルダ | ||||
| ユーザーファイル | ||||
| アプリ別 Android/data/パッケージ名/files | 他：× | 他：× |
||
| ※自：自アプリのファイル 他：他アプリのファイル ◎：アクセスできる（最適） ○：アクセスできる △：アクセスできる（不適または制限有） ×：アクセスできない 空：アクセスできない（サポート外） ｗ：書き込みできる ｒ：読み出しできる ｐ：パーミッションが必要（images/video/audioデータ毎） ※１：書き込みはURI（ファイル）毎にアクセス許可が必要、通常のパーミッションとは別 |
||||
大きな変更
パーミッションと権限の範囲は、APIのバージョンが上がる（API 23以降を想定）中で、大きな変更が２度ありました。
- 対象範囲別ストレージ（API≧29）
- きめ細かいメディア権限（API≧33）
ちなみに、「対象範囲別ストレージ」は「ストレージ名」ではなく「アクセスモデル名」です。
スポンサーリンク
大きな変更前（API≦28）
アプリ自身が所有するファイルへアクセスする時も、他アプリが所有するファイルへアクセスする時も、パーミッションの取得が必要です。
パーミッションの設定＆取得
書き込み（WRITE_EXTERNAL_STORAGE）と読み出し（READ_EXTERNAL_STORAGE）パーミッションがあり、権限の範囲は外部ストレージ全体です。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<application ... > ... </application>
</manifest>
reqPerm(arrayOf(
Manifest.permission.READ_EXTERNAL_STORAGE,
Manifest.permission.WRITE_EXTERNAL_STORAGE
))
...
fun reqPerm(perms: Array<String>) {
var _isGranted = true
perms.forEach {
val _result = PermissionChecker.checkSelfPermission(this, it)
_isGranted = _isGranted && (_result == PermissionChecker.PERMISSION_GRANTED)
}
if (! _isGranted) {
requestPermissions(perms, 0)
}
}
パーミッションの取得を行うと、次のようなダイアログが表示されて、ユーザの許可を求めます。
※詳細は「Runtime Permissionの取得（システムがリクエストを管理）」を参照
スポンサーリンク
対象範囲別ストレージ（API≧29）
対象範囲別ストレージとは、ドキュメントに「アプリとユーザーデータのプライバシー保護を目的に、アプリの外部ストレージに対するアクセスを制限します。」と説明されています。
変更点
具体的には、次の点が変更になります。
★Java/Android APIを使ったアクセスを禁止 ★Media Store APIを使ったアクセスを強制 ・アプリ自身が所有するファイルへアクセス ... ※1 －パーミッションは不要 ・他アプリが所有するファイルへアクセス －Readアクセスにパーミッションが必要 －Writeアクセスは個別にURIへ許可を出す ... ※2 （通常のパーミッションとは別） ★サンドボックスと同等な領域（アプリ別）を確保 ※サンドボックス：内部ストレージにあるアプリ固有の領域
プライバシー保護で問題になる「他のアプリが所有するファイルへアクセスする方法」は残ります。無くしてしまったら、「アプリ間で共有するデータを保存する」という外部ストレージ本来の目的を失うからです。
スポンサーリンク
パーミッションの設定＆取得
読み出し（READ_EXTERNAL_STORAGE）パーミッションがあり、権限の範囲はメディアデータです。
※1,2の変更により、書き込み（WRITE_EXTERNAL_STORAGE）パーミッションは不要になりました。
ただし、API≦28では必要なので、API≦32（＝23～32）の全てに対応したければ、maxSdkVersionを付けて指定します。
API=29～32のみに対応API≦32に対応
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<application ... > ... </application>
</manifest>
reqPerm(arrayOf(
Manifest.permission.READ_EXTERNAL_STORAGE,
))
...
fun reqPerm(perms: Array<String>) {
var _isGranted = true
perms.forEach {
val _result = PermissionChecker.checkSelfPermission(this, it)
_isGranted = _isGranted && (_result == PermissionChecker.PERMISSION_GRANTED)
}
if (! _isGranted) {
requestPermissions(perms, 0)
}
}
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
android:maxSdkVersion="28" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<application ... > ... </application>
</manifest>
reqPerm(arrayOf(
Manifest.permission.READ_EXTERNAL_STORAGE,
Manifest.permission.WRITE_EXTERNAL_STORAGE
))
...
fun reqPerm(perms: Array<String>) {
var _isGranted = true
perms.forEach {
val _result = PermissionChecker.checkSelfPermission(this, it)
_isGranted = _isGranted && (_result == PermissionChecker.PERMISSION_GRANTED)
}
if (! _isGranted) {
requestPermissions(perms, 0)
}
}
パーミッションの取得を行うと、次のようなダイアログが表示されて、ユーザの許可を求めます。
スポンサーリンク
注意点：API29における無効化
API29における対象範囲別ストレージは、デフォルトで有効ですが、設定で無効に出来ます。
ただし、API≧30では強制的に有効です。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application android:requestLegacyExternalStorage="true" ... >
...
</application>
</manifest>
API29とAPI≧30でアクセスする権限の範囲に違いがあります。注意が必要です。
ですので、「対象範囲別ストレージの実質的な実装はAPI≧30」と捉えて、API29は無効化が妥当だと思います。
注意点：URIのアクセス許可は別物
対象範囲別ストレージは、URI（ストレージ上のファイルを一意に表す）毎にアクセス許可を出せます。
許可を持つアプリは、そのURIにアクセスが可能です。
この「URI毎に出されるアクセス許可」と「パーミッションシステムの出すアクセス許可」は独立しています。両者の関係性は無く、全くの別物です。
対象範囲別ストレージにおいて、他アプリが所有するファイルへ書き込みたい（更新や編集、削除を含む）場合は、URIのアクセス許可を取得する方法を使います。
スポンサーリンク
きめ細かいメディア権限（API≧33）
きめ細かいメディア権限では、メディアデータに対するパーミッションがコレクション毎に細分化されます。
変更点
具体的には、次の点が変更になります。
★読み出し（READ_EXTERNAL_STORAGE）パーミッションを廃止 ... ※3 ★メディアデータに対するパーミッション新設 ... ※4 ・コレクション毎に細分化 －READ_MEDIA_IMAGES ⇒ imagesコレクションのアクセス許可 －READ_MEDIA_VIDEO ⇒ videoコレクションのアクセス許可 －READ_MEDIA_AUDIO ⇒ audioコレクションのアクセス許可
例えば、READ_MEDIA_IMAGESパーミッションを取得したアプリは、imagesコレクションにアクセスする権限をもちます。videoとaudioコレクションへのアクセスは出来ません。
アクセスしたければ、別途、パーミッションを取得する必要があります。
スポンサーリンク
パーミッションの設定＆取得
imeges/video/audio毎の読み出しパーミッションがあり、権限の範囲はコレクションです。
パーミッションは※3から※4へ切り替わり、READ_EXTERNAL_STORAGEパーミッションは不要になりました。
ただし、API≦32では必要なので、全てのAPIに対応したれければ、残す必要があります。残してもAPI≧33では無視されます。
API≧33のみに対応全てのAPIに対応
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<application ... > ... </application>
</manifest>
reqPerm(arrayOf(
Manifest.permission.READ_MEDIA_IMAGES,
// Manifest.permission.READ_MEDIA_VIDEO,
// Manifest.permission.READ_MEDIA_AUDIO
))
...
fun reqPerm(perms: Array<String>) {
var _isGranted = true
perms.forEach {
val _result = PermissionChecker.checkSelfPermission(this, it)
_isGranted = _isGranted && (_result == PermissionChecker.PERMISSION_GRANTED)
}
if (! _isGranted) {
requestPermissions(perms, 0)
}
}
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
android:maxSdkVersion="28" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<application ... > ... </application>
</manifest>
if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU)
reqPerm(arrayOf(
Manifest.permission.READ_MEDIA_IMAGES,
// Manifest.permission.READ_MEDIA_VIDEO,
// Manifest.permission.READ_MEDIA_AUDIO
))
else
reqPerm(arrayOf(
Manifest.permission.READ_EXTERNAL_STORAGE,
Manifest.permission.WRITE_EXTERNAL_STORAGE
))
...
fun reqPerm(perms: Array<String>) {
var _isGranted = true
perms.forEach {
val _result = PermissionChecker.checkSelfPermission(this, it)
_isGranted = _isGranted && (_result == PermissionChecker.PERMISSION_GRANTED)
}
if (! _isGranted) {
requestPermissions(perms, 0)
}
}
パーミッションの取得を行うと、次のようなダイアログが表示されて、ユーザの許可を求めます。imagesとvideoコレクションは同じダイアログです。
※エミュレータ―（API33）の表示
※エミュレータ―（API33）の表示
スポンサーリンク
関連記事：
Adoptable StorageMedia StoreSDカードStorageStorageManagerStorageVolumeUuidサンドボックスデザインメディアデータ内部ストレージ外部ストレージ
ストレージはデータの用途別に記憶領域が分けられます。 保存先を守らないと、セキュリティリスクが発生したり、他のアプリと協調した動作が出来なくなったり、します。 ですので、適切な場所へデータを保存しましょう。 今回は「用途別記憶領域とボリューム」について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
ストレージへアクセスする方法は、「扱うデータの種類」「アクセス先」「セキュリティの確保」などの要件により、最適なアクセス方法が存在するので、使い分けが必要です。 今回は「アクセスする方法」について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
「外部ストレージ_プライマリ」にアクセスする方法について、まとめます。 「外部ストレージ_プライマリ」は、アプリ間で共有するデータを保存するストレージです。 主にカメラ、音楽プレーヤー、動画プレーヤーで扱うデータを保存します。 「外部ストレージ_プライマリ」に保存したデータは、他のアプリに公開することになるので、秘匿性の高いデータの保存に適しません。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
「外部ストレージ_セカンダリ」にアクセスする方法について、まとめます。 「外部ストレージ_セカンダリ」は、デバイス間（または、アプリ間）で共有するデータを保存するストレージです。 デバイスとは、他の携帯端末やパソコンなどを指します。 ストレージがSDカードのような取り外し可能なリソース上に構築されているので、データの共有は取り外したストレージを他のデバイスへ取り付けて行います。 「外部ストレージ_セカンダリ」に保存したデータは、他のデバイスに公開することになるので、秘匿性の高いデータの保存に適しません。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
Content ProviderContent ResolverContentValueMedia StoreopenInputStreamopenOutputStreamStorageデザインメディアデータ
「外部ストレージ_プライマリ」に保存されるメディアデータは、Media Storeと呼ばれる特別な方法でアクセスします。 他の方法も可能ですが、Media Storeが最も適した方法です。 この「メディアデータへMedia Storeでアクセス」する方法を、まとめます。 この記事は、Imagesデータ編です。また、基本的なアクセス（読み書き）に的を絞って説明しています。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
メディアデータはデータベースによって管理されています。 Media Store APIを使ってメディアデータへアクセスしているのであれば、データベースの所在や構成などを意識する必要はありません。 ただ、「より複雑な制御をしたい場合」や「デバックを効率化したい場合」などに、データベースの知識が役立ちます。 今回は「メディアデータのデータベースによる管理」について、まとめます。 この記事は、Imagesデータ編です。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
Content ProviderContent ResolverContentValueMedia StoreopenInputStreamopenOutputStreamStorageデザインメディアデータ
「外部ストレージ_プライマリ」に保存されるメディアデータは、Media Storeと呼ばれる特別な方法でアクセスします。 他の方法も可能ですが、Media Storeが最も適した方法です。 この「メディアデータへMedia Storeでアクセス」する方法を、まとめます。 この記事は、Imagesデータ編です。また、基本的なアクセス（読み書き）に的を絞って説明しています。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
メディアデータはデータベースによって管理されています。 Media Store APIを使ってメディアデータへアクセスしているのであれば、データベースの所在や構成などを意識する必要はありません。 ただ、「より複雑な制御をしたい場合」や「デバックを効率化したい場合」などに、データベースの知識が役立ちます。 今回は「メディアデータのデータベースによる管理」について、まとめます。 この記事は、Imagesデータ編です。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
ContentResolver#deleteContentResolver#insertContentResolver#queryContentResolver#updateMedia StoreStorageデザインメディアデータ
「外部ストレージ_プライマリ」に保存されるメディアデータは、Media Storeと呼ばれる特別な方法でアクセスします。 他の方法も可能ですが、Media Storeが最も適した方法です。 別の記事で「メディアデータへMedia Storeでアクセス」する方法を、まとめました。 その記事は、基本的なアクセスとして「追加（insert）＆読み書き」のみを説明しています。 この記事は、上記に加えて「参照（query）・更新（update）・削除（delete）」を説明します。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
ContentResolver#deleteContentResolver#queryContentResolver#updateORDER BY句projectionselectionsortOrderStorageWHERE句デザイン
「外部ストレージ_プライマリ」に保存されるメディアデータは、データベースで管理されます。 Media Storeを使うと、このデータベースを通してメディアデータへアクセスできます。 データベース（SQLite）が持つ検索機能を使ってアクセス対象を絞り込めるので、とても便利です。 この記事は、「絞り込みアクセス」について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
メディアデータはMedia Storeを使ったアクセスが最適です。 その理由は、メディア特有の付加情報を使って、データを管理できるからです。 管理されたデータはブログラムから扱い易いです。また、ユーザの使い勝手（エクスペリエンス）も向上します。 バケットはメディアデータを管理する付加情報の一つです。 無くてもアクセスは可能ですが、積極的に取り入れた方が良いと思います。 今回は「ファイル名とバケットを指定したアクセス」について、まとめます。 「API≦28」と「API≧29」で動作が異なります。注意して下さい。 ※環境：Android Studio Narwhal Feature Drop | 2025.1.2 ...
メディアデータはMedia Storeを使ったアクセスが最適です。 その理由は、メディア特有の付加情報を使って、データを管理できるからです。 管理されたデータはブログラムから扱い易いです。また、ユーザの使い勝手（エクスペリエンス）も向上します。 バケットはメディアデータを管理する付加情報の一つです。 無くてもアクセスは可能ですが、積極的に取り入れた方が良いと思います。 今回は「ファイル名とバケットを指定したアクセス」について、まとめます。 「API≦28」と「API≧29」で動作が異なります。注意して下さい。 ※環境：Android Studio Narwhal Feature Drop | 2025.1.2 ...
createDeleteRequestcreateFavoriteRequestcreateTrashRequestcreateWriteRequestMedia StoreStorageURIデザイン
メディアデータはアプリ間で共有されるので、アプリがデータへアクセスするには、アクセス許可が必要です。 この許可の権限の範囲は、プライバシー保護の観点から、徐々に狭められてきました。 そして、対象範囲別ストレージにおいて、他アプリが所有するファイルへの書き込みは、URI（ファイル）毎の許可が必要になっています。 許可の取得は、ユーザと対話をする形式（ダイアログ）で行われます。手順が少し複雑です。 ここに「他アプリが所有するファイルへ書き込み」する方法を、まとめます。 ※環境：Android Studio Narwhal Feature Drop | 2025.1.2 Patch 1 ...
スポンサーリンク