如何兼容所有Android版本选择照片或拍照然后裁剪图片--基于FileProvider和动态权限的实现

我们知道, Android操作系统一直在进化. 虽然说系统是越来越安全, 可靠, 但是对于开发者而言, 开发难度是越来越大的, 需要注意的兼容性问题, 也越来越多. 就比如在Android平台上拍照或者选择照片之后裁剪图片, 原本不需要考虑权限是否授予, 存储空间的访问安全性等问题. 比如, 在Android 6.0之后, 一些危险的权限诸如相机, 电话, 短信, 定位等, 都需要开发者主动向用户申请该权限才可以使用, 不像以前那样, 在AndroidManifest.xml里面配置一下即可. 再比如, 在Android 7.0之后, FileProvider的出现, 要求开发者需要手动授予访问本应用内部File, Uri等涉及到存储空间的Intent读取的权限, 这样外部的应用(比如相机, 文件选择器, 下载管理器等)才允许访问.

最近在公司的项目中, 又遇到了要求拍照或者选择图片, 裁减后上传到服务器的需求. 所以就怀着使后来人少踩坑的美好想象, 把这部分工程中大家可能都会遇到的共同问题, 给出一个比较合理通用的解决方案.

好, 下面我们就正式开始吧!

1, 在AndroidManifest.xml配置文件中, 添加对相机权限的使用:

 <uses-permission android:name="android.permission.CAMERA" /> 

2, 声明本应用对FileProvider使用, 在<application>里面添加元素<provider>:

    <application
        android:name=".MyApplication"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:largeHeap="true"
        android:theme="@style/QxfActionBarTheme"
        tools:replace="android:icon">
        //....

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

3, 在res目录下创建xml文件夹, 然后在其内容创建文件file_path.xml文件, 这里对你的文件的位置, 进行了定义: 

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-path
        name="Download"
        path="." />
</paths>

4, 创建IntentUtil.java文件, 用于获取调用相机, 选择图片, 裁减图片的Intent: 

    public static Intent getIntentOfTakingPhoto(@NonNull Context context, @NonNull Uri photoUri) {
        Intent takingPhotoIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
        takingPhotoIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoUri);
        grantIntentAccessUriPermission(context, takingPhotoIntent, photoUri);
        return takingPhotoIntent;
    }

    public static Intent getIntentOfPickingPicture() {
        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
        intent.setType("image/*");
        return intent;
    }

    public static Intent getIntentOfCroppingImage(@NonNull Context context, @NonNull Uri imageUri) {
        Intent croppingImageIntent = new Intent("com.android.camera.action.CROP");
        croppingImageIntent.setDataAndType(imageUri, "image/*");
        croppingImageIntent.putExtra("crop", "true");
        //crop into circle image
//        croppingImageIntent.putExtra("circleCrop", "true");
        //The proportion of the crop box is 1:1
        croppingImageIntent.putExtra("aspectX", 1);
        croppingImageIntent.putExtra("aspectY", 1);
        //Crop the output image size
        croppingImageIntent.putExtra("outputX", 256);//输出的最终图片文件的尺寸, 单位是pixel
        croppingImageIntent.putExtra("outputY", 256);
        //scale selected content
        croppingImageIntent.putExtra("scale", true);
        //image type
        croppingImageIntent.putExtra("outputFormat", "JPEG");
        croppingImageIntent.putExtra("noFaceDetection", true);
        //false - don't return uri |  true - return uri
        croppingImageIntent.putExtra("return-data", true);//
        croppingImageIntent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);
        grantIntentAccessUriPermission(context, croppingImageIntent, imageUri);
        return croppingImageIntent;
    }

5, 在IntentUtil.java文件定义grantIntentAccessUriPermission(...)方法, 用于向访问相机, 裁减图片的Intent授予对本应用内容File和Uri读取的权限:

    private static void grantIntentAccessUriPermission(@NonNull Context context, @NonNull Intent intent, @NonNull Uri uri) {
        if (!Util.requireSDKInt(Build.VERSION_CODES.N)) {//in pre-N devices, manually grant uri permission.
            List<ResolveInfo> resInfoList = context.getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
            for (ResolveInfo resolveInfo : resInfoList) {
                String packageName = resolveInfo.activityInfo.packageName;
                context.grantUriPermission(packageName, uri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION);
            }
        } else {
            intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
            intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
        }
    }

