一要尔、前言
Android 7.0強(qiáng)制啟用了被稱作 StrictMode的策略础芍,帶來的影響就是你的App對(duì)外無法暴露file://
類型的URI了。
如果你使用Intent攜帶這樣的URI去打開外部App(比如:打開系統(tǒng)相機(jī)拍照)贤惯,那么會(huì)拋出FileUriExposedException異常菜皂。
官方給出解決這個(gè)問題的方案,就是使用FileProvider:
我們來看一段代碼:
String cachePath = getApplicationContext().getExternalCacheDir().getPath();
File picFile = new File(cachePath, "test.jpg");
Uri picUri = Uri.fromFile(picFile);
Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
intent.putExtra(MediaStore.EXTRA_OUTPUT, picUri);
startActivityForResult(intent, 100);
這是常見的打開系統(tǒng)相機(jī)拍照的代碼镇草,拍照成功后眶痰,照片會(huì)存儲(chǔ)在picFile
文件中。
這段代碼在Android 7.0之前是沒有任何問題的(奇葩情況忽略)梯啤,但是如果你嘗試在7.0的系統(tǒng)上運(yùn)行(可以用模擬器測(cè)試竖伯,我也沒真機(jī)),會(huì)拋出文章開頭提到的FileUriExposedException異常因宇。
既然官方推薦使用FileProvider來解決此問題七婴,我們就來看下如何使用吧~
二、使用FileProvider
FileProvider使用大概分為以下幾個(gè)步驟:
- manifest中申明FileProvider
- res/xml中定義對(duì)外暴露的文件夾路徑
- 生成content://類型的Uri
- 給Uri授予臨時(shí)權(quán)限
- 使用Intent傳遞Uri
我們分別看下這幾個(gè)步驟的具體實(shí)現(xiàn)吧
1.manifest中申明FileProvider:
<manifest>
...
<application>
...
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="com.mydomain.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
...
</provider>
...
</application>
</manifest>
android:name:provider
你可以使用v4
包提供的FileProvider察滑,或者自定義您自己的打厘,只需要在name
申明就好了,一般使用系統(tǒng)的就足夠了贺辰。
android:authorities:類似schema
户盯,命名空間之類,后面會(huì)用到饲化。
android:exported:false
表示我們的provider
不需要對(duì)外開放莽鸭。
android:grantUriPermissions:申明為true
,你才能獲取臨時(shí)共享權(quán)限吃靠。
2. res/xml中定義對(duì)外暴露的文件夾路徑:
新建file_paths.xml
硫眨,文件名隨便起,后面會(huì)引用到巢块。
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<files-path name="my_images" path="images"/>
</paths>
name:一個(gè)引用字符串礁阁。
path:文件夾“相對(duì)路徑”,完整路徑取決于當(dāng)前的標(biāo)簽類型夕冲。
path可以為空氮兵,表示指定目錄下的所有文件、文件夾都可以被共享歹鱼。
<paths>
這個(gè)元素內(nèi)可以包含以下一個(gè)或多個(gè)泣栈,具體如下:
<files-path name="name" path="path" />
物理路徑相當(dāng)于Context.getFilesDir() + /path/。
<cache-path name="name" path="path" />
物理路徑相當(dāng)于Context.getCacheDir() + /path/。
<external-path name="name" path="path" />
物理路徑相當(dāng)于Environment.getExternalStorageDirectory() + /path/南片。
<external-files-path name="name" path="path" />
物理路徑相當(dāng)于**Context.getExternalFilesDir(String) **+ /path/掺涛。
<external-cache-path name="name" path="path" />
物理路徑相當(dāng)于Context.getExternalCacheDir() + /path/。
注意:external-cache-path在support-v4:24.0.0這個(gè)版本并未支持疼进,直到support-v4:25.0.0才支持薪缆,最近適配才發(fā)現(xiàn)這個(gè)坑!!!
番外:以上是官方提供的幾種path類型,不過如果你想使用外置SD卡伞广,可以用這個(gè):
<root-path name="name" path="path" />
物理路徑相當(dāng)于/path/拣帽。
這個(gè)官方文檔并沒有給出,我們查看源碼可以發(fā)現(xiàn):
編寫好file_paths.xml
嚼锄,我們?cè)?code>manifest中的provider
這樣使用:
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="com.mydomain.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths" />
</provider>
3.生成content://類型的Uri
我們通常通過File生成Uri的代碼是這樣:
File picFile = xxx;
Uri picUri = Uri.fromFile(picFile);
這樣生成的Uri减拭,路徑格式為file://xxx
。前面我們也說了這種Uri是無法在App之間共享的区丑,我們需要生成content://xxx
類型的Uri拧粪,方法就是通過Context.getUriForFile
來實(shí)現(xiàn):
File imagePath = new File(Context.getFilesDir(), "images");
File newFile = new File(imagePath, "default_image.jpg");
Uri contentUri = getUriForFile(getContext(),
"com.mydomain.fileprovider", newFile);
imagePath:使用的路徑需要和你在file_paths.xml
申明的其中一個(gè)符合(或者子文件夾:"images/work")。當(dāng)然沧侥,你可以申明N個(gè)你需要共享的路徑:
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<files-path name="my_images" path="images"/>
<files-path name="my_docs" path="docs"/>
<external-files-path name="my_video" path="video" />
//...
</paths>
getUriForFile:第一個(gè)參數(shù)是Context可霎;第二個(gè)參數(shù),就是我們之前在manifest#provider
中定義的android:authorities
屬性的值宴杀;第三個(gè)參數(shù)是File癣朗。
4.給Uri授予臨時(shí)權(quán)限
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION
| Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
FLAG_GRANT_READ_URI_PERMISSION:表示讀取權(quán)限;
FLAG_GRANT_WRITE_URI_PERMISSION:表示寫入權(quán)限婴氮。
你可以同時(shí)或單獨(dú)使用這兩個(gè)權(quán)限斯棒,視你的需求而定盾致。
5.使用Intent傳遞Uri
以開頭的拍照代碼作為示例主经,需要這樣改寫:
// 重新構(gòu)造Uri:content://
File imagePath = new File(Context.getFilesDir(), "images");
if (!imagePath.exists()){imagePath.mkdirs();}
File newFile = new File(imagePath, "default_image.jpg");
Uri contentUri = getUriForFile(getContext(),
"com.mydomain.fileprovider", newFile);
Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
intent.putExtra(MediaStore.EXTRA_OUTPUT, contentUri);
// 授予目錄臨時(shí)共享權(quán)限
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION
| Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
startActivityForResult(intent, 100);
當(dāng)然,6.0以上系統(tǒng)需要?jiǎng)討B(tài)申請(qǐng)權(quán)限庭惜,這個(gè)不在本篇文章討論的范圍罩驻。