[Android] Storage Access Framework でドキュメントを保存する

共有メモリにファイルを保存するためにSAF(Storage Access Framework)を利用します。ファイル保存に使うのは ACTION_CREATE_DOCUMENTです。取り出したい場合は ACTION_OPEN_DOCUMENT を使います。

Android Studio 4.1
API 30

SAF, Storage Access Framework

　
API 19よりSAFを使うことによりコンテンツを容易に参照できるようになりました。

ドキュメントストレージプロバイダ全体から簡単にドキュメント、画像、その他のファイルを参照して開くことができる
標準の Picker UI により、アプリやプロバイダを通じて一貫性のある方法でファイルにアクセスできる

図 2. ストレージアクセスフレームワークのフロー
Ref:ストレージアクセスフレームワーク

目次
1. Intent ACTION_CREATE
2. サンプルコード
3. サンプル動画

Intent ACTION_CREATE

　
テキストファイルをSAFを使って保存します。

IntentはACTION_CREATE_DOCUMENT
setTypeでMIMEの設定
EXTRA_TITLEでは名前を設定する時のデフォルト候補。
　

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
intent.addCategory(Intent.CATEGORY_OPENABLE);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_TITLE, "text_file.txt");

startActivityForResult(intent, CREATE_FILE);

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);

intent.addCategory(Intent.CATEGORY_OPENABLE);

intent.setType("text/plain");

intent.putExtra(Intent.EXTRA_TITLE, "text_file.txt");

startActivityForResult(intent, CREATE_FILE);

　
onActivityResultでUriが返ってきます。そのUriに出力していきます。

サンプルコード

　
テキストファイルに「Storage Access Framework」の文字列を入れてそれを保存してみます。

MainActivity.java

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.app.Activity;
import android.content.Intent;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.net.Uri;
import android.provider.DocumentsContract;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
import android.widget.TextView;

import java.io.OutputStream;
import java.util.Locale;

public class MainActivity extends AppCompatActivity {

    private static final int CREATE_FILE = 1002;
    private TextView textView;

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

        textView = findViewById(R.id.text_view);

        Button button = findViewById(R.id.button);
        button.setOnClickListener( v -> {
            createFile();
        });
    }

    private void createFile() {
        String fileName = "text_file.txt";

        Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        intent.setType("text/plain");
        intent.putExtra(Intent.EXTRA_TITLE, fileName);

        startActivityForResult(intent, CREATE_FILE);
    }

    @Override
    public void onActivityResult(int requestCode, int resultCode, Intent resultData) {
        super.onActivityResult(requestCode, resultCode,resultData );

        if (requestCode == CREATE_FILE && resultCode == Activity.RESULT_OK) {
            if(resultData.getData() != null){

                Uri uri = resultData.getData();

                // Uriを表示
                textView.setText(
                        String.format(Locale.US, "Uri:　%s",uri.toString()));

                String str = "Storage Access Framework\n";
                try(OutputStream outputStream =
                            getContentResolver().openOutputStream(uri)) {
                    if(outputStream != null){
                        outputStream.write(str.getBytes());
                    }

                } catch(Exception e){
                    e.printStackTrace();
                }
            }
        }
    }
}

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.app.Activity;

import android.content.Intent;

import android.graphics.Bitmap;

import android.graphics.BitmapFactory;

import android.net.Uri;

import android.provider.DocumentsContract;

import android.view.View;

import android.widget.Button;

import android.widget.ImageView;

import android.widget.TextView;

import java.io.OutputStream;

import java.util.Locale;

public class MainActivity extends AppCompatActivity {

private static final int CREATE_FILE = 1002;

private TextView textView;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

textView = findViewById(R.id.text_view);

Button button = findViewById(R.id.button);

button.setOnClickListener( v -> {

createFile();

});

}

private void createFile() {

String fileName = "text_file.txt";

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);

intent.addCategory(Intent.CATEGORY_OPENABLE);

intent.setType("text/plain");

intent.putExtra(Intent.EXTRA_TITLE, fileName);

startActivityForResult(intent, CREATE_FILE);

}

@Override

