外部ストレージ_セカンダリにJava/Android APIでアクセス

投稿日: 　更新日:

「外部ストレージ_セカンダリ」にアクセスする方法について、まとめます。

「外部ストレージ_セカンダリ」は、デバイス間（または、アプリ間）で共有するデータを保存するストレージです。

デバイスとは、他の携帯端末やパソコンなどを指します。

ストレージがSDカードのような取り外し可能なリソース上に構築されているので、データの共有は取り外したストレージを他のデバイスへ取り付けて行います。

「外部ストレージ_セカンダリ」に保存したデータは、他のデバイスに公開することになるので、秘匿性の高いデータの保存に適しません。

※環境：Android Studio Narwhal | 2025.1.1 Patch 1

スポンサーリンク

外部ストレージ_セカンダリ

「外部ストレージ_セカンダリ」はデバイス間（または、アプリ間）で共有するデータを保存するストレージです。

保存されるデータは、「ドキュメント・他のファイル」、「アプリ別」に分類されます。

外部ストレージのフォルダ

API≦28API＝29API≧30
# pwd
/storage/0000-0000
# ls -ld * Android/data/com.example.myapp_a/*
drwxrwx--x 3 root   sdcard_rw 2048 2025-07-31 12:18 Android
drwxrwx--x 2 u0_a85 sdcard_rw 2048 2025-07-31 12:20 Android/data/com.example.myapp_a/files
drwxrwx--x 2 root   sdcard_rw 2048 2025-07-31 12:18 LOST.DIR

※エミュレータ（API28）で確認

# pwd
/storage/0E15-260A
# ls -ld * Android/data/com.example.myapp_a/*
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 Alarms
drwxrwx--x 3 root    sdcard_rw 2048 2025-07-31 12:35 Android
drwxrwx--x 2 u0_a146 sdcard_rw 2048 2025-07-31 12:35 Android/data/com.example.myapp_a/files
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 DCIM
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 Download
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 16:35 LOST.DIR
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 Movies
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 Music
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 Notifications
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 Pictures
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 Podcasts
drwxrwx--x 2 root    sdcard_rw 2048 2025-07-31 12:35 Ringtones

※エミュレータ（API29）で確認

# pwd
/storage/12EB-0D1D
# ls -ld * Android/data/com.example.myapp_a/*
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 Alarms
drwxrwx--- 3 root media_rw 2048 2025-07-31 12:41 Android
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 Android/data/com.example.myapp_a/files
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 Audiobooks
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 DCIM
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 Documents
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 Download
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 LOST.DIR
drwxrwx--- 3 root media_rw 2048 2025-07-31 12:41 Movies
drwxrwx--- 3 root media_rw 2048 2025-07-31 12:41 Music
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 Notifications
drwxrwx--- 3 root media_rw 2048 2025-07-31 12:41 Pictures
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 Podcasts
drwxrwx--- 2 root media_rw 2048 2025-07-31 12:41 Ringtones

※エミュレータ（API30）で確認

データを「他のデバイスと共有する」は「他のデバイスに公開する」と同意です。悪意のある人物がSDカードを手に入れた場合に、自分のパソコンを使って内容を盗み見ることが出来てしまします。

ですので、秘匿性の高いデータの保存に適しません。

スポンサーリンク

アクセスの方法

「Java/Android API」によるアクセスが可能です。

ただし、問題点が2つあります。それを理解した上で利用してください。

 問題点1 
アプリ別のパスはAndroid APIから取得出来ますが、ドキュメント・他のファイルのパスは取得できません。APIに取得する手段が用意されていないためです。

ですので、「アクセス可能な範囲はアプリ別の領域のみ」と考えるのが良さそうです。

無理にアクセスしたければ、ドキュメント・他のファイルのパスを、アプリ別の相対パスで作り出すしかありません（△）。

相対パスの例
val _base = this@Activity.getExternalSecondaryFilesDir(null)?.parentFile?.parentFile?.parentFile?.parentFile
// /storage/NNN-NNN/Android/data/パッケージ名/files ⇒ /storage/NNN-NNN
// ↑↑ アプリ別のパス                                   ↑↑ ドキュメント・他のファイルのパス
 問題点2 
作成したファイルは、他のデバイスからアクセスできません。

