Android借助系统自带图片裁剪集成图片选择以及7.0适配

一、前文

  之前使用的图片裁剪功能一直是使用第三方的，也没时间去思考自己写一个的想法。后来无意间发现android自己本来就有裁剪功能，所以自己动手去集成了一把，并且把自己的权限封装以及7.0的适配都加进去

二、注意的几个点

  其实也没有什么好说的，基本没有难度，只是有几个需要注意的点
1.一个是7.0的文件安全机制，7.0之后android对于文件的安全增加了保护，在部分地方使用Uri会产生FileUriExposedException文件暴露异常。
2.其次，就是对于权限的封装，只有拿到了权限才能进行操作，做好权限适配，这些下面会一并讲到。

三、权限封装

  权限封装最好封装到一个方法里面，独立处理权限，这样也可以比较轻松的集成在BaseActivity里面，在用的地方直接调，可以达到权限随用随取得效果。先看看关键代码

      public void needPermission(AppPermissionListener mAppPermissionListener, List permissions) {
        if (null != permissions && permissions.size() > 0) {
            this.appPermissionListener = mAppPermissionListener;
            this.allPermission = permissions;
            // 允许的权限
            allowPermission.clear();
            // 被拒绝的权限
            deniedPermission.clear();
            // 不在询问的权限
            neverAskPermission.clear();
            // 开始遍历拿到的权限
            Observable.fromIterable(allPermission)
                    .subscribe(new Consumer() {
                        @Override
                        public void accept(String s) throws Exception {
                            // 判断是否有WRITE_SETTINGS特殊权限
                            if (s.equals(Manifest.permission.WRITE_SETTINGS)) {
                                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                                    // WRITE_SETTINGS需要用该方式判断
                                    if (!Settings.System.canWrite(mActivity))
                                        allowPermission.add(s);
                                    else
                                        haveWriteSetting = true;
                                }
                            } else if (ActivityCompat.checkSelfPermission(mActivity, s)         
                            == PackageManager.PERMISSION_GRANTED) {
                                allowPermission.add(s);
                            } else {
                                deniedPermission.add(s);
                            }
                        }
                    });
            if (haveWriteSetting) {
                // 请求特殊权限
                requestWriteSettings();
                return;
            }
            if (!deniedPermission.isEmpty()) {
                String[] tempArray = new String[deniedPermission.size()];
                deniedPermission.toArray(tempArray);
                requestPermissions(tempArray);
                if (null != mAppPermissionListener) {
                    mAppPermissionListener.onHaveDenied(deniedPermission);
                }
                return;
            }
            if (!neverAskPermission.isEmpty()) {
                showNeverAskDialog();
                if (null != mAppPermissionListener) {
                    mAppPermissionListener.onNeverAsk(neverAskPermission);
                }
                return;
            }
            // 权限通过，回调onAllGranted方法
            if (null != mAppPermissionListener) {
                mAppPermissionListener.onAllGranted();
            }
        }
    }

android有两个特殊权限，一个是WRITE_SETTINGS，另外一个是SYSTEM_ALERT_WINDOW，这里只对WRITE_SETTINGS做了处理，我在想有没有更优雅的方法把SYSTEM_ALERT_WINDOW加进去，所以后面会完善。
  在这里处理了会触发拒绝权限的弹框。但是当用户点击了不再询问权限，就不会再弹框。android原生给我们提供了shouldShowRequestPermissionRationale()方法来判断是否不再弹框。但是 这个方法会在部分手机上失效，比如我手中的魅族pro6手机，可能由于ROM问题，在调用该方法的时候就是失效的。那么，我们可以用另外一种方法来达到相同的目的。
  我们可以直接调用requestPermissions方法，在onRequestPermissionsResult的权限回调方法中进行检查，如果拒绝权限列表中还有这个权限的话，就可以进行弹框引导用户去设置中手动打开。不但替代了shouldShowRequestPermissionRationale方法，而且在用户一通拒绝之后还能给予提醒。下面是onRequestPermissionsResult方法的代码

 // 权限返回结果
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        if (requestCode == PERMISSION_REQUEST_CODE) {
            for (int i = 0; i < permissions.length; i++) {
                String per = permissions[i];
                if (grantResults[i] == PackageManager.PERMISSION_GRANTED) {
                    if (deniedPermission.contains(per)) {
                        deniedPermission.remove(per);
                    } else if (neverAskPermission.contains(per)) {
                        neverAskPermission.remove(per);
                    }
                    if (!allowPermission.contains(per))
                        allowPermission.add(per);
                } else {
                    if (deniedPermission.contains(per)) {
                        deniedPermission.remove(per);
                        neverAskPermission.add(per);
                    }
                }
            }
            if (!deniedPermission.isEmpty()) {
                neverAskPermission.addAll(new ArrayList<>(deniedPermission));
                deniedPermission.clear();
            }
            if (!neverAskPermission.isEmpty()) {
                showNeverAskDialog();
                if (null != appPermissionListener) {
                    appPermissionListener.onNeverAsk(neverAskPermission);
                }
                return;
            }
            if (null != appPermissionListener) {
                appPermissionListener.onAllGranted();
            }
        }
    }

