萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 文件讀寫完整指南:Raw、Assets、內部儲存、外部儲存、Scoped Storage 適配

儲存位置分類與選擇策略

位置API權限存取範圍適用場景備份/卸載行為
res/raw`getResources().openRawResource(R.raw.xxx)`無唯讀、打包在 APK預設設定檔、預置資料庫、靜態模板App 更新覆蓋、卸載刪除
assets/`getAssets().open("file")`無唯讀、目錄結構保留、打包在 APK字體、HTML/CSS/JS、大型預置資料 (配合複製到內部儲存)同 raw
內部儲存
`/data/data/pkg/files/`
`openFileOutput()`
`openFileInput()`
`context.filesDir`
`context.cacheDir`
無 (私有)**完全私有**,其他 App 不可見 (除非 `MODE_WORLD_READABLE` 已棄用)用戶資料、Token、資料庫、快取、私密圖片**卸載自動刪除**;備份含此目錄 (Auto Backup)
外部儲存 (舊)
`/sdcard/`
`Environment.getExternalStorageDirectory()`
`File` API
`READ/WRITE_EXTERNAL_STORAGE`**全域可見** (Android 10 前)相片、下載、匯出檔案、分享檔案卸載**不刪除** (用戶可見)
外部儲存 (Scoped Storage)
Android 10+ (API 29+)
`context.getExternalFilesDir()`
`context.getExternalCacheDir()`
`MediaStore` API
`StorageAccessFramework` (SAF)
**自有目錄免權限**
媒體檔需 `READ_MEDIA_*`
其他檔需 SAF 用戶授權
**應用專屬目錄** 私有;
公共媒體庫 (MediaStore) 需權限;
任意目錄需 SAF 選擇器
應用專屬檔案、用戶導出媒體、文件選擇器應用專屬目錄**卸載刪除**;MediaStore 檔案保留

核心 API 實戰範例

1. 讀取 raw / assets (唯讀)

// raw
String readRaw(Context ctx, @RawRes int resId) throws IOException {
    try (InputStream is = ctx.getResources().openRawResource(resId);
         BufferedReader br = new BufferedReader(new InputStreamReader(is, StandardCharsets.UTF_8))) {
        return br.lines().collect(Collectors.joining("\n"));
    }
}

// assets (支援子目錄)
String readAsset(Context ctx, String fileName) throws IOException {
    try (InputStream is = ctx.getAssets().open(fileName);
         BufferedReader br = new BufferedReader(new InputStreamReader(is, StandardCharsets.UTF_8))) {
        return br.lines().collect(Collectors.joining("\n"));
    }
}

2. 內部儲存 (私有、免權限、卸載刪除)

// 寫入
void writeInternal(Context ctx, String fileName, String content) throws IOException {
    try (FileOutputStream fos = ctx.openFileOutput(fileName, Context.MODE_PRIVATE);
         OutputStreamWriter osw = new OutputStreamWriter(fos, StandardCharsets.UTF_8);
         BufferedWriter bw = new BufferedWriter(osw)) {
        bw.write(content);
    }
}

// 讀取
String readInternal(Context ctx, String fileName) throws IOException {
    try (FileInputStream fis = ctx.openFileInput(fileName);
         BufferedReader br = new BufferedReader(new InputStreamReader(fis, StandardCharsets.UTF_8))) {
        return br.lines().collect(Collectors.joining("\n"));
    }
}

// 列出/刪除
String[] list = ctx.fileList();
ctx.deleteFile(fileName);
File filesDir = ctx.getFilesDir(); // 任意 File 操作
File cacheDir = ctx.getCacheDir(); // 系統可隨時清理

3. 外部儲存 - Scoped Storage 時代 (Android 10+)

應用專屬目錄 (免權限、卸載刪除)

// 寫入
void writeExternalAppDir(Context ctx, String fileName, byte[] data) throws IOException {
    File dir = ctx.getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS); // 或 null 為根目錄
    File file = new File(dir, fileName);
    try (FileOutputStream fos = new FileOutputStream(file)) {
        fos.write(data);
    }
}

