作者：才華橫溢的段老師?藍(lán)田大營

一、背景

Android 從 N 開始不允許以 file:// 的方式通過 Intent 在兩個(gè) App 之間分享文件，取而代之的是通過 FileProvider 生成 content://Uri 。如果在 Android N 以上的版本繼續(xù)使用 file:// 的方式分享文件，則系統(tǒng)會(huì)直接拋出異常，導(dǎo)致 App 出現(xiàn) Crash ，同時(shí)會(huì)報(bào)以下錯(cuò)誤日志：

FATAL EXCEPTION: mainProcess: com.inthecheesefactory.lab.intent_fileprovider, PID: 28905android.os.FileUriExposedException: file:///storage/emulated/0/.../xxx/xxx.jpg exposed beyond app through ClipData.Item.getUri()at android.os.StrictMode.onFileUriExposed(StrictMode.java:1799)at android.net.Uri.checkFileUriExposed(Uri.java:2346)at android.content.ClipData.prepareToLeaveProcess(ClipData.java:832)

當(dāng)然如果工程的 targetSDK 小于24，暫時(shí)還不會(huì)遇到這個(gè)問題，一旦升級(jí)到24及以上，則會(huì)立即出現(xiàn)上述問題，所以提早做好預(yù)防很有必要，否則等到線上曝出大量的 bug 就很被動(dòng)了。

二、關(guān)于 FileProvider

官方對(duì)于 FileProvider 的解釋為：FileProvider 是一個(gè)特殊的 ContentProvider 子類，通過 content://Uri 代替 file://Uri 實(shí)現(xiàn)不同 App 間的文件安全共享。

當(dāng)通過包含 Content URI 的 Intent 共享文件時(shí)，需要申請(qǐng)臨時(shí)的讀寫權(quán)限，可以通過 Intent.setFlags() 方法實(shí)現(xiàn)。

而 file://Uri 方式需要申請(qǐng)長期有效的文件讀寫權(quán)限，直到這個(gè)權(quán)限被手動(dòng)改變?yōu)橹?#xff0c;這是極其不安全的做法。因此 Android 從 N 版本開始禁止通過 file://Uri 在不同 App 之間共享文件。

三、FileProvider 的使用流程

完成整個(gè)文件共享的流程，需要配置以下5點(diǎn)：

定義一個(gè) FileProvider

指定有效的文件

為文件生成有效的 Content URI

申請(qǐng)臨時(shí)的讀寫權(quán)限

發(fā)送 Content URI 至其他的 App

1. 定義 FileProvider

FileProvider 已經(jīng)把文件生成 Content URI 的工作幫我們做掉了，因此我們只需要在 AndroidManifest.xml 文件中配置 <provider> 元素并提供相應(yīng)的屬性。

重要的屬性包括以下四個(gè)：

• 設(shè)置 android:name 為android.support.v4.content.FileProvider，這是固定的，不需要手動(dòng)更改；
• 設(shè)置 android:authorities 為 application id + .provider ；
• 設(shè)置 android:exported 為 false ，表示 FileProvider 不是公開的；
• 設(shè)置 android:grantUriPermissions 為 true 表示允許臨時(shí)讀寫文件。

此處需要特別說明的是

android:authorities 最好是 application id 而不能直接用包名硬編碼，因?yàn)?Android 系統(tǒng)要求 android:authorities 對(duì)于每個(gè) App 而言必須是唯一的。

假如 FileProvider 用在 SDK 中，多個(gè) App 都在調(diào)用同一個(gè) SDK，而 SDK 中的 android:authorities 為硬編碼，那么 App 之間的 authorities 就會(huì)出現(xiàn)沖突，會(huì)報(bào) Install shows error in console: INSTALL FAILED CONFLICTING PROVIDER 的錯(cuò)誤。

如果 SDK 的 android:authorities 是 application id，那么 authorities 會(huì)和宿主 App 的 application id 保持一致，就不會(huì)出現(xiàn) authorities 沖突的問題。

