萬盛學電腦網

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

Android 監聽 SD 卡掛載狀態變化的標準實現

SD 卡 (外部存儲) 狀態變化監聽涉及用戶文件讀寫、相機存儲、離線緩存、數據導出等核心業務。Android 提供兩種機制:廣播接收器監聽系統廣播 (推薦) 和 StorageEventListener 回調 (系統級、需系統簽名)。本文詳解標準廣播方案、狀態常量含義、權限演進、生命週期管理與最佳實踐。

核心機制:系統廣播 + BroadcastReceiver

1. 關鍵廣播 Action

Intent.ACTION_MEDIA_MOUNTEDIntent.ACTION_MEDIA_UNMOUNTEDIntent.ACTION_MEDIA_CHECKINGIntent.ACTION_MEDIA_EJECTIntent.ACTION_MEDIA_REMOVEDIntent.ACTION_MEDIA_BAD_REMOVALIntent.ACTION_MEDIA_SHAREDIntent.ACTION_MEDIA_NOFSIntent.ACTION_MEDIA_UNMOUNTABLE
Action 常量觸發時機附加信息 (Intent Extras)
SD 卡掛載完成、可讀寫EXTRA_MEDIA_PATH (文件路徑)
SD 卡卸載、不可用EXTRA_MEDIA_PATH
正在掃描/檢查文件系統EXTRA_MEDIA_PATH
用戶請求彈出 (需用戶確認)EXTRA_MEDIA_PATH
物理移除 (無彈出流程)EXTRA_MEDIA_PATH
未安全卸載直接移除EXTRA_MEDIA_PATH
作為 USB 大容量存儲共享給電腦 (Android 6.0+ 少見)EXTRA_MEDIA_PATH
無文件系統/不支持的文件系統EXTRA_MEDIA_PATH
存在但無法掛載 (文件系統損壞)EXTRA_MEDIA_PATH

2. Environment 狀態常量 (getExternalStorageState() 返回值)

Environment.MEDIA_MOUNTED              // 可讀寫
Environment.MEDIA_MOUNTED_READ_ONLY    // 僅讀
Environment.MEDIA_UNMOUNTED            // 未掛載
Environment.MEDIA_CHECKING             // 檢查中
Environment.MEDIA_NOFS                 // 無文件系統
Environment.MEDIA_REMOVED              // 物理移除
Environment.MEDIA_UNMOUNTABLE          // 無法掛載
Environment.MEDIA_BAD_REMOVAL          // 非法移除
Environment.MEDIA_SHARED               // USB 共享中

標準實現:動態註冊 BroadcastReceiver (生命週期感知)

public class StorageStateMonitor {

    public interface OnStorageStateChangeListener {
        void onMounted(String path);           // 可讀寫
        void onUnmounted(String path);         // 不可用
        void onChecking(String path);          // 掃描中
        void onEjectRequested(String path);    // 彈出請求
        void onRemoved(String path);           // 物理移除
        void onBadRemoval(String path);        // 非法移除
        void onShared(String path);            // USB共享
        void onNoFs(String path);              // 無文件系統
        void onUnmountable(String path);       // 無法掛載
    }

    private final Context context;
    private final OnStorageStateChangeListener listener;
    private final BroadcastReceiver receiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            String action = intent.getAction();
            String path = intent.getData() != null ? intent.getData().getPath() : "";
            
            switch (action) {
                case Intent.ACTION_MEDIA_MOUNTED:
                    listener.onMounted(path); break;
                case Intent.ACTION_MEDIA_UNMOUNTED:
                    listener.onUnmounted(path); break;
                case Intent.ACTION_MEDIA_CHECKING:
                    listener.onChecking(path); break;
                case Intent.ACTION_MEDIA_EJECT:
                    listener.onEjectRequested(path); break;
                case Intent.ACTION_MEDIA_REMOVED:
                    listener.onRemoved(path); break;
                case Intent.ACTION_MEDIA_BAD_REMOVAL:
                    listener.onBadRemoval(path); break;
                case Intent.ACTION_MEDIA_SHARED:
                    listener.onShared(path); break;
                case Intent.ACTION_MEDIA_NOFS:
                    listener.onNoFs(path); break;
                case Intent.ACTION_MEDIA_UNMOUNTABLE:
                    listener.onUnmountable(path); break;
            }
        }
    };

    public StorageStateMonitor(Context context, OnStorageStateChangeListener listener) {
        this.context = context.getApplicationContext(); // 避免洩漏
        this.listener = listener;
    }

    /** 註冊監聽 (在 Activity/Fragment onStart/onResume 調用) */
    public void register() {
        IntentFilter filter = new IntentFilter();
        filter.addAction(Intent.ACTION_MEDIA_MOUNTED);
        filter.addAction(Intent.ACTION_MEDIA_UNMOUNTED);
        filter.addAction(Intent.ACTION_MEDIA_CHECKING);
        filter.addAction(Intent.ACTION_MEDIA_EJECT);
        filter.addAction(Intent.ACTION_MEDIA_REMOVED);
        filter.addAction(Intent.ACTION_MEDIA_BAD_REMOVAL);
        filter.addAction(Intent.ACTION_MEDIA_SHARED);
        filter.addAction(Intent.ACTION_MEDIA_NOFS);
        filter.addAction(Intent.ACTION_MEDIA_UNMOUNTABLE);
        filter.addDataScheme("file"); // 必須添加,否則無法接收
        context.registerReceiver(receiver, filter);
    }

    /** 註銷監聽 (在 onStop/onPause 調用) */
    public void unregister() {
        try {
            context.unregisterReceiver(receiver);
        } catch (IllegalArgumentException ignored) {}
    }

    /** 同步獲取當前狀態 (不依賴廣播) */
    public static String getCurrentState(Context context) {
        return Environment.getExternalStorageState(context.getExternalFilesDir(null));
    }

    /** 判斷是否可寫 */
    public static boolean isWritable(Context context) {
        return Environment.MEDIA_MOUNTED.equals(getCurrentState(context));
    }

    /** 判斷是否可讀 (含唯讀) */
    public static boolean isReadable(Context context) {
        String state = getCurrentState(context);
        return Environment.MEDIA_MOUNTED.equals(state) || Environment.MEDIA_MOUNTED_READ_ONLY.equals(state);
    }
}

