RxHttp 完美適配Android 10/11 上傳/下載/進(jìn)度監(jiān)聽

1颂跨、前言

隨著Android 11的正式發(fā)布,適配Android 10/11 分區(qū)存儲就更加的迫切了扯饶,因為Android 11開始恒削,將強(qiáng)制開啟分區(qū)存儲,我們就無法再以絕對路徑的方式去讀寫非沙盒目錄下的文件尾序,為此钓丰,RxHttp 2.4.0版本中就正式適配了分區(qū)存儲,并且每币,可以非常優(yōu)雅的實現(xiàn)文件上傳/下載/進(jìn)度監(jiān)聽携丁,三步即可搞懂任意請求。

老規(guī)矩脯爪,先看看請求三部曲


image

如果你想了解RxHttp更過功能湾盗,請查看以下系列文章

RxHttp 2000+star恨旱,協(xié)程請求,僅需三步

RxHttp 讓你眼前一亮的Http請求框架

gradle依賴

必須

//使用kapt依賴rxhttp-compiler時必須
apply plugin: 'kotlin-kapt'

android {
    //必須抑堡,java 8或更高
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    implementation 'com.ljx.rxhttp:rxhttp:2.4.4'
    implementation 'com.squareup.okhttp3:okhttp:4.9.0' //rxhttp v2.2.2版本起涌矢,需要手動依賴okhttp
    kapt 'com.ljx.rxhttp:rxhttp-compiler:2.4.4' //生成RxHttp類掖举,純Java項目,請使用annotationProcessor代替kapt
 }

可選

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [
                    //使用asXxx方法時必須娜庇,告知RxHttp你依賴的rxjava版本塔次,可傳入rxjava2、rxjava3
                    rxhttp_rxjava: 'rxjava3'名秀, 
                    rxhttp_package: 'rxhttp'   //非必須励负,指定RxHttp類包名
                ]
            }
        }
    }
}
dependencies {
    implementation 'com.ljx.rxlife:rxlife-coroutine:2.0.1' //管理協(xié)程生命周期,頁面銷毀匕得,關(guān)閉請求
    
    //rxjava2   (RxJava2/Rxjava3二選一继榆,使用asXxx方法時必須)
    implementation 'io.reactivex.rxjava2:rxjava:2.2.8'
    implementation 'io.reactivex.rxjava2:rxandroid:2.1.1'
    implementation 'com.ljx.rxlife2:rxlife-rxjava:2.0.0' //管理RxJava2生命周期巾表,頁面銷毀,關(guān)閉請求

    //rxjava3
    implementation 'io.reactivex.rxjava3:rxjava:3.0.6'
    implementation 'io.reactivex.rxjava3:rxandroid:3.0.0'
    implementation 'com.ljx.rxlife3:rxlife-rxjava:3.0.0' //管理RxJava3生命周期略吨,頁面銷毀集币,關(guān)閉請求

    //非必須,根據(jù)自己需求選擇 RxHttp默認(rèn)內(nèi)置了GsonConverter
    implementation 'com.ljx.rxhttp:converter-fastjson:2.4.4'
    implementation 'com.ljx.rxhttp:converter-jackson:2.4.4'
    implementation 'com.ljx.rxhttp:converter-moshi:2.4.4'
    implementation 'com.ljx.rxhttp:converter-protobuf:2.4.4'
    implementation 'com.ljx.rxhttp:converter-simplexml:2.4.4'
}

2翠忠、Android 10/11 分區(qū)存儲

當(dāng)我們App的targetSdkVersion更改為28以上鞠苟,并且運(yùn)行在Android 10以上設(shè)備時,我們無法再以絕對路徑的方式秽之,去讀寫非沙盒目錄下的文件当娱,當(dāng)然,如果App是覆蓋安裝(如:targetSdkVersion 28 覆蓋安裝為 29)考榨,則會保持原來的訪問方式跨细。

requestLegacyExternalStorage屬性

如果我們的app將targetSdkVersion更改為28以上,且想保持原來的訪問方式董虱,則需要在清單文件中將 requestLegacyExternalStorage 的值設(shè)置為 true扼鞋,如下:

<manifest ...>
<!-- This attribute is "false" by default on apps targeting
     Android 10 or higher. -->
   <application android:requestLegacyExternalStorage="true" ... >
   ...
   </application>
</manifest>

此時,便可繼續(xù)以原來的方式去讀寫文件愤诱,然而云头,在Android 11上,Google又給了它新的含義淫半,來看看官網(wǎng)的原話

