詳解Android10的分區存儲機制(Scoped Storage)適配教程

1. 簡介
 

大家應該都有過這樣的體會，手機用著用著裡面就充斥著各種不懂的文件夾和文件。甚至是連已經刪除的軟件的文件夾還存在。
 

為什麼會發生的這樣的問題呢？
 

因為Google的缺席，導致Android生態野蠻生長，導致很多開發規範沒有完全被落實。
 為了解決這樣的問題，Google決定重拳出擊，提出了分區存儲(Scoped Storage)機制，也叫沙盒存儲機制。
 那麼什麼是沙盒存儲機制呢。
 沙盒機制是一種安全機制，用於防止應用讀取其他應用的數據。

1. 每個應用程序都有自己的存儲空間。

2. 應用程序不能翻過自己的目錄，去訪問公共目錄。

3. 應用程序請求的數據都要通過權限檢測，不符合要求不會被放行。

2. 關於Android10的分區機制

以 Android 10（API 級別 29）及更高版本為目標平臺的應用在默認情況下被賦予了對外部存儲設備的分區訪問權限（即分區存儲）, 對外部存儲文件訪問方式重新設計，便於用戶更好的管理外部存儲文件。如果不符合條件的會以兼容模式運行，兼容模式跟以前一樣，根據路徑可以直接存儲文件。
 

應用只能看到本應用專有的目錄（通過 Context.getExternalFilesDir() 訪問）以及特定類型的媒體。除非您的應用需要訪問存放在應用的專有目錄以及 MediaStore 之外的文件，否則最好使用分區存儲。
 在發佈Android10的時候官方明確表態：
 

2020年，主要平臺版本將要求所有應用都使用分區存儲，無論應用的目標 SDK 級別是多少。因此，您應該提前確保您的應用能夠使用分區存儲。為此，請確保針對搭載 Android 10（API 級別 29）及更高版本的設備啟用了該行為。
 翻譯成通俗語言，不管是使用requestLegacyExternalStorage=true的方式以兼容模式運行還是降低targetSDK都無法在接下來2020年的Android(API 29)10更新中被豁免。
 

所以為了應用的穩定性，應該盡在進行適配。
 

3. 具體分區存儲權限的介紹
 

默認情況下，對於targetSdkVersion大於等於29的應用，其訪問權限範圍限定為分區存儲。此應用無需請求與存儲相關的用戶權限，即可以查看外部存儲中以下類型的文件：

1. 應用外部特定目錄中的文件（使用getExternalFilesDir()訪問）。

2. 應用自己創建的照片、視頻和音頻（通過MediaStore訪問）。

分區存儲將影響在Android10系統首次安裝啟動、且targetSdkVersion >=29的應用。需要訪問和共享外部存儲文件的應用會受到影響，需要進行兼容性適配。
 

影響範圍：
 在Android 10上運行的應用：
 1.targetSdkVersion <= 28，不受影響
 2.如果targetSdkVersion >= 29，默認情況應用外部存儲可見性將被過濾，應用需要對分區存儲進行適配。
 

還有值得注意的是以下兩種情況比較特殊，不會受到分區存儲的影響：
 

如果應用最先安裝在Android 10以下的系統，
 1） 然後系統通過Fota升級到Android 10
 2） 應用通過更新升級到targetSdkVersion >= 29
 

下面是關於分區存儲權限和其他相關項目的表格。

4. 專有目錄存儲
 

應用讀取或寫入應有專有的目錄中的文件時，不需要獲取存儲權限。
 在應用中想要獲取當前應用的專有存儲目錄路徑是可以用Context.getExternalFilesDir()的方式獲取。
 

  val dirpath = context.getExternalFilesDir("")  val fileString = dirpath + File.separator  val file = File(fileString)  ...  // 剩下的步驟是用Java IO或者其他IO庫來寫入數據

5. 共享媒體集合存儲
 

在共享媒體集合存儲中保存媒體文件時，需要根據文件的類型選擇MediaStore。
 

把相關數據放入到ContentValues中，最後把ContentValues插入到ContentResolver中，並獲得返回的Uri。
 

通過Uri過得OutputStream，然後用Okio的IO庫，進行文件的存儲。
 

關於Okio的只是以後有機會的話，我們再好好講一講。
 

不要忘了這裡需要獲取權限。
 

  // 把圖片下載到共有媒體集合中，並在相冊中顯示  // 創建ContentValues, 並加入信息  val values = ContentValues()  values.put(MediaStore.Images.Media.DESCRIPTION, downloadedFile.name)  values.put(MediaStore.Images.Media.DISPLAY_NAME, downloadedFile.name)  values.put(MediaStore.Images.Media.MIME_TYPE, mimeType)  values.put(MediaStore.Images.Media.TITLE, downloadedFile.name)  values.put(    MediaStore.Images.Media.RELATIVE_PATH,    "${Environment.DIRECTORY_PICTURES}/${downloadedFile.name}"  )  // 插入到ContentResolver，並返回Uri  val insertUri = context.contentResolver.insert(    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,    values  )    if (insertUri != null) {    // 獲取OutputStream    val outputStream = context.contentResolver.openOutputStream(insertUri)  if (outputStream != null) {    sink = outputStream.sink().buffer()  } else {    return@runCatching FileDownloadResult.OthersError    }  } else {    return@runCatching FileDownloadResult.OthersError  }     val responseBody = response.body ?: return@runCatching FileDownloadResult.OthersError    try {    val contentLength = responseBody.contentLength()    if (contentLength > FileUtil.getAvailableSize(dirPath)) {      continuation.resume(FileDownloadResult.StorageError)    }    var totalRead: Long = 0    var lastRead: Long      do {      lastRead = responseBody.source().read(sink.buffer(), BUFFER_SIZE)      if (lastRead == -1L) {        break      }      totalRead += lastRead      sink.emitCompleteSegments()    } while (true)    sink.writeAll(responseBody.source())    sink.close()    responseBody.close()  }

6. 其他
 

Github: https://github.com/HyejeanMOON/ScopedStorageDemo