Android存儲(chǔ)訪問(wèn)框架的使用小結(jié)
存儲(chǔ)訪問(wèn)框架,簡(jiǎn)稱(chēng):SAF, 就是系統(tǒng)文件選擇器+文件操作API。先選擇文件,在用文件操作API處理文件。系統(tǒng)文件選擇器,就和Windows的文件選擇框一樣。
其實(shí)絕大多數(shù)app,都不會(huì)使用這個(gè)東西,因?yàn)樘环奖懔?。圖片,視頻,普通文件,需要用戶(hù)去翻文件夾找,這樣的用戶(hù)體驗(yàn)實(shí)在太差了。所以大家都是用第三方的或者自己寫(xiě)一個(gè)文件選擇器。
之所以講SAF,一,是因?yàn)锳ndroid11以后,使用MediaStore無(wú)法訪問(wèn)到非多媒體文件了,需要依賴(lài)SAF了。二,外卡和SD卡的操作依賴(lài)于存儲(chǔ)訪問(wèn)框架授權(quán)。
打開(kāi)系統(tǒng)文件選擇器與文件過(guò)濾
Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); intent.addCategory(Intent.CATEGORY_OPENABLE); intent.setType("application/*"); startActivityForResult(intent, REQUEST_CODE)
setType的值是mime type, 可以是"image/*", "*/*", 其中*是通配符。"image/*"代碼所有類(lèi)型的圖片。"*/*"代表所有類(lèi)型的文件。
當(dāng)只需要打開(kāi)幾種文件類(lèi)型時(shí),可以用Intent.EXTRA_MIME_TYPES。同時(shí)setType設(shè)成“*/*”。
Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); intent.addCategory(Intent.CATEGORY_OPENABLE); intent.setType("*/*"); intent.putExtra(Intent.EXTRA_MIME_TYPES, new String[] { "application/pdf", // .pdf "application/vnd.oasis.opendocument.text", // .odt "text/plain" // .txt }); startActivityForResult(intent, REQUEST_CODE)
Intent.ACTION_PICK和ACTION_GET_CONTENT,也可以打開(kāi)文件選擇框。ACTION_GET_CONTENT更加寬泛,除了文件其他類(lèi)型的內(nèi)容還可以取。
Intent intent = new Intent(Intent.ACTION_PICK, android.provider.MediaStore.Images.Media.EXTERNAL_CONTENT_URI); intent.setType("image/*");
Intent intent = new Intent(Intent.ACTION_GET_CONTENT); intent.setType("image/*")
下面列舉了所有的mime type:
private static final String[][] MIME_TYPES = new String[][]{ {"3gp", "video/3gpp"}, {"apk", "application/vnd.android.package-archive"}, {"asf", "video/x-ms-asf"}, {"avi", "video/x-msvideo"}, {"bin", "application/octet-stream"}, {"bmp", "image/bmp"}, {"c", "text/plain"}, {"class", "application/octet-stream"}, {"conf", "text/plain"}, {"cpp", "text/plain"}, {"doc", "application/msword"}, {"docx", "application/vnd.openxmlformats-officedocument.wordprocessingml.document"}, {"xls", "application/vnd.ms-excel"}, {"xlsx", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"}, {"exe", "application/octet-stream"}, {"gif", "image/gif"}, {"gtar", "application/x-gtar"}, {"gz", "application/x-gzip"}, {"h", "text/plain"}, {"htm", "text/html"}, {"html", "text/html"}, {"jar", "application/java-archive"}, {"java", "text/plain"}, {"jpeg", "image/jpeg"}, {"jpg", "image/jpeg"}, {"js", "application/x-JavaScript"}, {"log", "text/plain"}, {"m3u", "audio/x-mpegurl"}, {"m4a", "audio/mp4a-latm"}, {"m4b", "audio/mp4a-latm"}, {"m4p", "audio/mp4a-latm"}, {"ape", "audio/ape"}, {"flac", "audio/flac"}, {"m4u", "video/vnd.mpegurl"}, {"m4v", "video/x-m4v"}, {"mov", "video/quicktime"}, {"mp2", "audio/x-mpeg"}, {"mp3", "audio/x-mpeg"}, {"mp4", "video/mp4"}, {"mkv", "video/x-matroska"}, {"flv", "video/x-flv"}, {"divx", "video/x-divx"}, {"mpa", "video/mpeg"}, {"mpc", "application/vnd.mpohun.certificate"}, {"mpe", "video/mpeg"}, {"mpeg", "video/mpeg"}, {"mpg", "video/mpeg"}, {"mpg4", "video/mp4"}, {"mpga", "audio/mpeg"}, {"msg", "application/vnd.ms-outlook"}, {"ogg", "audio/ogg"}, {"pdf", "application/pdf"}, {"png", "image/png"}, {"pps", "application/vnd.ms-powerpoint"}, {"ppt", "application/vnd.ms-powerpoint"}, {"pptx", "application/vnd.openxmlformats-officedocument.presentationml.presentation"}, {"prop", "text/plain"}, {"rc", "text/plain"}, {"rmvb", "audio/x-pn-realaudio"}, {"rtf", "application/rtf"}, {"sh", "text/plain"}, {"tar", "application/x-tar"}, {"tgz", "application/x-compressed"}, {"txt", "text/plain"}, {"wav", "audio/x-wav"}, {"wma", "audio/x-ms-wma"}, {"wmv", "audio/x-ms-wmv"}, {"wps", "application/vnd.ms-works"}, {"xml", "text/plain"}, {"z", "application/x-compress"}, {"zip", "application/x-zip-compressed"}, {"rar", "application/x-rar"}, {"", "*/*"} };
打開(kāi)指定文件夾
利用DocumentsContract.EXTRA_INITIAL_URI,在打開(kāi)文件選擇器的時(shí)候,跳轉(zhuǎn)到指定文件夾。只有android 8以上才行。
Uri uri = Uri.parse("content://com.android.externalstorage.documents/document/primary:Download"); Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); intent.addCategory(Intent.CATEGORY_OPENABLE); intent.setType("*/*"); intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, uri); startActivityForResult(intent, 1);
文件夾權(quán)限申請(qǐng)
當(dāng)需要讀取非公共文件夾里面的文件時(shí),可以申請(qǐng)授權(quán),授權(quán)后保存Uri,之后可以拼接這個(gè)Uri操作文件夾里的所有文件。
尤其是SD卡,從Android 5 開(kāi)始文件的修改刪除必須先授權(quán),且必須通過(guò)SVF框架接口才能操作。
可以使用EXTRA_INITIAL_URI,打開(kāi)指定文件夾,讓用戶(hù)授權(quán)
Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE); Uri uri = Uri.parse("content://com.android.externalstorage.documents/document/primary:Download"); intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, uri); startActivityForResult(intent)
需要注意的是,Android 11以后,無(wú)法授權(quán)訪問(wèn)存儲(chǔ)根目錄,以及Download/,Android/, 這兩個(gè)文件夾也無(wú)法授權(quán)。
創(chuàng)建文件夾
創(chuàng)建文件夾有兩個(gè)情況,一個(gè)是在已授權(quán)的文件夾下,可以使用SVF框架API。
DocumentsContract.createDocument()
還有一種是在無(wú)授權(quán)的文件夾下創(chuàng)建,那么可以直接指定類(lèi)型和名字,通過(guò)跳系統(tǒng)選擇框創(chuàng)建。
Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT); intent.addCategory(Intent.CATEGORY_OPENABLE); intent.setType("application/txt"); intent.putExtra(Intent.EXTRA_TITLE, "testfile.txt"); startActivityForResult(intent)
存儲(chǔ)訪問(wèn)框架API
存儲(chǔ)訪問(wèn)框架API,都在DocumentsContract里面,典型的有:
public static @Nullable Uri renameDocument(@NonNull ContentResolver content, @NonNull Uri documentUri, @NonNull String displayName) throws FileNotFoundException { } /** * Delete the given document. * * @param documentUri document with {@link Document#FLAG_SUPPORTS_DELETE} * @return if the document was deleted successfully. */ public static boolean deleteDocument(@NonNull ContentResolver content, @NonNull Uri documentUri) throws FileNotFoundException { } /** * Copies the given document. * * @param sourceDocumentUri document with {@link Document#FLAG_SUPPORTS_COPY} * @param targetParentDocumentUri document which will become a parent of the source * document's copy. * @return the copied document, or {@code null} if failed. */ public static @Nullable Uri copyDocument(@NonNull ContentResolver content, @NonNull Uri sourceDocumentUri, @NonNull Uri targetParentDocumentUri) throws FileNotFoundException { } /** * Moves the given document under a new parent. * * @param sourceDocumentUri document with {@link Document#FLAG_SUPPORTS_MOVE} * @param sourceParentDocumentUri parent document of the document to move. * @param targetParentDocumentUri document which will become a new parent of the source * document. * @return the moved document, or {@code null} if failed. */ public static @Nullable Uri moveDocument(@NonNull ContentResolver content, @NonNull Uri sourceDocumentUri, @NonNull Uri sourceParentDocumentUri, @NonNull Uri targetParentDocumentUri) throws FileNotFoundException { } /** * Removes the given document from a parent directory. * * <p>In contrast to {@link #deleteDocument} it requires specifying the parent. * This method is especially useful if the document can be in multiple parents. * * @param documentUri document with {@link Document#FLAG_SUPPORTS_REMOVE} * @param parentDocumentUri parent document of the document to remove. * @return true if the document was removed successfully. */ public static boolean removeDocument(@NonNull ContentResolver content, @NonNull Uri documentUri, @NonNull Uri parentDocumentUri) throws FileNotFoundException { }
獲取文件夾文件
使用DocumentFile類(lèi)獲取文件夾里文件列表。
private ActivityResultLauncher<Object> openFile() { Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE); Uri uri = Uri.parse("content://com.android.externalstorage.documents/document/primary:AuthSDK"); intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, uri); return startActivityForResult(intent, new ActivityResultCallback<Intent>() { @Override public void onActivityResult(Intent result) { for (DocumentFile documentFile : DocumentFile.fromTreeUri(BaseApplication.getInstance().getApplicationContext(), Uri.parse(result.getData().toString())).listFiles()) { Log.i("", documentFile.getUri()); } } }); }
下面的代碼演示了,使用SVF讀取文件內(nèi)容,寫(xiě)內(nèi)容,通過(guò)MediaStore查詢(xún)文件屬性。
private ActivityResultLauncher<Object> openFile() { Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE); Uri uri = Uri.parse("content://com.android.externalstorage.documents/document/primary:AuthSDK"); intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, uri); return startActivityForResult(intent, new ActivityResultCallback<Intent>() { @Override public void onActivityResult(Intent result) { for (DocumentFile documentFile : DocumentFile.fromTreeUri(BaseApplication.getInstance().getApplicationContext(), Uri.parse(result.getData().toString())).listFiles()) { try { InputStream inputStream = BaseApplication.getInstance().getContentResolver().openInputStream(documentFile.getUri()); byte[] readData = new byte[1024]; inputStream.read(readData); OutputStream outputStream = BaseApplication.getInstance().getContentResolver().openOutputStream(documentFile.getUri()); byte[] writeData = "alan gong".getBytes(StandardCharsets.UTF_8); outputStream.write(writeData, 0, 9); outputStream.close(); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) { Uri mediaUri = MediaStore.getMediaUri(BaseApplication.getInstance().getApplicationContext(), documentFile.getUri()); long fileId = ContentUris.parseId(mediaUri); Cursor query = BaseApplication.getInstance().getContentResolver().query(documentFile.getUri(), null, MediaStore.MediaColumns._ID + "=" + fileId, null, null); int columnIndex = query.getColumnIndexOrThrow(MediaStore.MediaColumns.MIME_TYPE); String mimeType = query.getString(columnIndex); Log.i("", ""); } } catch (FileNotFoundException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } } } }); }
使用MediaStore.getMediaUri(documentUri)可以轉(zhuǎn)換,MediaStore Uri 和 Document Uri。通過(guò)MediaStore Uri中的數(shù)據(jù)庫(kù)id,就可以查詢(xún)文件的所有屬性了。
MediaStore Uri:content://media/external_primary/file/101750
Document Uri: content://com.android.externalstorage.documents/tree/primary%3AAuthSDK
另外,
非公共目錄下不能用File API操作的,即使通過(guò)SVF授權(quán)了, READ_EXTRNAL_PERMISSION的權(quán)限也給了。還是會(huì)拋出FileNotFoundException, 并且顯示permission deny。
和MediaStore API的不同
存儲(chǔ)訪問(wèn)框架API和MediaStore API的差異,在于存儲(chǔ)訪問(wèn)框架API,是基于系統(tǒng)文件選擇框的,用戶(hù)選擇了文件,那么相當(dāng)于授權(quán)了, 可以訪問(wèn)所有類(lèi)型的文件。而MediaStore的特點(diǎn)是可以查詢(xún)出所有文件,但是開(kāi)啟分區(qū)存儲(chǔ)后,只能查處多媒體文件,其他類(lèi)型文件是不可以的。
到此這篇關(guān)于Android存儲(chǔ)訪問(wèn)框架的使用的文章就介紹到這了,更多相關(guān)Android存儲(chǔ)訪問(wèn)框架內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android 圖片保存到相冊(cè)不顯示的解決方案(兼容Android 10及更高版本)
這篇文章主要介紹了Android 圖片保存到系統(tǒng)相冊(cè)不顯示的解決方案,幫助大家更好的理解和學(xué)習(xí)使用Android開(kāi)發(fā),感興趣的朋友可以了解下2021-04-04android tv列表焦點(diǎn)記憶實(shí)現(xiàn)的方法
本篇文章主要介紹了android tv列表焦點(diǎn)記憶實(shí)現(xiàn)的方法,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-04-04Android?Settings?跳轉(zhuǎn)流程方法詳解
這篇文章主要為大家介紹了Android?Settings跳轉(zhuǎn)流程方法示例,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-07-07Android Studio3.6.3 當(dāng)前最新版本數(shù)據(jù)庫(kù)查找與導(dǎo)出方法(圖文詳解)
這篇文章主要介紹了Android Studio3.6.3 當(dāng)前最新版本數(shù)據(jù)庫(kù)查找與導(dǎo)出方法,本文通過(guò)圖文并茂的形式給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-04-04Android 手機(jī)獲取手機(jī)號(hào)實(shí)現(xiàn)方法
本文主要介紹Android 獲取手機(jī)號(hào)的實(shí)現(xiàn)方法,這里提供了實(shí)現(xiàn)方法,和具體操作流程,并符實(shí)現(xiàn)代碼,有需要的小伙伴可以參考下2016-09-09Ubuntu中為Android HAL編寫(xiě)JNI方法提供JAVA訪問(wèn)硬件服務(wù)接口
本文主要介紹Ubuntu中為Android硬件抽象層模塊編寫(xiě)JNI方法提供Java訪問(wèn)硬件服務(wù)接口,這里給大家詳細(xì)說(shuō)明如何編寫(xiě) JNI方法訪問(wèn)硬件接口并附示例代碼,有需要的小伙伴參考下2016-08-08Kotlin作用域函數(shù)應(yīng)用詳細(xì)介紹
作用域函數(shù):是Kotlin標(biāo)準(zhǔn)庫(kù)中的內(nèi)聯(lián)函數(shù),作用在對(duì)象上時(shí),執(zhí)行給定的block代碼塊??梢栽赽lock代碼塊中通過(guò)it,this代表當(dāng)前對(duì)象,進(jìn)行代碼邏輯處理2022-08-08Android開(kāi)發(fā)微信小程序路由跳轉(zhuǎn)方式
這篇文章主要為大家介紹了Android開(kāi)發(fā)微信小程序路由跳轉(zhuǎn)方式,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步早日升職加薪2022-04-04