image

也就是說溃槐,在Android 11設(shè)備上,targetSdkVersion為29以上的app科吭,將強(qiáng)制開啟分區(qū)存儲昏滴,requestLegacyExternalStorage屬性失效

注意,只要同時滿足以上兩個條件对人,不管是覆蓋安裝還是requestLegacyExternalStorage = true谣殊,都會強(qiáng)制開啟分區(qū)存儲

分區(qū)存儲優(yōu)勢

  • 對用戶來說,解決了文件亂放的現(xiàn)象

  • 對于開發(fā)者來說牺弄,我們無需寫權(quán)限姻几,就可以在分區(qū)目錄下創(chuàng)建文件,并且訪問自己創(chuàng)建的文件势告,不需要讀權(quán)限(訪問其它應(yīng)用創(chuàng)建的文件蛇捌,還是需要讀權(quán)限)

新的文件訪問方式

image

此圖來源于作者[連續(xù)三屆村草]分享的Android 10(Q)/11(R) 分區(qū)存儲適配一文,感謝作者的總結(jié)

3咱台、上傳

3.1络拌、簡單上傳

在介紹Android 10文件上傳前,我們先來看看Android 10之前是如何上傳文件的回溺,如下:

//kotlin 協(xié)程
val result = RxHttp.postForm("/service/...")             
    .add("key", "value")
    .addFile("file", new File("xxx/1.jpg"))                                   
    .awaitString()   //awaitXxx系列方法是掛斷方法  
    
//RxJava
RxHttp.postForm("/service/...")      
    .add("key", "value")
    .addFile("file", new File("xxx/1.jpg")) 
    .asString()                             
    .subscribe({                       
        //成功回調(diào)                              
    }, {                       
        //異炒好常回調(diào)                              
    })                             

以上混萝,我們僅需調(diào)用 addFile方法添加文件對象即可,RxHttp提供了一系列addFile方法祥诽,列出幾個常用的譬圣,如下:

//添加單個文件
addFile(String, File) 
//添加多個文件,每個文件對應(yīng)相同的key
addFile(String, List<? extends File> fileList) 
//添加多個文件雄坪,每個文件對應(yīng)不同的key
addFile(Map<String, ? extends File> fileMap) 
//等等其它addFile方法

在Android 10厘熟,我們需要通過Uri對象去上傳文件,在RxHttp中维哈,通過addPart方法添加Uri對象绳姨,如下:


val context = getContext();  //獲取上下文對象   
//獲取Uri對象,這里為了方便阔挠,隨便寫了一個Downlaod目錄下的Uri地址
val uri = Uri.parse("content://media/external/downloads/13417")

//kotlin 協(xié)程
val result = RxHttp.postForm("/service/...")             
    .add("key", "value")
    .addPart(context, "file", uri)                                   
    .awaitString()   //awaitXxx系列方法是掛斷方法    
    
//RxJava
RxHttp.postForm("/service/...")        
    .add("key", "value")
    .addPart(context, "file", uri)                              
    .asString()                                                 
    .subscribe({                                           
        //成功回調(diào)                                                  
    }, {                                           
        //異称回調(diào)                                                  
    })

同樣的,RxHttp內(nèi)部提供了一系列addPart方法供大家選擇购撼,列出幾個常用的跪削,如下:

//添加單個Uri對象
addPart(Context, String, Uri) 
//添加多個Uri對象,每個Uri對應(yīng)相同的key
addParts(Context迂求,String, List<? extends Uri> uris) 
//添加多個Uri對象碾盐,每個Uri對應(yīng)不同的key
addParts(Context context, Map<String, ? extends Uri> uriMap) 
//等等其它addPart方法

3.2、帶進(jìn)度上傳

老規(guī)矩揩局,看看Android 10之前是如何監(jiān)聽上傳進(jìn)度的毫玖,如下:

//kotlin 協(xié)程
val result = RxHttp.postForm("/service/...")             
    .add("key", "value")
    .addFile("file", new File("xxx/1.jpg")) 
    .upload(this) {//this為當(dāng)前協(xié)程CoroutineScope對象,用于控制回調(diào)線程      
        //上傳進(jìn)度回調(diào),0-100凌盯,僅在進(jìn)度有更新時才會回調(diào)       
        val currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        val currentSize = it.getCurrentSize()  //當(dāng)前已上傳的字節(jié)大小   
        val totalSize = it.getTotalSize()      //要上傳的總字節(jié)大小    
    }
    .awaitString()   //awaitXxx系列方法是掛斷方法  
    