在 Java 代碼中調(diào)用 getPackageName() 返回的是 application id ，而非 package name ，要驗(yàn)證這一點(diǎn)也很容易，在 build.gradle 文件中定義和包名不同的 application id ，打印代碼中 getPackageName() 的返回值，就會(huì)發(fā)現(xiàn)返回值是 build.gradle 中自定義的 application id ，而非 package name

關(guān)于 package name 和 application id 的區(qū)別可以參考?ApplicationId 與 PackageName 的區(qū)別

以下是一個(gè)簡單的示例：

<manifest>...<application>...<providerandroid:name="android.support.v4.content.FileProvider"android:authorities="${applicationId}.provider"android:exported="false"android:grantUriPermissions="true">...</provider>...</application> </manifest>

需要說明的是 ${applicationId} 是占位符，Gradle 會(huì)替換成我們?cè)?build.gralde 中定義的 applicationId "com.domain.example"，如果 build.gradle 文件中沒有定義,那么 application id的默認(rèn)值是 App 的 package name。

2. 指定有效的文件

在生成 Content URI 之前你還需要提前指定文件目錄，通常的做法是在 res 目錄下新建一個(gè) xml 文件夾，然后創(chuàng)建一個(gè) xml 文件，在此文件中指定共享文件的路徑和名字，示例如下：

<paths xmlns:android="http://schemas.android.com/apk/res/android"><external-path name="my_images" path="images/"/>... </paths>

其中 name 屬性和 path 屬性必填， name 表示共享文件的名字， path 代表文件路徑。

• external-path 代表文件位于手機(jī)外部存儲(chǔ)空間，訪問效果如同 Environment.getExternalStorageDirectory()；
• files-path 代表文件位于手機(jī)內(nèi)部存儲(chǔ)空間，訪問效果如同 getFilesDir()；
• cache-path 代表文件位于手機(jī)內(nèi)部緩存空間，訪問效果如同 getCacheDir()。

xml 文件創(chuàng)建完成后，還需要在 manifest 文件的 <provider> 元素下完成相應(yīng)的配置，假定 xml 文件命名為 file_paths.xml ，示例如下：

<providerandroid:name="android.support.v4.content.FileProvider"android:authorities="${applicationId}.provider"android:exported="false"android:grantUriPermissions="true"><meta-dataandroid:name="android.support.FILE_PROVIDER_PATHS"android:resource="@xml/file_paths" /> </provider>

3. 為共享文件生成 Content URI

文件配置完成后還需要生成可以被其他 App 訪問的 Content URI，可以直接調(diào)用 FileProvider 提供的 getUriForFile(File file) 方法，顧名思義，傳入文件名稱就可以得到相應(yīng)的 Content URI 。需要訪問該文件的 App 可以通過 ContentResolver.openFileDescriptor 得到一個(gè) ParcelFileDescriptor 對(duì)象。

假定你想要共享一個(gè)圖片文件，文件存放的位置為手機(jī)內(nèi)部存儲(chǔ)空間下的 images 文件夾，圖片文件名字為 default_name.jpg ，那么生成 Content URI 方式如下：

File imagePath = new File(getContext().getFilesDir(), "images"); File newFile = new File(imagePath, "default_image.jpg"); Uri contentUri = getUriForFile(getContext(), "com.mydomain.provider", newFile);

最后生成的 Content URI 為

content://com.domain.example.provider/images/default_image.jpg.

4. 申請(qǐng)臨時(shí)讀寫文件權(quán)限

上文已經(jīng)提到 FileProvider 可以申請(qǐng)臨時(shí)讀寫文件權(quán)限，以增強(qiáng)安全性，所以 Content URI 生成完成后，還需要申請(qǐng)臨時(shí)訪問權(quán)限。

通常直接通過 intent.setFlags 即可完成，具體的權(quán)限名稱為：Intent.FLAG_GRANT_READ_URI_PERMISSION 和 Intent.FLAG_GRANT_WRITE_URI_PERMISSION。

5. 發(fā)送 Content URI 至其他的 App

萬事已備，只需要發(fā)送出去即可，通常都會(huì)使用 startActivityForResult 方法發(fā)送，可以在 onActivityResult 中獲取其他 App 的處理結(jié)果，完成整個(gè)操作閉環(huán)。