ですので、「デバイス間で（または、アプリ間）で共有するデータを保存する」という、外部ストレージ_セカンダリの本来の目的が達成できません。

外部ストレージ_セカンダリのアクセスについては「SAF」の利用が最適です（◎）。SAFであれば、共有データを作成できます。

AP≦28AP＝29API≧30
外部ストレージ　セカンダリ
/storage/NNN-NNN/		Java /
Android
API		Media Store
API		SAF
ドキュメント
他のファイル		Downloads
自：×　　　
他：×　　　
自：◎ｗｒ
他：◎ｗｒ
Documents
Android
（Android/dataを除く）
ユーザーフォルダ
ユーザーファイル
アプリ別
（Android/data/パッケージ名/files）
自：○ｗｒ　
他：△　ｒｐ
自：○ｗｒ
他：○ｗｒ
※自：自アプリのファイル
　他：他アプリのファイル
　◎：アクセスできる（最適）
　○：アクセスできる
　△：アクセスできる（不適または制限有）
　×：アクセスできない
　空：アクセスできない（サポート外）
　ｗ：書き込みできる
　ｒ：読み出しできる
　ｐ：パーミッションが必要
外部ストレージ　セカンダリ
/storage/NNN-NNN/		Java /
Android
API		Media Store
API		SAF
ドキュメント
他のファイル		Downloads
自：×　　　
他：×　　　
自：◎ｗｒ
他：◎ｗｒ
Documents
Android
（Android/dataを除く）
ユーザーフォルダ
ユーザーファイル
アプリ別
（Android/data/パッケージ名/files）
自：○ｗｒ　
他：×　　　
自：○ｗｒ
他：○ｗｒ
※自：自アプリのファイル
　他：他アプリのファイル
　◎：アクセスできる（最適）
　○：アクセスできる
　△：アクセスできる（不適または制限有）
　×：アクセスできない
　空：アクセスできない（サポート外）
　ｗ：書き込みできる
　ｒ：読み出しできる
　ｐ：パーミッションが必要
外部ストレージ　セカンダリ
/storage/NNN-NNN/		Java /
Android
API		Media Store
API		SAF
ドキュメント
他のファイル		Downloads
自：△ｗｒ　
他：×　　　
自：◎ｗｒ
他：◎ｗｒ
Documents
Android
（Android/dataを除く）
自：×　　　
他：×　　　
ユーザーフォルダ
ユーザーファイル
アプリ別
（Android/data/パッケージ名/files）
自：○ｗｒ　
他：×　　　
自：×　　
他：×　　
※自：自アプリのファイル
　他：他アプリのファイル
　◎：アクセスできる（最適）
　○：アクセスできる
　△：アクセスできる（不適または制限有）
　×：アクセスできない
　空：アクセスできない（サポート外）
　ｗ：書き込みできる
　ｒ：読み出しできる
　ｐ：パーミッションが必要

「Java/Android API」によるアクセスは「間接的なアクセス」で行います。間接的なアクセスとは、以下の通りです。

 Fileによる間接的なアクセス 

Fileオブジェクトへ前もって保存場所を指定しておきます。Fileオブジェクトが示す場所（パス）にアクセスする方法です。

スポンサーリンク

パーミッションの取得

一部のアクセス（表で「p」の付くもの）で、パミッションの取得が必要です。

※詳細は「外部ストレージへアクセスするパーミッションと権限の範囲」を参照

スポンサーリンク

アプリ別

間接的なアクセスでデータを外部ストレージへ書き込みます。

パス（保存先）の取得

getExternalFilesDirsを使うと、Android APIに定義されているボリューム毎のパスが、配列で取得できます。
※ボリュームについては「ストレージの用途別記憶領域とボリューム」を参照

val _bucket = Environment.DIRECTORY_PICTURES
//val _backet = null
 
val _ctxExtDirs: Array<File> = this@Activity.getExternalFilesDirs(_bucket)

Environment.DIRECTORY_PICTURES      ⇒ /storage/emulated/0/Android/data/パッケージ名/files/Pictures
                                       /storage/NNN-NNN/Android/data/パッケージ名/files/Pictures
null                                ⇒ /storage/emulated/0/Android/data/パッケージ名/files
                                       /storage/NNN-NNN/Android/data/パッケージ名/files