//RxJava
RxHttp.postForm("/service/...")      
    .add("key", "value")
    .addFile("file", new File("xxx/1.jpg"))
    .upload(AndroidSchedulers.mainThread()) {            
        //上傳進(jìn)度回調(diào),0-100付枫,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小    
    }                                                               
    .asString()                             
    .subscribe({                       
        //成功回調(diào)                              
    }, {                       
        //異常回調(diào)                              
    })                   

相比于單純的上傳文件驰怎,我們僅需額外調(diào)用upload操作符阐滩,傳入線程調(diào)度器及進(jìn)度回調(diào)即可。

同樣的县忌,對于Andorid 10叶眉,我們僅需要將File對象換成Uri對象即可,如下:

val context = getContext();  //獲取上下文對象   
//獲取Uri對象芹枷,這里為了方便,隨便寫了一個Downlaod目錄下的Uri地址
val uri = Uri.parse("content://media/external/downloads/13417")

//kotlin 協(xié)程
val result = RxHttp.postForm("/service/...")             
    .add("key", "value")
    .addPart(context, "file", uri)     
    .upload(this) {//this為當(dāng)前協(xié)程CoroutineScope對象莲趣,用于控制回調(diào)線程      
        //上傳進(jìn)度回調(diào),0-100鸳慈,僅在進(jìn)度有更新時才會回調(diào)       
        val currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        val currentSize = it.getCurrentSize()  //當(dāng)前已上傳的字節(jié)大小   
        val totalSize = it.getTotalSize()      //要上傳的總字節(jié)大小    
    }
    .awaitString()   //awaitXxx系列方法是掛斷方法     
    
//RxJava
RxHttp.postForm("/service/...")      
    .add("key", "value")
    .addPart(context, "file", uri)     
    .upload(AndroidSchedulers.mainThread()) {            
        //上傳進(jìn)度回調(diào),0-100,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小    
    }                                                          
    .asString()                             
    .subscribe({                       
        //成功回調(diào)                              
    }, {                       
        //異承。回調(diào)                              
    })                

怎么樣走芋?是不是so easy!!

4绩郎、下載

下載較于上傳,要豐富很多翁逞,RxHttp內(nèi)部提供類一系列下載方法來滿足不同的需求肋杖,如下:

//kotlin
fun IRxHttp.toDownload(
    destPath: String,
    context: CoroutineContext? = null,
    progress: (suspend (ProgressT<String>) -> Unit)? = null
)
fun IRxHttp.toDownload(
    context: Context,
    uri: Uri,
    coroutineContext: CoroutineContext? = null,
    progress: (suspend (ProgressT<Uri>) -> Unit)? = null
)
fun <T> IRxHttp.toDownload(
    osFactory: OutputStreamFactory<T>,
    context: CoroutineContext? = null,
    progress: (suspend (ProgressT<T>) -> Unit)? = null
)

4.1、簡單下載

在Android 10之前挖函,我們僅需傳入一個本地文件路徑即可状植,如下:

val localPath = "/sdcard/.../xxx.apk"
//kotlin 協(xié)程
val result = RxHttp.get("/service/.../xxx.apk")       
    .toDownload(localPath)
    .await()  //這里返回sd卡存儲路徑
    
//RxJava
RxHttp.get("/service/.../xxx.apk")       
    .asDownload(localPath)
    .subscribe({                
        //成功回調(diào),這里返回sd卡存儲路徑                      
    }, {                
        //異吃勾回調(diào)                   
    })

而到了Android 10津畸,我們需要自定義一個Android10DownloadFactory類,繼承UriFactory類必怜,如下:

class Android10DownloadFactory @JvmOverloads constructor(
    context: Context,
    fileName: String,
    queryUri: Uri? = null
) : UriFactory(context, queryUri, fileName) {

    override fun getUri(response: Response): Uri {
        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            ContentValues().run {
                put(MediaStore.MediaColumns.DISPLAY_NAME, fileName) //文件名
                //取contentType響應(yīng)頭作為文件類型
                put(MediaStore.MediaColumns.MIME_TYPE, response.body?.contentType().toString())
                //下載到Download目錄
                put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS)
                val uri = queryUri ?: MediaStore.Downloads.EXTERNAL_CONTENT_URI
                context.contentResolver.insert(uri, this)
            } ?: throw NullPointerException("Uri insert fail, Please change the file name")
        } else {
            Uri.fromFile(File(context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), displayName))
        }
    }
}