Activity/Fragment 中正確使用姿勢

public class MainActivity extends AppCompatActivity {
    private StorageStateMonitor storageMonitor;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        storageMonitor = new StorageStateMonitor(this, new StorageStateMonitor.OnStorageStateChangeListener() {
            @Override public void onMounted(String path) {
                runOnUiThread(() -> {
                    Toast.makeText(MainActivity.this, "SD卡已掛載: " + path, Toast.LENGTH_SHORT).show();
                    // 恢復文件讀寫、恢復下載任務、刷新媒體庫
                });
            }
            @Override public void onUnmounted(String path) {
                runOnUiThread(() -> {
                    Toast.makeText(MainActivity.this, "SD卡已卸載", Toast.LENGTH_SHORT).show();
                    // 暫停寫入、關閉文件流、提示用戶
                });
            }
            // 其他回調按需實現...
        });
    }

    @Override
    protected void onStart() {
        super.onStart();
        storageMonitor.register();
    }

    @Override
    protected void onStop() {
        super.onStop();
        storageMonitor.unregister();
    }
}

權限演進與存儲訪問策略 (關鍵!)

Android 版本存儲訪問模型關鍵變化
API < 19 (KitKat)權限模型WRITE_EXTERNAL_STORAGE 即可任意讀寫
API 19-28權限 + 公開目錄應用專屬目錄 (getExternalFilesDir) 無需權限;公開目錄需權限
API 29 (Q)分區存儲默認沙箱,僅訪問自有文件;MediaStore 訪問媒體;SAF 訪問其他
API 30 (R)分區存儲強制MANAGE_EXTERNAL_STORAGE 權限極難獲取;MediaStore + SAF 為主流
API 33+ (Tiramisu)細粒度媒體權限READ_MEDIA_IMAGES/VIDEO/AUDIO 替代 READ_EXTERNAL_STORAGE

現代化存儲訪問最佳實踐

  1. 優先使用應用專屬目錄:context.getExternalFilesDir(null) (無需權限、卸載自動清理)
  2. 媒體文件用 MediaStore:MediaStore.Images.Media.insertImage()、ContentResolver.query()
  3. 用戶選擇文件用 SAF:ACTION_OPEN_DOCUMENT/ACTION_CREATE_DOCUMENT、DocumentsContract
  4. 避免直接操作文件路徑:Uri + ContentResolver 是長久之計

進階:StorageEventListener (系統應用專用)

注意:此類為 @SystemApi,普通應用無法直接使用,需系統簽名權限。原文代碼僅供理解內部機制。

// 僅系統應用可用
public class MyStorageListener extends StorageEventListener {
    @Override
    public void onStorageStateChanged(String path, String oldState, String newState) {
        // 實時接收所有存儲卷狀態變化 (含內部存儲、SD卡、USB OTG、采用式存儲)
    }
}

// 註冊 (需系統上下文)
StorageManager storageManager = (StorageManager) context.getSystemService(Context.STORAGE_SERVICE);
storageManager.registerListener(new MyStorageListener());

總結

  • 普通應用:動態註冊 BroadcastReceiver 監聽 ACTION_MEDIA_* 廣播,配合 Environment.getExternalStorageState() 同步查詢
  • 存儲訪問:遵循分區存儲規範,棄用直接文件路徑,擁抱 MediaStore + SAF
  • 生命週期:onStart/register、onStop/unregister,使用 ApplicationContext 避免洩漏
  • 業務邏輯:掛載→恢復任務/刷新媒體庫;卸載/移除→暫停寫入/關閉流/用戶提示

正確處理 SD 卡狀態變化,是應用穩定性、數據安全、用戶體驗的關鍵環節。隨著分區存儲全面強制,基於 Uri 的存儲訪問模式已成標準,建議盡早遷移。

copyright © 萬盛學電腦網 all rights reserved