Android 應對不同機型存儲路徑差異的最佳實踐

Android 設備存儲路徑差異巨大：有無 SD 卡、內部存儲劃分方式、可移動存儲掛載點等。正確獲取可用存儲目錄應使用系統 API 而非硬編碼路徑。

核心 API 方法

1. 獲取應用專屬外部存儲目錄 (推薦，無需權限)

// 返回: /storage/emulated/0/Android/data/com.example.app/files/
// 或: /storage/sdcard1/Android/data/com.example.app/files/ (次級外部存儲)
File appExternalDir = context.getExternalFilesDir(null); // 根目錄
File appExternalPicsDir = context.getExternalFilesDir(Environment.DIRECTORY_PICTURES); // 圖片子目錄
// 卸載應用時自動刪除，無需權限 (API 19+)

2. 獲取公共外部存儲目錄 (需權限，媒體文件適用)

// 返回: /storage/emulated/0/Pictures/ 等
File publicPicsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
// 需 READ/WRITE_EXTERNAL_STORAGE 權限 (API 29 以下)

3. 獲取所有外部存儲卷 (多存儲設備)

// API 19+ (KitKat)
File[] externalDirs = context.getExternalFilesDirs(null);
// 返回數組: [主外部存儲, 次級外部存儲(SD卡), ...]
// 遍歷查找可用、空間充足的目錄
for (File dir : externalDirs) {
    if (dir != null && dir.exists() && dir.canWrite()) {
        long freeSpace = dir.getUsableSpace();
        if (freeSpace > REQUIRED_SPACE) {
            // 使用此目錄
            break;
        }
    }
}

4. 內部存儲 (始終可用、私有、無需權限)

// 返回: /data/user/0/com.example.app/files/
File internalDir = context.getFilesDir();
// 返回: /data/user/0/com.example.app/cache/
File cacheDir = context.getCacheDir();
// 空間有限，僅存關鍵小文件

存儲選擇決策樹

File chooseStorageDir(Context context, long requiredSpace) {
    // 1. 嘗試應用專屬外部存儲 (首選)
    File[] externalDirs = context.getExternalFilesDirs(null);
    for (File dir : externalDirs) {
        if (dir != null && dir.getUsableSpace() >= requiredSpace) {
            return dir;
        }
    }
    
    // 2. 回退內部存儲
    File internalDir = context.getFilesDir();
    if (internalDir.getUsableSpace() >= requiredSpace) {
        return internalDir;
    }
    
    // 3. 最後嘗試緩存目錄 (可能被系統清理)
    return context.getCacheDir();
}

Android 版本差異處理

最佳實踐總結

1. 優先使用 getExternalFilesDir()：無需權限、應用專屬、自動清理、跨設備兼容
2. 大文件檢查可用空間：dir.getUsableSpace() >= requiredBytes
3. 多存儲卷遍歷選擇：getExternalFilesDirs() 返回所有可用卷
4. 避免硬編碼路徑：/sdcard/、/storage/emulated/0/ 等不可靠
5. 適配分區存儲：Android 10+ 使用 MediaStore 插入媒體文件
6. 緩存文件用 getCacheDir()：系統自動清理、無需手動管理

MediaStore 插入媒體文件示例 (Android 10+)

ContentValues values = new ContentValues();
values.put(MediaStore.Images.Media.DISPLAY_NAME, "photo.jpg");
values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");
values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/MyApp");

Uri uri = contentResolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
try (OutputStream os = contentResolver.openOutputStream(uri)) {
    bitmap.compress(Bitmap.CompressFormat.JPEG, 90, os);
}