四、7.0文件安全机制

  不少安卓应用开发的程序员，一直都很少有机会接触到安卓四大组件之一的Content Provider，但是由于android7.0文件安全机制的限制，使我们不得不去接触这个组件。我个人觉得这也是一件好事情。不用再只局限于部分组件的开发。
  首先我们需要在res文件下简历一个xml文件夹，然后再建立一个xml文件，这个xml文件名字自己可以随便命名，这里我命名为file_path。如下图所示

  file_path里面的内容有事有讲究的。里面有一个root-path 节点，虽说android会提示element roo-path is not allowed here。但是我目前还没有找到在不用这个节点的时候，能够正常运行的手段。如果有哪位大神知道，可以指出。

<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <files-path
        name="my_images"
        path="path/" />
    <cache-path
        name="my_cache"
        path="path/" />
    <external-files-path
        name="my_file"
        path="path/" />
    <external-path
        name="myApp_file"
        path="path/" />
    <external-cache-path
        name="myApp_cache"
        path="path/" />
    <root-path name="myApp"
        path="" />
paths>

然后，我们需要建立一个自己的provider。这样在问题出现的时候有利于查找问题。最后，我们需要在Manifest里面声名这个Provdier。如下所示

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

这里使用了${applicationId}来代替包名很方便，但是在java代码中还是需要写完全。
接下来说使用。使用起来就会变得很简单，一句代码就可以了

FileProvider.getUriForFile(context, DEFAULT_AUTHORITIES, imageFile)

这个方法会返回Uri对象，在需要的地方进行使用。

五、如何调用相机、图库以及裁剪工具

相机和图库的调用，网上其实已经在很多地方写烂了，我这里直接贴出我的方法

    /**
     * 打开图库
     */
    private void openGallery() {
        initImageFile();
        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
        intent.setType("image/*");
        ((Activity) context).startActivityForResult(intent, REQUEST_PICK);
    }

    /**
     * 开启摄像头
     */
    private void doPhoto() {
        initImageFile();
        Uri uri = FileProvider.getUriForFile(context, DEFAULT_AUTHORITIES, imageFile);
        Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
        intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
        intent.putExtra(MediaStore.EXTRA_SCREEN_ORIENTATION, 
            ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
        ((Activity) context).startActivityForResult(intent, REQUEST_PICK);
    }

接下来，在打开系统自带裁剪工具的时候会有个坑，也是android 7.0的文件安全机制的问题。不过这个和之前的文件安全机制不一样。使用FileProvider会提示”无法加载该图片”。通过找到该图片路径可以了解到，android7.0的文件安全机制其实是希望能做成类似IOS沙盒机制的效果，每个app只能访问自己的沙盒，但是从系统相册拿到的图片却不属于当前app本身，所以我们这时候就需要一个临时授权。intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
调用系统裁剪功能的代码如下

    private void beginCropDirect(Uri uri) {
        Intent intent = new Intent("com.android.camera.action.CROP");
        //添加这一句表示对目标应用临时授权该Uri所代表的文件
        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
        //可以选择图片类型，如果是*表明所有类型的图片
        intent.setDataAndType(uri, "image/*");
        // 下面这个crop = true是设置在开启的Intent中设置显示的VIEW可裁剪
        intent.putExtra("crop", "true");
        // aspectX aspectY 是宽高的比例，这里设置的是正方形（长宽比为1:1）
        intent.putExtra("aspectX", 1);
        intent.putExtra("aspectY", 1);
        // outputX outputY 是裁剪图片宽高
        intent.putExtra("outputX", 500);
        intent.putExtra("outputY", 500);
        intent.putExtra("outputFormat", Bitmap.CompressFormat.JPEG.toString());
        //是否将数据保留在Bitmap中返回,true返回bitmap，false返回uri
        intent.putExtra("return-data", false);
        ((Activity) context).startActivityForResult(intent, REQUEST_CROP);
    }

本文代码:https://github.com/Kongdy/ImageCropBySystem
个人github地址:https://github.com/Kongdy
个人掘金主页:https://juejin.im/user/595a64def265da6c2153545b
csdn主页:http://blog.csdn.net/qq_24859309