三、實(shí)用場景——手機(jī)照相

在 Android N 之前的版本調(diào)用相機(jī)獲取圖片可以用如下代碼實(shí)現(xiàn)：

// 設(shè)置照片需要存儲(chǔ)的位置 photoPath = FileUtil.getImageFile().getPath() Intent intent = new Intent();// 指定開啟系統(tǒng)相機(jī)的Action intent.setAction(MediaStore.ACTION_IMAGE_CAPTURE); intent.addCategory(Intent.CATEGORY_DEFAULT);// 把文件地址轉(zhuǎn)換成Uri格式 Uri uri = Uri.parse("file://" + photoPath); intent.putExtra(MediaStore.EXTRA_OUTPUT, uri); activity.startActivityForResult(intent, requestCode);

如果要想在 Android N 及以上版本上不會(huì)出錯(cuò)，則必須將 file:// 形式替換成 content:// ，具體的代碼如下：

Intent intent = new Intent(); intent.setAction(MediaStore.ACTION_IMAGE_CAPTURE);// 系統(tǒng)版本大于N的統(tǒng)一用FileProvider處理 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {// 將文件轉(zhuǎn)換成content://Uri的形式Uri photoURI = FileProvider.getUriForFile(activity,activity.getPackageName()+ ".provider",new File(photoPath));// 申請(qǐng)臨時(shí)訪問權(quán)限intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_GRANT_READ_URI_PERMISSION| Intent.FLAG_GRANT_WRITE_URI_PERMISSION);intent.putExtra(MediaStore.EXTRA_OUTPUT, photoURI); } else {intent.addCategory(Intent.CATEGORY_DEFAULT);Uri uri = Uri.parse("file://" + photoPath);intent.putExtra(MediaStore.EXTRA_OUTPUT, uri); } activity.startActivityForResult(intent, requestCode);

需要注意的是 getPackageName() 返回值是 application id，關(guān)于 application id 上文已經(jīng)解釋過，此處不再重復(fù)。

實(shí)用場景——微信朋友圈多圖分享

微信官方不支持朋友圈直接多圖分享，Android 之前的版本由于沒有強(qiáng)制限制 file:// 的使用，所以可以通過訪問微信包名的方式實(shí)現(xiàn)朋友圈多圖分享，但是Android N 之后這種“曲線救國”的方式就不行了。

先來看一下之前如何通過訪問包名實(shí)現(xiàn)朋友圈多圖分享，代碼如下：

Intent intent = new Intent(); intent.setComponent(new ComponentName("com.tencent.mm", "com.tencent.mm.ui.tools.ShareToTimeLineUI")); intent.setAction("android.intent.action.SEND_MULTIPLE");// List存儲(chǔ)多張圖片地址 ArrayList<Uri> localArrayList = new ArrayList<>(); for (int i = 0, size = localPicsList.size(); i < size; i++) {localArrayList.add(Uri.parse("file:///" + localPicsList.get(i))); }intent.putParcelableArrayListExtra("android.intent.extra.STREAM", localArrayList); intent.setType("image/*"); intent.putExtra("Kdescription", desc); context.startActivity(intent);

這種方式可以直接繞過微信官方 SDK 實(shí)現(xiàn)多圖分享，無需手動(dòng)選擇圖片，唯一的問題就是沒有分享結(jié)果的回調(diào)，也就是說無法判斷是否分享成功，這在大部分情況下依然是一種可以接受的方案。

但是如果 targetSDK 大于等于24，那么這項(xiàng)功能就無效了，原因就是 Android N 不允許 file://Uri 的方式在不同的 App 間共享文件，但是如果換成 FileProvider 的方式，經(jīng)試驗(yàn)發(fā)現(xiàn)依然是無效的，所以在 Android N 上無法實(shí)現(xiàn)朋友圈直接多圖分享。

原文地址：　https://zhuanlan.zhihu.com/p/26139355

總結(jié)

以上是生活随笔為你收集整理的FileProvider 在 Android N 上的应用的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。