前言

轻量级图片选择框架，多选，拍照，支持剪裁，自定义图片加载

图片选择框架其实已有许多优秀成熟的框架，比如知乎开源的 Matisse，遵循Google提倡的MaterialDesign ，感兴趣的朋友可以查看看下这篇文章，对Matisse的使用有一个粗略的认识。

简述

既然已经有了这么优化的框架为啥还要重复造轮子呢，估计很多读者都有这样的疑问，对于这个问题我想说以下几点。

我们去使用一个开源库，可能我们只需要当中的某一块功能，有一部分的功能其实我们是不需要的，但是因为某一个功能而去集成一个库，总感觉怪怪的。
使用一个开源库，那么对于这个库的的依赖性就比较强，如果作者停止维护，后期新增的需求该框架满足不了，如果引入的是源码，那还可以修改作者的源码，但是前期是得非常了解该框架的整体设计，逻辑等等。
个人认为以上两点其实都不是最重要的，我觉得最重要的是可以去学习这些优秀框架的设计思想，代码的健壮性，各种骚操作等等，可以增长自己的知识面，可以从中学习成长不少。

一、功能介绍

支持图片多选，直接拍照，图片剪裁，直接自定义图片加载。

二、使用介绍

整个框架的入口为PictureSelector，使用方法如下：

图片选择属性配置

            //图片选择全部功能
            PictureSelector.with(this)
                    .selectSpec() //图片选择属性配置
                    .setImageLoader(new GlideImageLoader()) //图片加载方案，默认提供了GlideImageLoader
                    .setSpanCount(3) //图片一行显示几张图片
                    .setOpenCamera() //开启系统拍照功能
                    .needCrop() //是否是否需要剪裁
                    .setOutputX(200) //设置图片剪裁的大小
                    .setOutputY(200) //设置图片剪裁的大小
                    .setAuthority("org.lym.picture.selector.fileprovider") //适配Android7.0系统拍照
                    .setMaxSelectImage(single ? 1 : 9) //设置图片多选
                    .startForResult(IMAGES_CODE); //开启图片选择

            //单选图片
            PictureSelector
                    .with(this)
                    .selectSpec()
                    .startForResult(IMAGES_CODE);

            //单选图片并开启剪裁并设置图片剪裁的大小
            PictureSelector
                    .with(this)
                    .selectSpec()
                    .needCrop()
                    .setOutputX(200)
                    .setOutputY(200)
                    .startForResult(IMAGES_CODE);

            //单选图片并开启相册拍照
            PictureSelector
                    .with(this)
                    .selectSpec()
                    .setOpenCamera()
                    //开启拍照功能一定得设置该属性，为了兼容Android7.0相机拍照问题
                    //在manifest文件中也需要注册该provider
                    .setAuthority("org.lym.picture.selector.fileprovider")
                    .startForResult(IMAGES_CODE);

            //图片多选
            PictureSelector.with(this)
                    .selectSpec()
                    .setOpenCamera()
                    .setMaxSelectImage(3)
                    .startForResult(IMAGES_CODE);

兼容Android7.0系统拍照FileProvider配置

        <!-- 兼容android7.0  需配置xml文件路径，可将该框架中的xml拷贝至你的项目下配置即可 -->
        <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="${applicationId}.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/external_path"/>
        </provider>

接收图片选择后的结果

      @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == IMAGES_CODE && resultCode == Activity.RESULT_OK) {
            if (null != data) {
                //图片单选和多选数据都是以ArrayList的字符串数组返回的。
                List<String> paths = PictureSelector.obtainPathResult(data);
                mResultAdapter.setNewData(paths);
            }
        }
    }

三、注意事项

使用该框架需要访问sdcard路径，那么你需要在你的manifest注册以下两个权限，如果在Android6.0之后使用的话，那么则需要动态申请一下权限，关于动态权限申请可以使用AndPermission，这里就不赘述了。

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

如果你需要使用拍照功能的话，那么一定得在manifest中声明一个FileProvider并配置name属性的路径，然后需要setAuthority该属性。

      <!-- 兼容android7.0 -->
        <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="${applicationId}.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/external_path"/>
        </provider>

图片加载策略，框架默认提供的是Glide，Glide版本为当前最新版本4.8.0，Glide在V4之后Api有所改变，详情请访问Glide官方文档，如果你的项目使用的不是Glide那么，也没关系，你只需要实现UIImageLoader然后通过setImageLoader设置即可。

结语

建议大家以源码的形式导入到你的项目中，这样你可以只提取你需要的功能，剔除对你无用的功能，也方便你的扩展，当然，你也可以在GitHub上提issues，(提了我也不改)，哈哈，开个玩笑，只要提了我都会尽我能力去解决的，欢迎大家start，fork。