このパスの配列から、プログラムで外部ストレージ_セカンダリのパスを抽出します。

注意点は「ストレージのマウントを確認する」ことです。SDカードが取り外されている場合もあるからです。

fun Context.getExternalSecondaryFilesDir(
    type: String?,
    index: Int = 0
): File? {
    val _dirs = ArrayList<File>()
    val _manager = getSystemService(StorageManager::class.java)

    val _files = getExternalFilesDirs(type)
    _files.forEach {
        val _volume = _manager.getStorageVolume(it)
        val _isActive = _volume?.let {
            (! it.isPrimary) && (it.state == "mounted")
        }?:false
        if(_isActive) _dirs.add(it)
    }

    if(_dirs.size > index) return _dirs[index]
    else throw IOException("Directory not found !")
}

val _bucket = Environment.DIRECTORY_PICTURES
// val _bucket = Environment.DIRECTORY_DCIM
// val _bucket = Environment.DIRECTORY_MOVIES
// val _bucket = Environment.DIRECTORY_MUSIC
// val _bucket = Environment.DIRECTORY_ALARMS
// val _bucket = Environment.DIRECTORY_NOTIFICATIONS
// val _bucket = Environment.DIRECTORY_PODCASTS
// val _bucket = Environment.DIRECTORY_RINGTONES
// val _bucket = Environment.DIRECTORY_DOCUMENTS
// val _bucket = Environment.DIRECTORY_DOWNLOADS
// val _bucket = Environment.DIRECTORY_DOWNLOADS
// val _bucket = Environment.DIRECTORY_DOCUMENTS
// val _bucket = "UserDir"

val _ctxExtDir: File? = this@Activity.getExternalSecondaryFilesDir(_bucket)

パスを取得すると同時に、パスの示すディレクトリツリー全体（Android以下）が、実際のストレージ上に自動作成されます。

また、ストレージが利用できない場合はnullになることがあります。

スポンサーリンク

書き込み

File#outputStreamを用いると、Fileに指定した保存先へ書き込まれます。

fun writeFile_Basic(data: ByteArray, file: File) {
    try {
        file.outputStream().use { stream ->
            stream.write(data)
        }
    } catch (e: Exception) { Log.i(TAG, "[write] ${e}") }
}

getExternalSecondaryFilesDirは「null」を返すことがあります。回避するためにパスのnull判定を行い、nullでない場合のみ書き込みを行うようにします。

                val _path = this@Activity.getExternalSecondaryFilesDir(bucket) // 末端までのディレクトリを自動作成
				_path?.let {
                    val _file = File(it, filename)
                    writeFile_Basic(_data, _file)
                }

# pwd
/storage/0000-0000/Android/data/パッケージ名/files
# ls -ld Pictures Pictures/*
drwxrwx--x 2 u0_a85 sdcard_rw 2048 2025-08-01 01:08 Pictures
-rwxrwx--x 1 u0_a85 sdcard_rw   30 2025-08-01 01:08 Pictures/sample.txt

※エミュレータ（API28）で実行
※「bucket = Environment.DIRECTORY_PICTURES」の時

書き込み以外の操作

その他の操作（読み出し、ファイル削除、ディレクトリ作成/削除、ファイル一覧）は、内部ストレージにアクセスする場合と同じです。
※詳細は「内部ストレージにJava/Android APIでアクセス」を参照

スポンサーリンク
ページのトップへ

関連記事：

