Android 进阶之旅 | android 打开手机文件

前端时间做项目遇到一个不大不小的问题 ，就是android 打开本地文件(xlsx)， 本来没太在意这个小功能，但是做的时候，突然遇到报了个错误（下面详细说明），本文也是做一个知识记录。

Android 7.0(N) 开始，将严格执行StrictMode模式，也就是说，将对安全做更严格的校验。从7.0开始将不允许app间，使用  file:// 的方式访问文件，否则会抛出  FileUriExposedException 异常，会直接引发crash。 
官方给的解决方案是，通过 content:// 的模式替换 file:// 模式，同时，需要开发者主动升级 targetSdkVersion 到 24 才会执行此策略。

在app 开发过程中需要用FileProvider的主要有：
1、相机拍照以及图片剪裁
2、调用系统应用安装apk（应用升级）
3、使用第三方应用，打开app下载的文件（例如word）

先说说打开本地文件步骤

1、权限问题

先要申请权限，读写文件权限

2、在清单文件AndroidManifest.xml 中声明 provider

<provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="自己的包名.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/filepaths" />
    </provider>

然后在res目录下面创建 filepaths 的资源文件

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

2.1 关于 paths 资源文件的配置

  <?xml version="1.0" encoding="utf-8"?>
    <paths>
       <!--代表外部存储区域的根目录下的文件 Environment.getExternalStorageDirectory()/DCIM/camerademo目录-->
      <!--/storage/emulated/0/DCIM/camerademo-->
      <external-path name="hm_DCIM" path="DCIM/camerademo" />

      <!--代表外部存储区域的根目录下的文件 Environment.getExternalStorageDirectory()/Pictures/camerademo目录-->
      <!--/storage/emulated/0/Pictures/camerademo-->
      <external-path name="hm_Pictures" path="Pictures/camerademo" />

      <!--代表app 私有的存储区域 Context.getFilesDir()目录下的images目录-->
      <!--/data/user/0/com.hm.camerademo/files/images-->
      <files-path name="hm_private_files" path="images" />

      <!-- 代表app 私有的存储区域 Context.getCacheDir()目录下的images目录 -->
      <!--/data/user/0/com.hm.camerademo/cache/images-->
      <cache-path name="hm_private_cache" path="images" />

      <!--代表app外部存储区域根目录下的文件 Context.getExternalFilesDir(Environment.DIRECTORY_PICTURES)目录下的Pictures目录-->
      <!--/storage/emulated/0/Android/data/com.hm.camerademo/files/Pictures-->
      <external-files-path name="hm_external_files" path="Pictures" />

      <!--代表app 外部存储区域根目录下的文件 Context.getExternalCacheDir目录下的images目录-->
      <!--/storage/emulated/0/Android/data/com.hm.camerademo/cache/images-->
      <external-cache-path name="hm_external_cache" path="images" />

    </paths>

name=“name” URI 路径段，取值会隐藏你分享的目录的名字。比如下面这个

<!--/storage/emulated/0/Android/data/com.hm.camerademo/cache/images-->
<external-cache-path name="filexx" path="images" />

会用 filexx替代 /storage/emulated/0/Android/data/com.xx.camera/cache/images

path=“path” 你分享的目录的名字

这个配置的标签可以参照FileProvider 里面的TAG 配置

private static final String TAG_ROOT_PATH = "root-path";
private static final String TAG_FILES_PATH = "files-path";
private static final String TAG_CACHE_PATH = "cache-path";
private static final String TAG_EXTERNAL = "external-path";
private static final String TAG_EXTERNAL_FILES = "external-files-path";
private static final String TAG_EXTERNAL_CACHE = "external-cache-path";
private static final String TAG_EXTERNAL_MEDIA = "external-media-path";

private static PathStrategy parsePathStrategy(Context context, String authority)
        throws IOException, XmlPullParserException {
    // ...
    int type;
    while ((type = in.next()) != END_DOCUMENT) {
        if (type == START_TAG) {
            final String tag = in.getName();

            final String name = in.getAttributeValue(null, ATTR_NAME);
            String path = in.getAttributeValue(null, ATTR_PATH);

            File target = null;
            if (TAG_ROOT_PATH.equals(tag)) {
                target = DEVICE_ROOT;
            } else if (TAG_FILES_PATH.equals(tag)) {
                target = context.getFilesDir();
            } else if (TAG_CACHE_PATH.equals(tag)) {
                target = context.getCacheDir();
            } else if (TAG_EXTERNAL.equals(tag)) {
                target = Environment.getExternalStorageDirectory();
            } else if (TAG_EXTERNAL_FILES.equals(tag)) {
                File[] externalFilesDirs = ContextCompat.getExternalFilesDirs(context, null);
                if (externalFilesDirs.length > 0) {
                    target = externalFilesDirs[0];
                }
            } else if (TAG_EXTERNAL_CACHE.equals(tag)) {
                File[] externalCacheDirs = ContextCompat.getExternalCacheDirs(context);
                if (externalCacheDirs.length > 0) {
                    target = externalCacheDirs[0];
                }
            } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP
                    && TAG_EXTERNAL_MEDIA.equals(tag)) {
                File[] externalMediaDirs = context.getExternalMediaDirs();
                if (externalMediaDirs.length > 0) {
                    target = externalMediaDirs[0];
                }
            }

            if (target != null) {
                strat.addRoot(name, buildPath(target, path));
            }
        }
    }

    return strat;
}

标签与对应地址，可以参考这里.

3 、为一个文件生成一个Content URI

private void openFile(String filePath) {
    Intent intent = new Intent();
    File file = new File(filePath);
    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);//设置标记
    intent.setAction(Intent.ACTION_VIEW);//动作，查看
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
        Uri uri = FileProvider.getUriForFile(getActivity(), getActivity().getPackageName() + ".file.fileprovider", file);
        grantPermissions(mContext, intent, uri, false);
        intent.setDataAndType(uri, "application/vnd.ms-excel");
    } else {
        intent.setDataAndType(Uri.fromFile(file), "application/vnd.ms-excel");
    }
    startActivity(intent);
}
// 给该文件临时授权
public static void grantPermissions(Context context, Intent intent, Uri uri, boolean writeAble) {
    int flag = Intent.FLAG_GRANT_READ_URI_PERMISSION;
    if (writeAble) {
        flag |= Intent.FLAG_GRANT_WRITE_URI_PERMISSION;
    }
    intent.addFlags(flag);
    List<ResolveInfo> resInfoList = context.getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
    for (ResolveInfo resolveInfo : resInfoList) {
        String packageName = resolveInfo.activityInfo.packageName;
        context.grantUriPermission(packageName, uri, flag);
    }
}

存在的问题：

image.png

提示：fileProvider 跟platform.aar库里面的冲突，需要替换
按照这个错误提示，我刚开始在<application 节点添加tool:replace ，但是还是报错，后来查询资料，才发现，要在当前<fileProvider 节点添加（如下图）即可解决这个问题