FileProvider

FileProvider

---

我对FileProvider的理解
如下：

android7.0开始，不再允许在app之间，使用file://的方式传递File，否则会抛出FileUriExposedException异常

1，可以使用FileProvider，content://解决这个问题
2，也可以把targetSdkVersion小于24（<7.0）,但我相信不会有人这样做

FileProvider是ContentProvider的子类，所以需要在 AndroidManifest.xml中配置，使用ContentProvider可以向其他的app分享数据
FileProvider可将这些数据转换成File文件

1,AndroidManifest.xml中配置FileProvider(可配置多个)

name:配置的是FileProvider实现类，这里使用的系统的是v4包下( name就是指定FileProvider
对于一个 App Module 而言，如果只是自己使用，可以直接使用 v4 包下的 FileProvider ，但是如果是作为一个 Lib Module 来供其他项目使用，最好还是重新空继承一个 FileProvider ，这里填写我们的继承类即可。)
authorities：配置一个 FileProvider 的名字，它在当前系统内需要是唯一值（一般使用包名）。
exported：表示 FileProvider 是否需要公开出去
granUriPermissions：表示是否授权文件的临时访问权限

meta-data指定FileProvider提供出去的路径
name：固定写法
resource指定了一个xml文件夹下的的filepaths文件，文件里面配置了路径（这里是在res下面新建了一个xml文件夹，并且xml中新建一个filepaths.xml）

filepaths的xml文件
如下：

paths必须最少都要配置一个XXXXXX-path标签，而这个标签其实表示的是一个路径

在FileProvider的类中可以看到
标签的类型如下：

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”;

在parsePathStrategy就可以看到所代表的路径

  private static PathStrategy parsePathStrategy(Context context, String authority)
            throws IOException, XmlPullParserException {
        final SimplePathStrategy strat = new SimplePathStrategy(authority);

        final ProviderInfo info = context.getPackageManager()
                .resolveContentProvider(authority, PackageManager.GET_META_DATA);
        final XmlResourceParser in = info.loadXmlMetaData(
                context.getPackageManager(), META_DATA_FILE_PROVIDER_PATHS);
        if (in == null) {
            throw new IllegalArgumentException(
                    "Missing " + META_DATA_FILE_PROVIDER_PATHS + " meta-data");
        }

        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;
    }

明显，我的path标签如下：表示的是外部存储

if (TAG_EXTERNAL.equals(tag)) {
              target = Environment.getExternalStorageDirectory();
}

好这里都配置好了，那就开始使用了喔，使用getUriForFile获取需要使用的Uri，参数就是一个context,authorities(配置一个 FileProvider 的名字，它在当前系统内需要是唯一值),然后需要一个文件

public static Uri getUriForFile(Context context, String authority, File file) {
        final PathStrategy strategy = getPathStrategy(context, authority);
        return strategy.getUriForFile(file);
 }

调用此方法，会自动得到一个 file:// 转换成 content:// 的 一个 Uri 对象，可以供我们直接使用。
配置 provider 标签的时候，有一个属性 android:grantUriPermissions=“true” ，它表示允许它授予 Uri 临时的权限。

当我们生成出一个 content:// 的 Uri 对象之后，其实也无法对其直接使用，还需要对这个 Uri 接收的 App 赋予对应的权限才可以。

这个授权的动作，提供了两种方式来授权
使用 Context.grantUriPermission() 为其他 App 授予 Uri 对象的访问权限

toPackage ：表示授予权限的 App 的包名。

uri：授予权限的 content:// 的 Uri。

modeFlags：前面提到的读写权限。

这种情况下，授权的有效期限，从授权一刻开始，截止于设备重启或者手动调用 Context.revokeUriPermission() 方法，才会收回对此 Uri 的授权

配合 Intent.addFlags() 授权。
既然这是一个 Intent 的 Flag，Intent 也提供了另外一种比较方便的授权方式，那就是使用 Intent.setFlags() 或者 Intent.addFlag 的方式
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

Intent.addFlags() 的方式，一旦授权将无法主动回收

拥有了授权权限的 content:// 的 Uri 之后，就可以通过 startXxx 或者 setResult() 的方式，将 Uri 传递给其他的 App

简单例子：

String path = Environment.getExternalStorageDirectory().getAbsolutePath()
                + File.separator +“ImageDir / img.png”
        File imgFile = new File(path);
        if (!imgFile.getParentFile().exists())
            imgFile.getParentFile().mkdirs();
        if (null != imgFile) {
            Uri photoUri;
            Intent takePhotoIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
            takePhotoIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);

            if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.M) {
                photoUri = Uri.fromFile(imgFile);
            } else {
                /**
                 * 7.0 调用系统相机拍照不再允许使用Uri方式，应该替换为FileProvider
                 * 并且这样可以解决MIUI系统上拍照返回size为0的情况
                 */
                photoUri = FileProvider.getUriForFile(context, context.getPackageName() + ".provider", imgFile);
            }
            takePhotoIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoUri);
            context.startActivityForResult(takePhotoIntent, REQUESTCODE);
        }

<paths>
  <external-path path="images/imghead/" name="photos" />
</paths>

external-path中的name表示什么呢？

<provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="${applicationid}.fileprovider"
            android:grantUriPermissions="true"
            android:exported="false">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/filepaths" />
        </provider>

如果：
Environment.getExternalStorageDirectory() 等于 “/storage/emulated/0”

android系统 会把/storage/emulated/0/images/imghead/
映射到content://（authorities字段的值）/name/

假如:
（authorities字段的值） = “com.android.www”
name = photos
拼接起来：content://com.android.www/photos/

如果发现有错，望告知！！！！