這里簡單介紹下上面的代碼肉拓,本文后續(xù)會詳細(xì)介紹為啥定義這樣一個類,以及如何構(gòu)建一個Uri對象梳庆。

  • 首先就是繼承UriFactory抽象類暖途,實現(xiàn)getUri(Response)方法
  • 接著就在實現(xiàn)方法里判斷SDK版本,Android 10以上膏执,就通過contentResolver構(gòu)建Uri對象驻售,否則就根據(jù)File對象構(gòu)建Uri對象,這樣就可以兼容到所有系統(tǒng)版本
  • 最后返回Uri對象即可

注:以上代碼胧后,基本可以滿足大部分人的需求芋浮,如你有特殊需求,構(gòu)建Uri的過程的作出簡單的修改即可

有了Android10DownloadFactory類壳快,執(zhí)行Android 10下載就會及其方便纸巷,如下:

val factory = Android10DownloadFactory(context, "test.apk")

//kotlin 協(xié)程
val uri = RxHttp.get("/service/.../xxx.apk")       
    .toDownload(factory)
    .await()  //這里返回工廠類構(gòu)建的Uri對象
    
//RxJava
RxHttp.get("/service/.../xxx.apk")       
    .asDownload(factory)
    .subscribe({                
        //成功回調(diào),這里返回工廠類構(gòu)建的Uri對象    
    }, {                
        //異常失敗                       
    })

以上asDownload眶痰、toDownload方法都接收一個UriFactory類型參數(shù)瘤旨,故我們可以直接傳入Android10DownloadFactory對象。

4.2竖伯、帶進(jìn)度下載

對于帶進(jìn)度下載存哲,我們只需要調(diào)用asDownloadtoDownload方法時七婴,傳入線程調(diào)度器及進(jìn)度回調(diào)即可祟偷,如下:

Android 10之前

val localPath = "/sdcard/.../xxx.apk"

//kotlin 協(xié)程
val result = RxHttp.get("/service/.../xxx.apk")       
    .toDownload(localPath, Dispatchers.Main) {
        //下載進(jìn)度回調(diào),0-100,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小
    }
    .await()  //這里返回sd卡存儲路徑
    
//RxJava
RxHttp.get("/service/.../xxx.apk")       
    .asDownload(localPath, AndroidSchedulers.mainThread()) {
        //下載進(jìn)度回調(diào),0-100打厘,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小 
    }
    .subscribe({                
        //成功回調(diào)修肠,這里返回sd卡存儲路徑                      
    }, {                
        //異常失敗                       
    }) 

Android 10以上,傳入我們定義的Android10DownloadFactory對象的同時户盯,再傳入傳入線程調(diào)度器及進(jìn)度監(jiān)聽即可嵌施,如下:

val factory = Android10DownloadFactory(context, "test.apk")

//kotlin 協(xié)程
val uri = RxHttp.get("/service/.../xxx.apk")       
    .toDownload(factory, Dispatchers.Main) {
        //下載進(jìn)度回調(diào),0-100饲化,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小
    }
    .await()  //這里返回工廠類構(gòu)建的Uri對象
    
//RxJava
RxHttp.get("/service/.../xxx.apk")       
    .asDownload(factory, AndroidSchedulers.mainThread()) {
        //下載進(jìn)度回調(diào),0-100,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小 
    }
    .subscribe({                
        //成功回調(diào)吗伤,這里返回工廠類構(gòu)建的Uri對象                      
    }, {                
        //異常失敗                       
    }) 

4.3吃靠、帶進(jìn)度斷點下載

對于斷點下載,我們需要調(diào)用一系列asAppendDownload足淆、toAppendDownload方法巢块,可以把它們理解為追加下載,實現(xiàn)如下:

Android 10之前

val localPath = "/sdcard/.../xxx.apk"

//kotlin 協(xié)程
val result = RxHttp.get("/service/.../xxx.apk")       
    .toAppendDownload(localPath, Dispatchers.Main) {
        //下載進(jìn)度回調(diào),0-100缸浦,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小
    }
    .await()  //這里返回sd卡存儲路徑
    