当然, 需要指出的是: 通过向Intent添加flag的方法, 即intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)和intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION)适用于所有的Android版本, 除了Android 4.4. 在Android 4.4中需要手动的添加两个权限, 即

            List<ResolveInfo> resInfoList = context.getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
            for (ResolveInfo resolveInfo : resInfoList) {
                String packageName = resolveInfo.activityInfo.packageName;
                context.grantUriPermission(packageName, uri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION);
            }

当然, 手动地添加读写权限同样适用于所有版本, 只不过通过向Intent添加flag的方法更加轻松, 更加简单而已. 如果你的应用最低版本高于Android 4.4, 则只使用添加flag的方法就行了.

6, 在需要使用相机, 选择图片, 裁减图片的Activity里面, 定义变量File(输出文件的具体位置)和Uri(包含文件的相关信息并供Intent使用): 

 private File avatarFile; 2 private Uri avatarUri; 

7, 在使用相机的时候, 有如下逻辑: 开启相机前, 判断一下是否已经取得了相机的权限: a, 如果用户已经授予应用访问相机的权限, 则直接去开启相机. b, 如果用户没有授予相机的权限, 则主动向用户去请求. 在接收到授予权限的结果时, 如果用户授予了相机权限, 则直接打开相机. 如果用户拒绝了, 则给予相应的提示或者操作. c, 如果用户连续向该权限申请拒绝了两次, 即, 系统已经对相机权限的申请直接进行了拒绝, 不再向用户弹出授予权限的对话框, 则直接提示用户该权限已经被系统拒绝, 需要手动开启, 并直接跳转到相应的权限管理系统页面. 当然, 动态权限仅限于Android 6.0+使用.

8, 使用相机: 

    @Override
    public void onCameraSelected() {
        if (Util.checkPermissionGranted(this, Manifest.permission.CAMERA)) {//如果已经授予相机相关权限
            openCamera();
        } else {//如果相机权限并未被授予, 主动向用户请求该权限
            if (Util.requireSDKInt(Build.VERSION_CODES.M)) {//Android 6.0+时, 动态申请权限
                requestPermissions(new String[]{Manifest.permission.CAMERA}, REQUEST_PERMISSION);
            } else {
                IntentUtil.openAppPermissionPage(this);
            }
        }
    }

9, 对动态申请权限的结果进行处理, 具体代码如下: 

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        switch (requestCode) {
            case REQUEST_PERMISSION:
                // If request is cancelled, the result arrays are empty.
                if (grantResults.length > 0
                        && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    openCamera();
                } else {
                    // permission denied, boo! Disable the
                    // functionality that depends on this permission.
                    showPermissionDeniedDialog();
                }
                break;
        }
    }

上述代码的逻辑是: 如果用户授予了权限, 则直接打开相机, 如果没有, 则显示一个权限被拒绝的对话框.

10, 选择图片: 这个Intent不需要授予读写权限, 注意一下:

    @Override
    public void onGallerySelected() {
        Intent pickingPictureIntent = IntentUtil.getIntentOfPickingPicture();
        if (pickingPictureIntent.resolveActivity(getPackageManager()) != null) {
            startActivityForResult(pickingPictureIntent, REQUEST_PICK_PICTURE);
        }
    }

