Android：SAFを利用してオブションメニューからファイル選択画面を呼び出し、txtファイルを表示してみた。

# 1.はじめに
　山田著「[初めてのAndroid開発Kotlin編](https://www.shuwasystem.co.jp/book/9784798065106.html)」の478ページにStorage Access Framework（SAF）を利用してテキストファイルを開くサンプルアプリが掲載されている。このアプリは、起動した直後にファイル選択画面が呼び出されるのだが、この点に少し不満を感じた。
　そこで、改造してオプションメニューを付けることとした。
 動作のイメージは以下のスクリーンショットを参考にしてください。
 ![Screenshot_20240928_163412.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/501068/b3aa3edc-5743-a41d-f75b-7769166f6d17.png)　![Screenshot_20240928_163533.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/501068/652c1720-2aec-242e-c7b2-e8979850294c.png)

![Screenshot_20240928_163556.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/501068/ab5404ec-d7fc-02fa-8f33-7cd22a1c5d90.png)　![Screenshot_20240928_163607.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/501068/d0da9ac4-d379-1c6e-d02c-c6859cc0bbd6.png)

# 2.参考文献
山田著「[初めてのAndroid開発Kotlin編](https://www.shuwasystem.co.jp/book/9784798065106.html)」
p411,478


# 3.ソースコード
(ソースコードを[Github](https://github.com/let-us-study-with-textvoice/TextVoicePlayerForAndroid)上に公開しました。
Git（GitHub）のtag:SAF_OptionMenu(コミットハッシュ:5ce75e0e57d52181396fd25e6728cbf3251fa910)がこの記事と同じレビジョンだと思います。間違えていたらごめんなさい。）
今後、時々、機能が追加され、コードが増えていきます。）
# 3.1 オプションメニューを表示する領域を確保するために、アクションバーを表示する
以前投稿した「[メニューバーを表示する方法](https://qiita.com/guijiu/items/907ad0a5a284042de7de)」を参考にしてください。

# 3.2 MainActivity
　参考文献p478と比べ、MainActivbityで工夫した点は、同p411のように変数startForResultを作り、ActivityResultLancherのインスタンスを代入したこと。変数startForResultはonCreate()メソッドとonOptionsItemSelected()メソッドの両方で使われるので、クラス直下の変数とし、遅延初期化(lateinit)とした。
　変数startForResultがActivityResultLancher<Ｉ>型（クラス）であることは、参考文献p411に掲載されていたが、そのＩが何総称型(ジェネリックス)かわからず、とりあえずコードを打ち込んでみたら、IntentであることをAndroidStuidoが教えてくれた（さすが、AndroidStuido、ほっとした。）
 
```kotlin:MainActivity.kt
package io.github.let_us_study_with_textvoice.textvoiceplayerforandroid

import android.content.Intent
import android.os.Bundle
import android.util.Log
import android.view.Menu
import android.view.MenuItem
import android.widget.TextView
import androidx.activity.enableEdgeToEdge
import androidx.activity.result.ActivityResultLauncher
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat

class MainActivity : AppCompatActivity() {
    lateinit var startForResult : ActivityResultLauncher<Intent>

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        setContentView(R.layout.activity_main)
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
            val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
            insets
        }
        val textSTS = findViewById<TextView>(R.id.textSTS)

        // ファイル選択画面を起動するための準備と、ファイル選択後の処理
        startForResult = registerForActivityResult(
        ActivityResultContracts.StartActivityForResult()
        ) { result ->
            // 選択時の処理
            if (result.resultCode == RESULT_OK) {
                result.data?.data?.let {
                    val str = StringBuilder()
                    // ファイルから行単位に読み込み、その内容をStringBuilderに保存
                    contentResolver.openInputStream(it)
                        ?.bufferedReader()
                        ?.forEachLine {
                            str.append(it)
                            str.append(System.lineSeparator())
                        }
                    // StringBuilderの内容をテキストエリアに反映
                    textSTS.setText(str.toString())
                }
            }
        }
    }

    // StorageAccessFramewokeを使って、ファイルを選択する
    fun openSTS_a() {
        startForResult.launch(
            Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
                type = "text/plain"
                putExtra(Intent.EXTRA_TITLE, "textSTS.txt")
                // Android端末の\sdscar\Downloadディレクトリに何かテキストファイルを入れておく。
             }
        )
    }
    
    // オプションメニューのビューをインフレートする
    override fun onCreateOptionsMenu(menu: Menu?): Boolean {
        menuInflater.inflate(R.menu.option_menu, menu)
        return super.onCreateOptionsMenu(menu)
    }
    
    // オプションメニューを選択した時の処理
    override fun onOptionsItemSelected(item: MenuItem): Boolean {
        Log.d("itemtitle", item.title.toString())

        when (item.itemId) {
            R.id.menuListOptionOpenVoice -> {}

            R.id.menuListOptionOpenSTS -> { openSTS_a() }

            R.id.menuListOptionOpenVoiceSTS -> {}
        }
        return super.onOptionsItemSelected(item)
    }
}

```

## 3.3 その他のコード
　その他のactivity_main.xmlやoption_menu.xmlは特別変わったことをしていないので掲載を省略します。参考文献などを参照してください。

 #4 今後の予定
 このアプリは、以前紹介した[語学学習用アプリ　TextVoicePlayer](https://qiita.com/guijiu/items/f7382ca825e126c2b436#sts%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E5%86%8D%E7%94%9F%E8%A1%A8%E7%A4%BA%E3%81%99%E3%82%8B%E3%81%9F%E3%82%81%E3%81%AB%E3%81%AF)のAndroid版にです。今後、音声ファイルを再生するよう作り込んでいきます。