前言
图片选择框架其实已有许多优秀成熟的框架，比如知乎开源的 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。
