一、前言
Android 7.0強(qiáng)制啟用了被稱作 StrictMode的策略,帶來的影響就是你的App對外無法暴露file://類型的URI了。
如果你使用Intent攜帶這樣的URI去打開外部App(比如:打開系統(tǒng)相機(jī)拍照),那么會拋出FileUriExposedException異常。
官方給出解決這個問題的方案,就是使用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ī)拍照的代碼,拍照成功后,照片會存儲在picFile文件中。
這段代碼在Android 7.0之前是沒有任何問題的(奇葩情況忽略),但是如果你嘗試在7.0的系統(tǒng)上運行(可以用模擬器測試,我也沒真機(jī)),會拋出文章開頭提到的FileUriExposedException異常。
既然官方推薦使用FileProvider來解決此問題,我們就來看下如何使用吧~
二、使用FileProvider
FileProvider使用大概分為以下幾個步驟:
- manifest中申明FileProvider
- res/xml中定義對外暴露的文件夾路徑
- 生成content://類型的Uri
- 給Uri授予臨時權(quán)限
- 使用Intent傳遞Uri
我們分別看下這幾個步驟的具體實現(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,命名空間之類,后面會用到。
android:exported:false表示我們的provider不需要對外開放。
android:grantUriPermissions:申明為true,你才能獲取臨時共享權(quán)限。
2. res/xml中定義對外暴露的文件夾路徑:
新建file_paths.xml,文件名隨便起,后面會引用到。
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<files-path name="my_images" path="images"/>
</paths>
name:一個引用字符串。
path:文件夾“相對路徑”,完整路徑取決于當(dāng)前的標(biāo)簽類型。
path可以為空,表示指定目錄下的所有文件、文件夾都可以被共享。
<paths>這個元素內(nèi)可以包含以下一個或多個,具體如下:
<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這個版本并未支持,直到support-v4:25.0.0才支持,最近適配才發(fā)現(xiàn)這個坑!!!
番外:以上是官方提供的幾種path類型,不過如果你想使用外置SD卡,可以用這個:
<root-path name="name" path="path" />
物理路徑相當(dāng)于/path/。
這個官方文檔并沒有給出,我們查看源碼可以發(fā)現(xiàn):

編寫好file_paths.xml,我們在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來實現(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申明的其中一個符合(或者子文件夾:"images/work")。當(dāng)然,你可以申明N個你需要共享的路徑:
<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:第一個參數(shù)是Context;第二個參數(shù),就是我們之前在manifest#provider中定義的android:authorities屬性的值;第三個參數(shù)是File。
4.給Uri授予臨時權(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)限。
你可以同時或單獨使用這兩個權(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);
// 授予目錄臨時共享權(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)需要動態(tài)申請權(quán)限,這個不在本篇文章討論的范圍。