วิธีแสดงรายการไฟล์จาก SD Card พร้อม Runtime Permission ใน Android

ภาพรวม

ตัวอย่างนี้สาธิตวิธีอ่านรายการไฟล์และโฟลเดอร์จาก External Storage (SD Card) พร้อมการขอ Runtime Permission

ขั้นตอนที่ 1: สร้างโปรเจกต์ใหม่

Android Studio → File → New Project → กรอกรายละเอียด

ขั้นตอนที่ 2: ออกแบบ Layout (res/layout/activity_main.xml)

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

    <Button
        android:id="@+id/read"
        android:text="Read Files"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <ListView
        android:id="@+id/list"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
    </ListView>
</LinearLayout>

ขั้นตอนที่ 3: เขียน MainActivity.java (ปรับปรุงให้ถูกต้อง)

package com.example.andy.myapplication;

import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.os.Environment;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.Button;
import android.widget.ListView;
import android.widget.Toast;
import java.io.File;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;

public class MainActivity extends AppCompatActivity {
    private static final int PERMISSION_REQUEST_CODE = 100;
    Button read;
    ListView listview;
    ArrayList<String> myList;
    ArrayAdapter<String> arrayAdapter;

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

        listview = findViewById(R.id.list);
        read = findViewById(R.id.read);
        myList = new ArrayList<>();
        arrayAdapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, myList);
        listview.setAdapter(arrayAdapter);

        read.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String state = Environment.getExternalStorageState();
                
                if (Environment.MEDIA_MOUNTED.equals(state)) {
                    if (Build.VERSION.SDK_INT >= 23) {
                        if (checkPermission()) {
                            listFiles();
                        } else {
                            requestPermission();
                        }
                    } else {
                        listFiles();
                    }
                } else {
                    Toast.makeText(MainActivity.this, "External Storage ไม่พร้อมใช้งาน", Toast.LENGTH_SHORT).show();
                }
            }
        });
    }

    private void listFiles() {
        myList.clear();
        
        File dir = new File(Environment.getExternalStorageDirectory().getAbsolutePath());
        
        if (dir.exists() && dir.isDirectory()) {
            Log.d("path", dir.toString());
            File[] list = dir.listFiles();
            
            if (list != null && list.length > 0) {
                // เรียงลำดับ: โฟลเดอร์ก่อน แล้วค่อยไฟล์
                Arrays.sort(list, (f1, f2) -> {
                    if (f1.isDirectory() && !f2.isDirectory()) return -1;
                    if (!f1.isDirectory() && f2.isDirectory()) return 1;
                    return f1.getName().compareToIgnoreCase(f2.getName());
                });
                
                for (File file : list) {
                    String prefix = file.isDirectory() ? "📁 " : "📄 ";
                    myList.add(prefix + file.getName());
                }
            } else {
                myList.add("(โฟลเดอร์ว่าง)");
            }
        } else {
            myList.add("ไม่พบ External Storage");
        }
        
        arrayAdapter.notifyDataSetChanged();
    }

    private boolean checkPermission() {
        int result = ContextCompat.checkSelfPermission(this, android.Manifest.permission.READ_EXTERNAL_STORAGE);
        return result == PackageManager.PERMISSION_GRANTED;
    }

    private void requestPermission() {
        if (ActivityCompat.shouldShowRequestPermissionRationale(this, android.Manifest.permission.READ_EXTERNAL_STORAGE)) {
            Toast.makeText(this, "ต้องการสิทธิ์อ่าน External Storage กรุณาอนุญาตใน Settings", Toast.LENGTH_LONG).show();
        } else {
            ActivityCompat.requestPermissions(this, new String[]{android.Manifest.permission.READ_EXTERNAL_STORAGE}, PERMISSION_REQUEST_CODE);
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == PERMISSION_REQUEST_CODE) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                Log.e("value", "Permission Granted");
                listFiles();
            } else {
                Log.e("value", "Permission Denied");
                Toast.makeText(this, "ไม่ได้รับอนุญาต ไม่สามารถอ่านไฟล์ได้", Toast.LENGTH_SHORT).show();
            }
        }
    }
}

การปรับปรุงจากโค้ดต้นฉบับ:

• แก้ไขข้อผิดพลาด Syntax (ตัวดำเนินการ < แทน =, &amp;&amp;)
• เพิ่มการตรวจสอบ null และ isDirectory()
• เพิ่มการเรียงลำดับ (โฟลเดอร์ก่อน ไฟล์ท้าย)
• เพไอคอน 📁 📄 แยกประเภท
• ใช้ ArrayAdapter เป็น Field เพื่อ notifyDataSetChanged() ได้
• ลดโค้ดซ้ำด้วย method แยก

ขั้นตอนที่ 4: กำหนดสิทธิ์ใน AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.andy.myapplication">

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

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

การทดสอบและผลลัพธ์

ข้อมูลสำคัญสำหรับ Android 10+ (Scoped Storage)

การเปลี่ยนแปลง

• Android 10 (API 29): ใช้ android:requestLegacyExternalStorage="true" ใน Manifest ได้
• Android 11+ (API 30+): ไม่สามารถใช้ Environment.getExternalStorageDirectory() และ listFiles() ได้แล้ว

ทางเลือกสำหรับ Android 10+

1. ใช้ MediaStore API (สำหรับไฟล์สื่อ)

String[] projection = {MediaStore.Files.FileColumns._ID, MediaStore.Files.FileColumns.DISPLAY_NAME};
Uri collection = MediaStore.Files.getContentUri("external");
Cursor cursor = getContentResolver().query(collection, projection, null, null, null);

2. ใช้ Storage Access Framework (SAF) - แนะนำ

// เปิด Directory Picker
Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
startActivityForResult(intent, REQUEST_CODE);

// ใน onActivityResult
Uri treeUri = data.getData();
DocumentFile tree = DocumentFile.fromTreeUri(this, treeUri);
for (DocumentFile file : tree.listFiles()) {
    Log.d("FILE", file.getName() + " - " + (file.isDirectory() ? "DIR" : "FILE"));
}

3. ใช้ getExternalFilesDir() (ไม่ต้อง Permission)

File dir = getExternalFilesDir(null); // โฟลเดอร์ส่วนตัวของแอป
File[] files = dir.listFiles(); // ทำงานได้ในทุก Android Version

สรุป

การแสดงรายการไฟล์จาก SD Card ต้องขอ READ_EXTERNAL_STORAGE Permission สำหรับ Android 6.0-9.0 สำหรับ Android 10+ ควรใช้ SAF (Storage Access Framework) หรือ MediaStore API แทนการเข้าถึง File System โดยตรง