11, 覆盖onActivityResult(...)方法, 对拍照和选择图片的结果进行处理, 然后进行裁减.

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (resultCode == Activity.RESULT_OK) {
            if (requestCode == REQUEST_TAKE_PHOTO) {
                avatarUri = UriUtil.getUriFromFileProvider(avatarFile);
                cropImage(avatarUri);
            } else if (requestCode == REQUEST_PICK_PICTURE) {
                if (data != null && data.getData() != null) {
                    avatarFile = FileFactory.createTempImageFile(this);
                    /*
                     * Uri(data.getData()) from Intent(data) is not provided by our own FileProvider,
                     * so we can't grant it the permission of read and write programmatically
                     * through {@link IntentUtil#grantIntentAccessUriPermission(Context, Intent, Uri)},
                     * So we have to copy to our own Uri with permission of write and read granted
                    */
                    avatarUri = UriUtil.copy(this, data.getData(), avatarFile);
                    cropImage(avatarUri);
                }
            } else if (requestCode == REQUEST_CROP_IMAGE) {
                mAvatar.setImageURI(avatarUri);
                uploadAvatar();
            }
        } else {
            // nothing to do here
        }
    }

12, 对图片进行裁减.

    private void cropImage(Uri uri) {
        Intent croppingImageIntent = IntentUtil.getIntentOfCroppingImage(this, uri);
        if (croppingImageIntent.resolveActivity(getPackageManager()) != null) {
            startActivityForResult(croppingImageIntent, REQUEST_CROP_IMAGE);
        }
    }

对裁减的结果进行处理, 代码在(11)里面.

13, 最后再补充一下上述代码使用到的FileFactory.java和UriUtil.java两个文件里面的一些方法.

FileFactory.java: 

public class FileFactory {
    private FileFactory() {
    }

    private static String createImageFileName() {
        String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
        String imageFileName = "JPEG_" + timeStamp + "_";
        return imageFileName;
    }

    public static File createTempImageFile(@NonNull Context context) {
        try {
            File storageDir = context.getExternalFilesDir(Environment.DIRECTORY_PICTURES);
            File image = File.createTempFile(
                    FileFactory.createImageFileName(),  /* prefix */
                    ".jpeg",         /* suffix */
                    storageDir      /* directory */
            );
            return image;
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }

    public static File createImageFile(@NonNull Context context, @NonNull String fileName) {
        try {
            if (TextUtils.isEmpty(fileName)) {
                fileName = "0000";
            }
            File storageDir = context.getExternalFilesDir(Environment.DIRECTORY_PICTURES);
            File image = new File(storageDir, fileName + ".jpeg");
            if (!image.exists()) {
                image.createNewFile();
            } else {
                image.delete();
                image.createNewFile();
            }
            return image;
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }

    public static byte[] readBytesFromFile(@NonNull File file) {
        try (InputStream inputStream = new FileInputStream(file)) {
            byte[] bytes = new byte[inputStream.available()];
            inputStream.read(bytes);
            return bytes;
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }
}

UriUtil.java: 

public class UriUtil {
    private UriUtil() {
    }

    public static Uri getUriFromFileProvider(@NonNull File file) {
        return FileProvider.getUriForFile(QxfApplication.getInstance(),
                BuildConfig.APPLICATION_ID + ".file_provider",
                file);
    }

    public static Uri copy(@NonNull Context context, @NonNull Uri fromUri, @NonNull File toFile) {
        try (FileChannel source = ((FileInputStream) context.getContentResolver().openInputStream(fromUri)).getChannel();
             FileChannel destination = new FileOutputStream(toFile).getChannel()) {
            if (source != null && destination != null) {
                destination.transferFrom(source, 0, source.size());
                return UriUtil.getUriFromFileProvider(toFile);
            }
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }
}

最后再添加两个方法, requireSDKInt(int)和checkPermissionGranted(context, permission), 分别用于判断是否要求最低Android版本是多少和检测某个权限是否已经被用户授予.

    public static boolean requireSDKInt(int sdkInt) {
        return Build.VERSION.SDK_INT >= sdkInt;
    }

    public static boolean checkPermissionGranted(Context context, String permission) {
        return PermissionChecker.checkSelfPermission(context, permission) == PackageManager.PERMISSION_GRANTED;
    }

最后, 先拍照或者选择图片, 然后对结果进行图片的裁减, 兼容了所有Android版本的方式已经介绍完了, 无论是Android 6.0中动态权限的申请和Android 7.0中对存储空间的限制, 都已经进行了处理, 而且测试通过.

大家有什么问题, 可以在评论里面问我. 谢谢~