//RxJava
RxHttp.get("/service/.../xxx.apk")       
    .asAppendDownload(localPath, AndroidSchedulers.mainThread()) {
        //下載進(jìn)度回調(diào),0-100夕冲,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小 
    }
    .subscribe({                
        //成功回調(diào),這里返回sd卡存儲路徑                      
    }, {                
        //異常失敗                       
    }) 

在Android 10上裂逐,有一點需要注意的是歹鱼,我們在構(gòu)建Android10DownloadFactory對象時,需要傳入第三個參數(shù)queryUri卜高,可以把它理解為要查詢的文件夾弥姻,斷點下載,RxHttp內(nèi)部會根據(jù)文件名在指定的文件夾下查找對應(yīng)的文件掺涛,得到當(dāng)前文件的長度庭敦,也就是斷點位置,從而告訴服務(wù)端從哪里開始下載薪缆,如下:

val queryUri = MediaStore.Downloads.EXTERNAL_CONTENT_URI
//在Download目錄下查找test.apk文件
val factory = Android10DownloadFactory(context, "test.apk", queryUri)

//kotlin 協(xié)程
val uri = RxHttp.get("/service/.../xxx.apk")       
    .toAppendDownload(factory, Dispatchers.Main) {
        //下載進(jìn)度回調(diào),0-100秧廉,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小
    }
    .await()  //這里返回工廠類構(gòu)建的Uri對象
    
//RxJava
RxHttp.get("/service/.../xxx.apk")       
    .asAppendDownload(factory, AndroidSchedulers.mainThread()) {
        //下載進(jìn)度回調(diào),0-100,僅在進(jìn)度有更新時才會回調(diào)       
        int currentProgress = it.getProgress() //當(dāng)前進(jìn)度 0-100   
        long currentSize = it.getCurrentSize() //當(dāng)前已上傳的字節(jié)大小   
        long totalSize = it.getTotalSize()     //要上傳的總字節(jié)大小 
    }
    .subscribe({                
        //成功回調(diào)拣帽,這里返回工廠類構(gòu)建的Uri對象              
    }, {                
        //異常失敗                       
    }) 

5疼电、如何構(gòu)建Uri對象?

在上面代碼中减拭,我們自定義了Android10DownloadFactory類蔽豺,其中最為關(guān)鍵的代碼就是如何構(gòu)建一個Uri對象,接下來拧粪,就教大家如何去構(gòu)建一個Uri修陡,馬上開始,如下:

public Uri getUri(Context context) {  
    ContentValues values = new ContentValues();
    //1可霎、配置文件名                                                          
    values.put(MediaStore.MediaColumns.DISPLAY_NAME, "1.jpg");
    //2魄鸦、配置文件類型
    values.put(MediaStore.MediaColumns.MIME_TYPE, "image/jpeg")
    //3、配置存儲目錄
    values.put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DCIM); 
    //4癣朗、將配置好的對象插入到某張表中号杏,最終得到Uri對象
    return context.getContentResolver().insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
}                                                                                                  
  • 第一步,配置文件名稱,這個就沒啥好說的了

  • 第二步盾致,配置文件類型,每個文件都應(yīng)該有一個類型描述荣暮,這樣庭惜,后續(xù)查找時,就可以根據(jù)這個類型去查找出同一類型的文件穗酥,如:查找相冊护赊,此屬性是可選的,如果不配置砾跃,后續(xù)就無法根據(jù)類型查找到這個文件

  • 第三步骏啰,配置存儲目錄,這個是相對路徑抽高,總共有10個目錄可選判耕,如下:

    • Environment.DIRECTORY_DOCUMENTS 對應(yīng)路徑:/storage/emulated/0/Documents/
    • Environment.DIRECTORY_DOWNLOADS 對應(yīng)路徑:/storage/emulated/0/Download/
    • Environment.DIRECTORY_DCIM 對應(yīng)路徑:/storage/emulated/0/DCIM/
    • Environment.DIRECTORY_PICTURES 對應(yīng)路徑:/storage/emulated/0/Pictures/
    • Environment.DIRECTORY_MOVIES 對應(yīng)路徑:/storage/emulated/0/Movies/
    • Environment.DIRECTORY_ALARMS 對應(yīng)路徑:/storage/emulated/0/Alrams/
    • Environment.DIRECTORY_MUSIC 對應(yīng)路徑:/storage/emulated/0/Music/
    • Environment.DIRECTORY_NOTIFICATIONS 對應(yīng)路徑:/storage/emulated/0/Notifications/
    • Environment.DIRECTORY_PODCASTS 對應(yīng)路徑:/storage/emulated/0/Podcasts/
    • Environment.DIRECTORY_RINGTONES 對應(yīng)路徑:/storage/emulated/0/Ringtones/