ストレージのリソース
Adoptable StorageSDカードStorageデザイン内部メモリー外部メモリー拡張ストレージ追加ストレージ
ストレージのリソースは、内部メモリー、外部メモリー、クラウドの3つがあります。 外部メモリーは、主にSDカードです。 このSDカードはAndroid端末の世代が進むにつれて、扱いを変えてきました。 リソースとSDカードを主眼に置いたストレージの変遷について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
Adoptable Storage（SDカードの扱い方を指定）
Adoptable StorageFUSESDカードStorageデザイン拡張ストレージ追加ストレージ
Adoptable Storage（API≧23、Android 6.0）が導入されて、SDカードの扱い方をユーザ側で指定できるようになりました。 「Adoptable Storage」について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
ストレージの用途別記憶領域とボリューム
Adoptable StorageMedia StoreSDカードStorageStorageManagerStorageVolumeUuidサンドボックスデザインメディアデータ内部ストレージ外部ストレージ
ストレージはデータの用途別に記憶領域が分けられます。 保存先を守らないと、セキュリティリスクが発生したり、他のアプリと協調した動作が出来なくなったり、します。 ですので、適切な場所へデータを保存しましょう。 今回は「用途別記憶領域とボリューム」について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
ストレージへアクセスする方法
Content ProviderContent ResolverMedia StoreSAFStorageStorage Access Frameworkデザイン内部ストレージ外部ストレージ
ストレージへアクセスする方法は、「扱うデータの種類」「アクセス先」「セキュリティの確保」などの要件により、最適なアクセス方法が存在するので、使い分けが必要です。 今回は「アクセスする方法」について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
内部ストレージにJava/Android APIでアクセス
File creation modeStorageアプリ固有サンドボックスデザイン内部ストレージ直接的なアクセス間接的なアクセス
「内部ストレージ」にアクセスする方法について、まとめます。 「内部ストレージ」は、セキュリティが高いうえに、端末の内部メモリーに構築されるので、必ず存在します。 使いたい時に安心して使え、もっとも使い勝手のよいストレージと言えます。 アプリのデータを保存したいならば、保存先として真っ先に考えるストレージです。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
外部ストレージへアクセスするパーミッションと権限の範囲
Storageきめ細かいメディア権限サンドボックスデザインパーミッションメディアデータ外部ストレージ対象範囲別ストレージ
外部ストレージへアクセスするアプリは、パーミッション（許可）をユーザーから取得する必要があります。 パーミッションを得たアプリは、許可された権限の範囲内で、ストレージへアクセスが可能です。 これらは、ユーザーデータのプライバシー保護と密接に関係しています。 プライバシー保護をより強固にするために、パーミッションと権限の範囲の仕様は改変されてきました。 今回は、改変の歴史を辿りつつ、「パーミッションと権限の範囲」について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
外部ストレージ_プライマリにJava/Android APIでアクセス
getExternalFilesDirgetExternalStoragePublicDirectoryMedia StoreStorageデザイン外部ストレージ間接的なアクセス
「外部ストレージ_プライマリ」にアクセスする方法について、まとめます。 「外部ストレージ_プライマリ」は、アプリ間で共有するデータを保存するストレージです。 主にカメラ、音楽プレーヤー、動画プレーヤーで扱うデータを保存します。 「外部ストレージ_プライマリ」に保存したデータは、他のアプリに公開することになるので、秘匿性の高いデータの保存に適しません。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
ImagesデータへMedia Storeでアクセス（API≦28）
Content ProviderContent ResolverContentValueMedia StoreopenInputStreamopenOutputStreamStorageデザインメディアデータ
「外部ストレージ_プライマリ」に保存されるメディアデータは、Media Storeと呼ばれる特別な方法でアクセスします。 他の方法も可能ですが、Media Storeが最も適した方法です。 この「メディアデータへMedia Storeでアクセス」する方法を、まとめます。 この記事は、Imagesデータ編です。また、基本的なアクセス（読み書き）に的を絞って説明しています。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
Imagesデータのデータベースによる管理（API≦28）
filesテーブルimagesテーブルMedia Storemedia_typeStorageデザインメディアデータ
メディアデータはデータベースによって管理されています。 Media Store APIを使ってメディアデータへアクセスしているのであれば、データベースの所在や構成などを意識する必要はありません。 ただ、「より複雑な制御をしたい場合」や「デバックを効率化したい場合」などに、データベースの知識が役立ちます。 今回は「メディアデータのデータベースによる管理」について、まとめます。 この記事は、Imagesデータ編です。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
ImagesデータへMedia Storeでアクセス（API≧29）
Content ProviderContent ResolverContentValueMedia StoreopenInputStreamopenOutputStreamStorageデザインメディアデータ
「外部ストレージ_プライマリ」に保存されるメディアデータは、Media Storeと呼ばれる特別な方法でアクセスします。 他の方法も可能ですが、Media Storeが最も適した方法です。 この「メディアデータへMedia Storeでアクセス」する方法を、まとめます。 この記事は、Imagesデータ編です。また、基本的なアクセス（読み書き）に的を絞って説明しています。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
Imagesデータのデータベースによる管理（API≧29）
filesテーブルimagesテーブルMedia Storemedia_typeStorageデザインメディアデータ
メディアデータはデータベースによって管理されています。 Media Store APIを使ってメディアデータへアクセスしているのであれば、データベースの所在や構成などを意識する必要はありません。 ただ、「より複雑な制御をしたい場合」や「デバックを効率化したい場合」などに、データベースの知識が役立ちます。 今回は「メディアデータのデータベースによる管理」について、まとめます。 この記事は、Imagesデータ編です。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
メディアデータへMedia Storeで追加・参照・更新・削除
ContentResolver#deleteContentResolver#insertContentResolver#queryContentResolver#updateMedia StoreStorageデザインメディアデータ
「外部ストレージ_プライマリ」に保存されるメディアデータは、Media Storeと呼ばれる特別な方法でアクセスします。 他の方法も可能ですが、Media Storeが最も適した方法です。 別の記事で「メディアデータへMedia Storeでアクセス」する方法を、まとめました。 その記事は、基本的なアクセスとして「追加（insert）＆読み書き」のみを説明しています。 この記事は、上記に加えて「参照（query）・更新（update）・削除（delete）」を説明します。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
メディアデータへMedia Storeで絞り込みアクセス
ContentResolver#deleteContentResolver#queryContentResolver#updateORDER BY句projectionselectionsortOrderStorageWHERE句デザイン
「外部ストレージ_プライマリ」に保存されるメディアデータは、データベースで管理されます。 Media Storeを使うと、このデータベースを通してメディアデータへアクセスできます。 データベース（SQLite）が持つ検索機能を使ってアクセス対象を絞り込めるので、とても便利です。 この記事は、「絞り込みアクセス」について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...
続きを読む
Media Storeでファイル名とバケットを指定したアクセス（API≦28）
bucketMedia Storemedia_typeStorageデザインバケットメディアタイプ
メディアデータはMedia Storeを使ったアクセスが最適です。 その理由は、メディア特有の付加情報を使って、データを管理できるからです。 管理されたデータはブログラムから扱い易いです。また、ユーザの使い勝手（エクスペリエンス）も向上します。 バケットはメディアデータを管理する付加情報の一つです。 無くてもアクセスは可能ですが、積極的に取り入れた方が良いと思います。 今回は「ファイル名とバケットを指定したアクセス」について、まとめます。 「API≦28」と「API≧29」で動作が異なります。注意して下さい。 ※環境：Android Studio Narwhal Feature Drop | 2025.1.2 ...
続きを読む
Media Storeでファイル名とバケットを指定したアクセス（API≧29）
bucketMedia Storemedia_typerelative_pathStorageデザインバケットメディアタイプ
メディアデータはMedia Storeを使ったアクセスが最適です。 その理由は、メディア特有の付加情報を使って、データを管理できるからです。 管理されたデータはブログラムから扱い易いです。また、ユーザの使い勝手（エクスペリエンス）も向上します。 バケットはメディアデータを管理する付加情報の一つです。 無くてもアクセスは可能ですが、積極的に取り入れた方が良いと思います。 今回は「ファイル名とバケットを指定したアクセス」について、まとめます。 「API≦28」と「API≧29」で動作が異なります。注意して下さい。 ※環境：Android Studio Narwhal Feature Drop | 2025.1.2 ...
続きを読む
Media Storeで他アプリが所有するファイルへ書き込み
createDeleteRequestcreateFavoriteRequestcreateTrashRequestcreateWriteRequestMedia StoreStorageURIデザイン
メディアデータはアプリ間で共有されるので、アプリがデータへアクセスするには、アクセス許可が必要です。 この許可の権限の範囲は、プライバシー保護の観点から、徐々に狭められてきました。 そして、対象範囲別ストレージにおいて、他アプリが所有するファイルへの書き込みは、URI（ファイル）毎の許可が必要になっています。 許可の取得は、ユーザと対話をする形式（ダイアログ）で行われます。手順が少し複雑です。 ここに「他アプリが所有するファイルへ書き込み」する方法を、まとめます。 ※環境：Android Studio Narwhal Feature Drop | 2025.1.2 Patch 1 ...
続きを読む
スポンサーリンク