// 讀取
byte[] readExternalAppDir(Context ctx, String fileName) throws IOException {
    File file = new File(ctx.getExternalFilesDir(null), fileName);
    try (FileInputStream fis = new FileInputStream(file)) {
        return fis.readAllBytes();
    }
}

MediaStore (圖片/影片/音訊,需權限、卸載保留)

// 插入圖片 (Android 10+)
Uri insertImage(Context ctx, Bitmap bitmap, String displayName) throws IOException {
    ContentValues values = new ContentValues();
    values.put(MediaStore.Images.Media.DISPLAY_NAME, displayName);
    values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");
    values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/MyApp");
    Uri uri = ctx.getContentResolver().insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
    try (OutputStream os = ctx.getContentResolver().openOutputStream(uri)) {
        bitmap.compress(Bitmap.CompressFormat.JPEG, 90, os);
    }
    return uri;
}

// 查詢圖片
Cursor queryImages(Context ctx) {
    String[] proj = {MediaStore.Images.Media._ID, MediaStore.Images.Media.DISPLAY_NAME, MediaStore.Images.Media.DATA};
    return ctx.getContentResolver().query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, proj, null, null, null);
}

Storage Access Framework (SAF) - 讓用戶選擇任意目錄/檔案

// 開啟目錄選擇器 (建立/寫入檔案)
Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
intent.addCategory(Intent.CATEGORY_OPENABLE);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_TITLE, "notes.txt");
startActivityForResult(intent, REQ_CREATE_FILE);

// 接收結果
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    if (requestCode == REQ_CREATE_FILE && resultCode == RESULT_OK && data != null) {
        Uri uri = data.getData();
        // 取得可持久化的 URI 權限
        getContentResolver().takePersistableUriPermission(uri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
        // 寫入
        try (OutputStream os = getContentResolver().openOutputStream(uri)) {
            os.write("Hello SAF".getBytes(StandardCharsets.UTF_8));
        }
    }
}

Android 版本適配關鍵點

  • Android 9 (API 28) 及以下:`WRITE_EXTERNAL_STORAGE` 即可自由讀寫 `/sdcard/`。
  • Android 10 (API 29):預設啟用 Scoped Storage。`requestLegacyExternalStorage="true"` 可暫時退回舊模式 (過渡期)。
  • Android 11 (API 30) +:強制 Scoped Storage。`requestLegacyExternalStorage` 無效。
    **只能**存取:
    ① `getExternalFilesDir()` / `getExternalCacheDir()` (免權限)
    ② MediaStore 媒體檔 (需 `READ_MEDIA_IMAGES/VIDEO/AUDIO`)
    ③ SAF 用戶授權的檔案/目錄 (需 `MANAGE_EXTERNAL_STORAGE` 特殊權限極難申請)

最佳實踐清單

  1. **優先使用內部儲存** (`filesDir`/`cacheDir`) 存放私有資料,無權限煩惱、自動備份/刪除。
  2. **用戶可見媒體** (相片、影片、音樂) → **MediaStore**。
  3. **用戶導出/匯入文件** (CSV、PDF、備份檔) → **SAF (ACTION_CREATE_DOCUMENT / ACTION_OPEN_DOCUMENT / ACTION_OPEN_DOCUMENT_TREE)**。
  4. **大型唯讀資產** (字體、地圖離線包) → **assets** + 首次啟動複製到內部儲存 (配合進度條)。
  5. **統一使用 `File` + `ContentResolver` + `MediaStore` API**,避免硬編碼路徑 (`/sdcard/...`)。
  6. **編碼統一指定 UTF-8**,避免中文亂碼。
  7. **IO 操作放入背景執行緒** (Coroutines `Dispatchers.IO` / RxJava `Schedulers.io()` / `ExecutorService`)。

總結

Android 儲存體模型經歷「全域共享 → Scoped Storage 隔離」演進。理解 **私有 vs 共享、卸載行為、權限模型、API 版本差異**,並採用 **內部儲存為主、MediaStore 存媒體、SAF 交互用戶檔案** 的分層策略,即可構建相容全版本、符合隱私規範、用戶體驗良好的文件管理功能。

copyright © 萬盛學電腦網 all rights reserved