Android 7.0適配-應(yīng)用之間共享文件(FileProvider)

一、前言
Android 7.0強(qiáng)制啟用了被稱作 StrictMode的策略,帶來的影響就是你的App對外無法暴露file://類型的URI了。

如果你使用Intent攜帶這樣的URI去打開外部App(比如:打開系統(tǒng)相機(jī)拍照),那么會拋出FileUriExposedException異常。

官方給出解決這個問題的方案,就是使用FileProvider

FileProvider.png

我們來看一段代碼:

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使用大概分為以下幾個步驟:

  1. manifest中申明FileProvider
  2. res/xml中定義對外暴露的文件夾路徑
  3. 生成content://類型的Uri
  4. 給Uri授予臨時權(quán)限
  5. 使用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):

root.png

編寫好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)限,這個不在本篇文章討論的范圍。

本文源碼

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容