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

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

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

官方給出解決這個(gè)問題的方案,就是使用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ī)拍照的代碼镇草,拍照成功后眶痰,照片會(huì)存儲(chǔ)在picFile文件中。

這段代碼在Android 7.0之前是沒有任何問題的(奇葩情況忽略)梯啤,但是如果你嘗試在7.0的系統(tǒng)上運(yùn)行(可以用模擬器測(cè)試竖伯,我也沒真機(jī)),會(huì)拋出文章開頭提到的FileUriExposedException異常因宇。

既然官方推薦使用FileProvider來解決此問題七婴,我們就來看下如何使用吧~

二、使用FileProvider
FileProvider使用大概分為以下幾個(gè)步驟:

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

root.png

編寫好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è)不在本篇文章討論的范圍罩驻。

本文源碼

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市护赊,隨后出現(xiàn)的幾起案子惠遏,更是在濱河造成了極大的恐慌,老刑警劉巖骏啰,帶你破解...
    沈念sama閱讀 211,123評(píng)論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件节吮,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡判耕,警方通過查閱死者的電腦和手機(jī)透绩,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,031評(píng)論 2 384
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人帚豪,你說我怎么就攤上這事碳竟。” “怎么了狸臣?”我有些...
    開封第一講書人閱讀 156,723評(píng)論 0 345
  • 文/不壞的土叔 我叫張陵莹桅,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我烛亦,道長(zhǎng)诈泼,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,357評(píng)論 1 283
  • 正文 為了忘掉前任煤禽,我火速辦了婚禮厂汗,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘呜师。我一直安慰自己娶桦,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,412評(píng)論 5 384
  • 文/花漫 我一把揭開白布汁汗。 她就那樣靜靜地躺著衷畦,像睡著了一般。 火紅的嫁衣襯著肌膚如雪知牌。 梳的紋絲不亂的頭發(fā)上祈争,一...
    開封第一講書人閱讀 49,760評(píng)論 1 289
  • 那天,我揣著相機(jī)與錄音角寸,去河邊找鬼菩混。 笑死,一個(gè)胖子當(dāng)著我的面吹牛扁藕,可吹牛的內(nèi)容都是我干的沮峡。 我是一名探鬼主播,決...
    沈念sama閱讀 38,904評(píng)論 3 405
  • 文/蒼蘭香墨 我猛地睜開眼亿柑,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼邢疙!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起望薄,我...
    開封第一講書人閱讀 37,672評(píng)論 0 266
  • 序言:老撾萬榮一對(duì)情侶失蹤疟游,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后痕支,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體颁虐,經(jīng)...
    沈念sama閱讀 44,118評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,456評(píng)論 2 325
  • 正文 我和宋清朗相戀三年卧须,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了另绩。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片瞬痘。...
    茶點(diǎn)故事閱讀 38,599評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖板熊,靈堂內(nèi)的尸體忽然破棺而出框全,到底是詐尸還是另有隱情,我是刑警寧澤干签,帶...
    沈念sama閱讀 34,264評(píng)論 4 328
  • 正文 年R本政府宣布津辩,位于F島的核電站,受9級(jí)特大地震影響容劳,放射性物質(zhì)發(fā)生泄漏喘沿。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,857評(píng)論 3 312
  • 文/蒙蒙 一竭贩、第九天 我趴在偏房一處隱蔽的房頂上張望蚜印。 院中可真熱鬧,春花似錦留量、人聲如沸窄赋。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,731評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)忆绰。三九已至,卻和暖如春可岂,著一層夾襖步出監(jiān)牢的瞬間错敢,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,956評(píng)論 1 264
  • 我被黑心中介騙來泰國(guó)打工缕粹, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留稚茅,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 46,286評(píng)論 2 360
  • 正文 我出身青樓平斩,卻偏偏與公主長(zhǎng)得像亚享,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子双戳,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,465評(píng)論 2 348

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