Android 升級安裝APK兼容Android7.0，解決FileUriExposedException

我們在開發app時避免不了需要添加應用內升級功能。當app啟動時，如果檢測到最新版本，將apk安裝包從服務器下載下來，執行安裝。
安裝apk的代碼一般寫法如下，網上隨處可以搜到

public static void installApk(Context context, File file) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    Uri data = Uri.fromFile(file);
    intent.setDataAndType(data, "application/vnd.android.package-archive");
    context.startActivity(intent);
}

然而，當我們在Android7.0手機中執行時，會發現報如下錯誤日志

Caused by: android.os.FileUriExposedException: file:///storage/emulated/0/Android/data/net.csdn.blog.ruancoder/cache/test.apk exposed beyond app through Intent.getData()
   at android.os.StrictMode.onFileUriExposed(StrictMode.java:1799)
   at android.net.Uri.checkFileUriExposed(Uri.java:2346)
   at android.content.Intent.prepareToLeaveProcess(Intent.java:8933)
   at android.content.Intent.prepareToLeaveProcess(Intent.java:8894)
   at android.app.Instrumentation.execStartActivity(Instrumentation.java:1517)
   at android.app.Activity.startActivityForResult(Activity.java:4224)
   at android.support.v4.app.BaseFragmentActivityJB.startActivityForResult(BaseFragmentActivityJB.java:50)
   at android.support.v4.app.FragmentActivity.startActivityForResult(FragmentActivity.java:79)
   at android.app.Activity.startActivityForResult(Activity.java:4183)
   at android.support.v4.app.FragmentActivity.startActivityForResult(FragmentActivity.java:859)
   at android.app.Activity.startActivity(Activity.java:4507)
   at android.app.Activity.startActivity(Activity.java:4475)

我們來看一下FileUriExposedException官方文檔

https://developer.android.google.cn/reference/android/os/FileUriExposedException.html

從Android 7.0開始，不再允許在app中把file:// Uri暴露給其他app，否則應用會拋出FileUriExposedException。原因在於，Google認為使用file:// Uri存在一定的風險。比如，文件是私有的，其他app無法訪問該文件，或者其他app沒有申請READ_EXTERNAL_STORAGE運行時權限。解決方案是，使用FileProvider生成content:// Uri來替代file:// Uri。

FileProvider官方文檔：
https://developer.android.google.cn/reference/android/support/v4/content/FileProvider.html
下面我們使用FileProvider解決上述異常。
1.聲明FileProvider
首先在清單文件中申明FileProvider。

<manifest>
    ...
    <application>
        ...
        <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="net.csdn.blog.ruancoder.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
        </provider>
        ...
    </application>
</manifest>

其中
android:name是固定寫法。
android:authorities可自定義，是用來標識該provider的唯一標識，建議結合包名來保證authority的唯一性。
android:exported必須設置成 false，否則運行時會報錯java.lang.SecurityException: Provider must not be exported 。
android:grantUriPermissions用來控制共享文件的訪問權限。
<meta-data>節點中的android:resource指定了共享文件的路徑。此處的file_paths即是該Provider對外提供文件的目錄的配置文件，存放在res/xml/下。
2.添加file_paths.xml文件
文件格式如下

<paths>
    <files-path name="name" path="path"/>
    ...
</paths>

其中根元素<paths>是固定的，內部元素可以是以下節點：
<files-path name="name" path="path" /> 對應getFilesDir()。
<cache-path name="name" path="path" /> 對應getCacheDir()。
<external-path name="name" path="path" /> 對應Environment.getExternalStorageDirectory()。
<external-files-path name="name" path="path" /> 對應getExternalFilesDir()。
<external-cache-path name="name" path="path" /> 對應getExternalCacheDir()。
此處，我們將下載的apk文件存放到sdcard中的Android/data/<package>/cache/download中，file_paths.xml文件如下。

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-cache-path name="cache_download" path="download"/>
</paths>

3.在Java代碼中使用FileProvider

public static void installApk(Context context, File file) {
    Intent intent = new Intent(Intent.ACTION_VIEW);
    Uri data;
    // 判斷版本大於等於7.0
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        // "net.csdn.blog.ruancoder.fileprovider"即是在清單文件中配置的authorities
        data = FileProvider.getUriForFile(context, "net.csdn.blog.ruancoder.fileprovider", file);
    // 給目標應用一個臨時授權
        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
    } else {
        data = Uri.fromFile(file);
    }
    intent.setDataAndType(data, "application/vnd.android.package-archive");
    context.startActivity(intent);
}