public void onActivityResult(int requestCode, int resultCode, Intent resultData) {

super.onActivityResult(requestCode, resultCode,resultData );

if (requestCode == CREATE_FILE && resultCode == Activity.RESULT_OK) {

if(resultData.getData() != null){

Uri uri = resultData.getData();

// Uriを表示

textView.setText(

String.format(Locale.US, "Uri:　%s",uri.toString()));

String str = "Storage Access Framework\n";

try(OutputStream outputStream =

getContentResolver().openOutputStream(uri)) {

if(outputStream != null){

outputStream.write(str.getBytes());

}

} catch(Exception e){

e.printStackTrace();

}

その他ファイル

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:background="#fee"
    android:gravity="center_horizontal"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/text_view"
        android:textColor="#000"
        android:layout_margin="10dp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <Button
        android:id="@+id/button"
        android:text="@string/button"
        android:layout_margin="10dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <ImageView
        android:id="@+id/image_view"
        android:scaleType="centerInside"
        android:contentDescription="@string/description"
        android:layout_margin="10dp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="vertical"

android:background="#fee"

android:gravity="center_horizontal"

tools:context=".MainActivity">

<TextView

android:id="@+id/text_view"

android:textColor="#000"

android:layout_margin="10dp"

android:layout_width="match_parent"

android:layout_height="wrap_content" />

<Button

android:id="@+id/button"

android:text="@string/button"

android:layout_margin="10dp"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

<ImageView

android:id="@+id/image_view"

android:scaleType="centerInside"

android:contentDescription="@string/description"

android:layout_margin="10dp"

android:layout_width="match_parent"

android:layout_height="wrap_content" />

</LinearLayout>

　
strings.xml

<resources>
    <string name="app_name">YourApp Name</string>
    <string name="button">Save File</string>
    <string name="description">a picture</string>
</resources>

<string name="app_name">YourApp Name</string>

<string name="description">a picture</string>

</resources>

　
実行してボタンをタップすると共有ストレージの「Downloads」に移行して、そこに保存できます。

adb を使ってストレージを覗いてみると、text_file.txt が存在します。
また、ファイル内容も想定したものです。

C:\Users\hoge>adb shell
generic_x86_arm:/ $ ls
acct  bugreports  d            debug_ramdisk  etc              linkerconfig  mnt  proc     sdcard   system
apex  cache       data         default.prop   init             lost+found    odm  product  storage  system_ext
bin   config      data_mirror  dev            init.environ.rc  metadata      oem  res      sys      vendor
generic_x86_arm:/sdcard/Download $ ls -la
total 16
-rw------- 1 u0_a151 u0_a151 24 2020-11-02 23:00 data-storage.pdf
-rw------- 1 u0_a151 u0_a151 25 2020-11-02 23:17 text_file.txt
generic_x86_arm:/sdcard/Download $ cat text_file.txt
Storage Access Framework
generic_x86_arm:/sdcard/Download $

C:\Users\hoge>adb shell

generic_x86_arm:/ $ ls

acct bugreports d debug_ramdisk etc linkerconfig mnt proc sdcard system

apex cache data default.prop init lost+found odm product storage system_ext

bin config data_mirror dev init.environ.rc metadata oem res sys vendor

generic_x86_arm:/sdcard/Download $ ls -la

total 16

-rw------- 1 u0_a151 u0_a151 24 2020-11-02 23:00 data-storage.pdf

-rw------- 1 u0_a151 u0_a151 25 2020-11-02 23:17 text_file.txt

generic_x86_arm:/sdcard/Download $ cat text_file.txt

Storage Access Framework

generic_x86_arm:/sdcard/Download $

画像ファイルの保存

　
SAFを使って「Download」ディレクトリにテキストファイルを保存しましたが、同じように画像を保存することも可能です。
　

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
intent.setType("image/*");
intent.putExtra(Intent.EXTRA_TITLE, "sample_image.jpg");
startActivityForResult(intent, REQUEST_SAVE_IMAGE);

...

try(OutputStream outputStream =
                            getContentResolver().openOutputStream(uri)) {
    bmp.compress(Bitmap.CompressFormat.PNG, 100, outputStream);
} catch(Exception e){
    e.printStackTrace();
}