Android 7.0相机适配及FileProvider重复那些坑

2021-12-01 22:11:12

本文首发于公众号“AntDream”，欢迎微信搜索“AntDream”或扫描文章底部二维码关注，和我一起每天进步一点点

Android 7.0相机拍照适配

（1）首先必须获取拍照的权限

简单一点的可以直接用ActivityCompat的requestPermissions方法

ActivityCompat.requestPermissions(context,
                        new String[]{permission},
                        requestCode);

权限请求的结果会在onRequestPermissionsResult中回调

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    switch (requestCode) {
        case 1://对应requestPermissions的requestCode
            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {//如果一次申请多个权限，就按顺序依次grantResults[1]、grantResults[2]判断
                Toasts.showShort("再次点击即可拍照");
            } else {
                // Permission Denied
            }
            break;
    }
}

（2）调用相机拍照

Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
UUID uuid = UUID.randomUUID();
File file = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM), uuid.toString() + ".jpeg");//拍照文件的路径
//判断是否是AndroidN以及更高的版本
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
    Uri uri = FileProvider.getUriForFile(getContext(), BuildConfig.APPLICATION_ID + ".fileProvider", file);
    intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
} else {
    Uri uri = Uri.fromFile(file);
    intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
}
startActivityForResult(intent, requestCode);

主要的适配就是Android 7.0以上发起调用的Uri必须通过FileProvider来获取，也就是下面这句：

Uri uri = FileProvider.getUriForFile(getContext(), BuildConfig.APPLICATION_ID + ".fileProvider", file);

FileProvider的getUriForFile方法有三个参数：

第一个参数为Context，这个好理解
第二个参数为FileProvider的签名，也就是一个唯一标识，这个一个应用里面必须是唯一的，否则会有问题，后面会单独讲。一般为包名+自定义的标识，这个必须和AndroidManifest中配置的Provider的authorities属性一致
第三个参数也好立即，就是拍照将要生成的文件了

所以我们还需要对FileProvider进行特别的处理

（3）在AndroidManifest文件中注册FileProvider

<!--Android N 相机-->
<provider
    android:name=".provider.MyFileProvider"
    android:authorities="${applicationId}.myfileprovider"//这里表示授权信息
    android:grantUriPermissions="true"//必须为true，表示同意权限
    android:exported="false">//必须为false，否则会报错
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

name属性为FileProvider的路径
authorities为授权的签名，一般为包名+自定义的标识，与生成的Uri的第二个参数对应
grantUriPermissions属性必须为true
exported必须为false
meta-data中的resource属性必须配置，为共享的文件路径，也就是系统相机应用和我们的应用共享的文件路径

（4）创建上面配置的`file_paths`共享文件配置

文件内容就是指定的共享路径了

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="external_files" path="."/>
</paths>

（5）最后在onActivityResult中接收照片

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    //拍照成功以后
    if (resultCode == RESULT_OK) {
        switch (requestCode) {
            case FROM_CAMERA:
                //做照片的处理
                ...
        }
    } else {
        ToastUtil.shortToast(this, R.string.cancel);
    }

}

适配需要注意的坑

（1）FileProvider路径不一致

这里要特别注意上面获取Uri时的第二个参数，也就是包名+自定义的标识必须和AndroidManifest文件中配置的一致
第二个就比较坑了，如果是模块化开发，需要特别注意包名的一致

再来看看那句代码：

Uri uri = FileProvider.getUriForFile(getContext(), BuildConfig.APPLICATION_ID + ".fileProvider", file);

坑就在BuildConfig.APPLICATION_ID这里，如果用BuildConfig来获取APPLICATION_ID，在模块化开发中就会出现不一致的情况。比如打开相机的模块是camera，我们应用的包名是com.my.app，那么BuildConfig.APPLICATION_ID的值就不一样了：

camera模块：com.my.app.camera

我们app：com.my.app

这样导致的后果就是导调用相机的时候闪退，并且每次通过IDE安装应用的时候都会弹出下面的提示要重新安装App：

正确的姿势是用getPackageName()的方式获取，也就是改成下面这样：

Uri uri = FileProvider.getUriForFile(mContext, mContext.getPackageName() + ".myfileprovider", file);

（2）FileProvider重复

这个也出现在模块话开发中，或是引用的三方库中也定义了FileProvider，就会报FileProvider重复的错误。

Attribute provider#android.support.v4.content.FileProvider@authorities value=(***.fileProvider) from AndroidManifest.xml:352:13-62 is also present at ...

解决方法也很简单，就是定义一个我们自己的FileProvider：

public class MyFileProvider extends FileProvider {
}

是的，其他什么也不用干，直接继承FileProvider创建一个自己的FileProvider就好

然后，AndroidManifest文件中定义的FileProvider的name属性改成上面的MyFileProvider的路径就好

<provider
    android:name=".xtreme.provider.MyFileProvider" //自定义的FileProvider的路径
    android:authorities="${applicationId}.myfileprovider"
    android:grantUriPermissions="true"
    android:exported="false">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

码农公寓