发现问题

前几天把手机系统升级到基于 Android 7.0,后来在升级调试一个应用时抛出如下异常信息:

android.os.FileUriExposedException: file:///storage/emulated/0/Android/data/com.skyrin.bingo/cache/app/app.apk exposed beyond app through Intent.getData()
at android.os.StrictMode.onFileUriExposed(StrictMode.java:1799)
...
at com.skyrin.bingo.update.AppUpdate.installApk(AppUpdate.java:295)

根据如上日志找到出问题的 AppUpdate 类下的 installApk 方法(295 行示例倒数第二行):

/**
 * 安装apk
 */
public static void installApk(Context context,String apkPath) {
    if (TextUtils.isEmpty(apkPath)){
        Toast.makeText(context,"更新失败!未找到安装包", Toast.LENGTH_SHORT).show();
        return;
    }

    File apkFile = new File(apkPath
            + apkCacheName);

    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    intent.setDataAndType(
            Uri.fromFile(apkFile),
            "application/vnd.android.package-archive");
    context.startActivity(intent); //第295行
}

问题出在启动安装程序阶段

什么导致了这个问题?

由于没升级 7.0 系统之前都没有问题,于是就在 Android 官网查看了一下 Android 7.0 新特性,终于发现其中 “在应用间共享文件” 一栏明确指出了这个问题

这个问题是由于 Android 7.0 权限更改导致,确切的讲是 Android 对权限的进一步管理,从 Android 6.0 的动态权限申请到这个问题可以看出 Google 也是越来越重视 Android 环境的安全问题了。

解决问题

官方给出的解决方式是通过 FileProvider 来为所共享的文件 Uri 添加临时权限,详细请看这里

  • 在  标签下添加 FileProvider 节点
<application
   ...>
   ...
    <provider
        android:name="android.support.v4.content.FileProvider"
        android:authorities="com.skyrin.bingo.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
   ...
</application>

android:authority 属性指定要用于 FileProvider 生成的 content URI 的 URI 权限,这里推荐使用 包名.fileprovider 以确保其唯一性。
<provider><meta-data> 子元素指向一个 XML 文件,用于指定要共享的目录。

  • res/xml 目录下创建文件 file_paths.xml 内容如下:
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-cache-path path="app/" name="apk"/>
</paths>

<external-cache-path> 表示应用程序内部存储目录下的 cache/ 目录,完整路径为 Android/data/com.xxx.xxx/cache/
path 属性用于指定子目录。
name 属性告诉 FileProvider 为 Android/data/com.xxx.xxx/cache/app/ 创建一个名为 apk 的路径字段。

通过如上设置之后,当我们为 app.apk 请求 URI 时,FileProvider 就能根据配置返回如下 URI 了:
content://com.skyrin.bingo.fileprovider/apk/app.apk

请注意,想要通过 FileProvider 为文件生成 content URI 只能在此处指定目录,以上示例就表示我将要共享 Android/data/com.xxx.xxx/cache/app/ 这个目录,除此之外还可以共享其它目录,其标签对应的路径如下:

标签对应方法返回路径Context.getFilesDir()/data/user/0/com.xxx.xxx/filesContext.getCacheDir()/data/user/0/com.xxx.xxx/cacheEnvironment.getExternalStorageDirectory()/storage/emulated/0Context.getExternalFilesDir("images")/storage/emulated/0/Android/data/com.xxx.xxx/files/imagesContext.getExternalCacheDir()/storage/emulated/0/Android/data/com.xxx.xxx/cache

  • 完成以上步骤后,我们修改出问题的代码如下:
/**
 * 安装apk
 */
public static void installApk(Context context,String apkPath) {
    if (TextUtils.isEmpty(apkPath)){
        Toast.makeText(context,"更新失败!未找到安装包", Toast.LENGTH_SHORT).show();
        return;
    }

    File apkFile = new File(apkPath
            + apkCacheName);

    Intent intent = new Intent(Intent.ACTION_VIEW);
    //Android 7.0 系统共享文件需要通过 FileProvider 添加临时权限,否则系统会抛出 FileUriExposedException .
    if (Build.VERSION.SDK_INT>=Build.VERSION_CODES.N){
        intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
        Uri contentUri = FileProvider.getUriForFile(context,"com.skyrin.bingo.fileprovider",apkFile);
        intent.setDataAndType(contentUri,"application/vnd.android.package-archive");
    }else {
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        intent.setDataAndType(
                Uri.fromFile(apkFile),
                "application/vnd.android.package-archive");
    }
    context.startActivity(intent);
}
...
//调用,apkPath 入参就是 xml 中共享的路径
String apkPath = context.getExternalCacheDir().getPath()+ File.separator+"app"+File.separator;
AppUpdate.installApk(context,apkPath );

至此,问题解决。

结语

除了上面这个问题,在 API Level 24(Android 7.0)之前开发的分享图文、浏览编辑本地图片、共享互传文件等功能如果没有使用 FileProvider 来生成 URI 的话,在 Android 7.0 上就必须做这种适配了,所以平时建议大家多关注 Android 新的 API ,尽早替换已被官方废弃的 API ,实际上 FileProvider  在 API Level 22(Android 5.1) 已经添加了。