如果需要在以上目錄下,創(chuàng)建子目錄翘骂,則傳入的時候壁熄,直接帶上即可,如下

values.put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DCIM + "/RxHttp"); 
  • 第四步碳竟,插入到對應(yīng)的表中草丧,總共有5張表可選,如下:

    • 存儲圖片:MediaStore.Images.Media.EXTERNAL_CONTENT_URI
    • 存儲視頻:MediaStore.Video.Media.EXTERNAL_CONTENT_URI
    • 存儲音頻:MediaStore.Audio.Media.EXTERNAL_CONTENT_URI
    • 存儲任意文件:MediaStore.Downloads.EXTERNAL_CONTENT_URI
    • 存儲任意文件:MediaStore.Files.getContentUri(MediaStore.VOLUME_EXTERNAL)

需要特殊說明下莹桅,以上5張表中昌执,只能存入對應(yīng)文件類型的信息,如我們不能將音頻文件信息诈泼,插入到MediaStore.Images.Media.EXTERNAL_CONTENT_URI圖片表中懂拾,插入時,系統(tǒng)會直接拋出異常

注意事項

以上5張表中厂汗,除了對插入的文件類型有限制外委粉,還對要插入的相對路徑有限制,如娶桦,我們將一個apk文件下載/storage/emulated/0/Download/RxHttp/目錄下贾节,并插入到圖片表中,如下:

public Uri getUri(Context context) {  
    ContentValues values = new ContentValues();
    values.put(MediaStore.MediaColumns.DISPLAY_NAME, "1.apk");
    values.put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS + "/RxHttp"); 
    return context.getContentResolver().insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
}         

當(dāng)執(zhí)行到insert操作時衷畦,系統(tǒng)將會直接報錯栗涂,報錯信息如下:

Primary directory Download not allowed for content://media/external/images/media; allowed directories are [DCIM, Pictures]

大致意思就是,Download目錄不允許插入到MediaStore.Images.Media.EXTERNAL_CONTENT_URI表中祈争,該表只允許插入DCIMPictures目錄

6斤程、小結(jié)

開源不易,寫文章更不易,喜歡的話忿墅,還需勞煩大家給本文點個贊扁藕,可以的話,再給個star疚脐,我將感激不盡亿柑,????????????????????????

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市棍弄,隨后出現(xiàn)的幾起案子望薄,更是在濱河造成了極大的恐慌,老刑警劉巖呼畸,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件痕支,死亡現(xiàn)場離奇詭異,居然都是意外死亡蛮原,警方通過查閱死者的電腦和手機(jī)卧须,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來瞬痘,“玉大人故慈,你說我怎么就攤上這事】蛉” “怎么了察绷?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長津辩。 經(jīng)常有香客問我拆撼,道長,這世上最難降的妖魔是什么喘沿? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任闸度,我火速辦了婚禮,結(jié)果婚禮上蚜印,老公的妹妹穿的比我還像新娘莺禁。我一直安慰自己,他們只是感情好窄赋,可當(dāng)我...
    茶點故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布哟冬。 她就那樣靜靜地躺著,像睡著了一般忆绰。 火紅的嫁衣襯著肌膚如雪浩峡。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天错敢,我揣著相機(jī)與錄音翰灾,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛纸淮,可吹牛的內(nèi)容都是我干的平斩。 我是一名探鬼主播,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼萎馅,長吁一口氣:“原來是場噩夢啊……” “哼双戳!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起糜芳,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎魄衅,沒想到半個月后峭竣,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡晃虫,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年皆撩,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片哲银。...
    茶點故事閱讀 39,690評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡扛吞,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出荆责,到底是詐尸還是另有隱情滥比,我是刑警寧澤,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布做院,位于F島的核電站盲泛,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏键耕。R本人自食惡果不足惜寺滚,卻給世界環(huán)境...
    茶點故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望屈雄。 院中可真熱鬧村视,春花似錦、人聲如沸酒奶。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽讥蟆。三九已至勒虾,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間瘸彤,已是汗流浹背修然。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人愕宋。 一個月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓玻靡,卻偏偏與公主長得像,于是被迫代替她去往敵國和親中贝。 傳聞我的和親對象是個殘疾皇子囤捻,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,577評論 2 353

推薦閱讀更多精彩內(nèi)容