在ImageSelector项目基础上做了扩展，增加了音频、视频、普通文件的选择器。原来使用的是另一个，来自项目：https://github.com/fishwjy/MultiType-FilePicker ，但这个有段时间没有维护了，界面设计上关于目录的部分也不理想，自己修修补补很多次，对Android10的支持有问题（不记得自己得到的版本时间了，现在的这个有没有改善）。既然要处理Android10支持，干脆就自己扩展一个出来吧。这个MultiSelector参考了部分filepicker的设计，感谢！
大部分接口延续imageselector，在start部分，增加了类型参数： //多选(最多9张) MultiSelector.builder() .useCamera(true) // 设置是否使用拍照 .setSingle(false) //设置是否单选 .canPreview(true) //是否点击放大图片查看,，默认为true .setMaxSelectCount(9) // 图片的最大选择数量，小于等于0时，不限数量。 .setFileType(DocumentModel.FILE_TYPE_DOCUMENT) // MultiSelector.SELECT_TYPE_DOCUMENT 有效 .setSuffix("doc,xls") // MultiSelector.SELECT_TYPE_DOCUMENT 有效 //.start(this, MultiSelector.SELECT_TYPE_IMAGE, REQUEST_CODE); // 打开相册 //.start(this, MultiSelector.SELECT_TYPE_VIDEO, REQUEST_CODE); // 视频选择 .start(this, MultiSelector.SELECT_TYPE_DOCUMENT, REQUEST_CODE);//文档选择 //.start(this, MultiSelector.SELECT_TYPE_AUDIO, REQUEST_CODE);// 音频选择
关于文档选择，有两个特有配置量，其他选择器忽略此配置： MultiSelector.builder() .setFileType(DocumentModel.FILE_TYPE_DOCUMENT) // 文件选择大类型，有FILE_TYPE_ALL 全部类型，FILE_TYPE_DOCUMENT 文档类型（30以下设置为doc、docx、xls、xlsx、ppt、pptx、pdf、txt）,FILE_TYPE_CUSTOM 自定义（具体类型根据suffix确定）,FILE_TYPE_NONE 非媒体类型（音视频、图片之外），四个选项 .setSuffix("doc,xls") // 只在fileType设置为FILE_TYPE_CUSTOM时起作用，指定一个或多个后缀名
图片预览没有做任何改变，依然使用imageselector的方式；图片之外预览的处理，考虑轻量化因素，没加入自带的音视频播放和文件预览功能，如果打开预览配置，并且未通过接口自定义预览处理的话，将直接通过Intent.ACTION_VIEW抛给默认处理程序处理；以下为设置预览处理接口： MultiSelector.builder() .setPreviewListener(new FilePreviewListener(){ @Override public void onPreview(Context context, FileData fileData){ // 自己调用合适的Activity或者别的Intent实现自定义预览 } })
从兼容与沿革的方向考虑，目前除了有冲突的地方，其他的imageselector的部分没做任何改变，也没与其他Activity和Model等做代码同步，保持独立。
Android图片选择器，仿微信的图片选择器的样式和效果。支持图片的单选、限数量的多选和不限数量的多选。支持图片预览和图片文件夹的切换。支持在选择图片时调用相机拍照，也支持不用打开相册直接调用相机拍照。
先上效果图：
1、引入依赖
在Project的build.gradle在添加以下代码
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
在Module的build.gradle在添加以下代码
implementation 'com.github.donkingliang:ImageSelector:2.2.1'
从2.0.0版本开始，库迁移androidx。没有使用androidx的项目可以使用1.9.3版本。
2、配置AndroidManifest.xml
注意： 1.7.0版本后，不需要再配置FileProvider，ImageSelector内部已经配置了。
//储存卡的读写权限
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
//调用相机权限
<uses-permission android:name="android.permission.CAMERA" />
//图片选择Activity
<activity android:name="com.donkingliang.imageselector.ImageSelectorActivity"
//去掉Activity的ActionBar。
//使用者可以根据自己的项目去配置，不一定要这样写，只要让Activity的ActionBar去掉就可以了。
android:theme="@style/Theme.AppCompat.Light.NoActionBar"
//横竖屏切换处理。
//如果要支持横竖屏切换，一定要加上这句，否则在切换横竖屏的时候会发生异常。
android:configChanges="orientation|keyboardHidden|screenSize"/>
//图片预览Activity
<activity android:name="com.donkingliang.imageselector.ImagePreviewActivity"
android:theme="@style/Theme.AppCompat.Light.NoActionBar"
android:configChanges="orientation|keyboardHidden|screenSize"/>
//图片剪切Activity
<activity
android:name="com.donkingliang.imageselector.ClipImageActivity"
android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
<!-- Android 7.0 文件共享配置，1.7.0之前必须配置，1.7.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/file_paths" />
</provider>在res/xml文件夹下创建file_paths.xml文件(名字可以自己定义)
<?xml version="1.0" encoding="utf-8"?>
<paths>
<!-- 这个是保存拍照图片的路径,必须配置。 -->
<external-path
name="images"
path="Pictures" />
</paths>3、调起图片选择器
ImageSelector支持图片的单选、限数量的多选和不限数量的多选。还可以设置是否使用相机、是否剪切图片等配置。ImageSelector提供了统一的调起相册的方法。
//单选
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(true) //设置是否单选
.canPreview(true) //是否可以预览图片，默认为true
.start(this, REQUEST_CODE); // 打开相册
//限数量的多选(比如最多9张)
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(false) //设置是否单选
.setMaxSelectCount(9) // 图片的最大选择数量，小于等于0时，不限数量。
.setSelected(selected) // 把已选的图片传入默认选中。
.canPreview(true) //是否可以预览图片，默认为true
.start(this, REQUEST_CODE); // 打开相册
//不限数量的多选
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(false) //设置是否单选
.setMaxSelectCount(0) // 图片的最大选择数量，小于等于0时，不限数量。
.setSelected(selected) // 把已选的图片传入默认选中。
.canPreview(true) //是否可以预览图片，默认为true
.start(this, REQUEST_CODE); // 打开相册
//单选并剪裁
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setCrop(true) // 设置是否使用图片剪切功能。
.setCropRatio(1.0f) // 图片剪切的宽高比,默认1.0f。宽固定为手机屏幕的宽。
.setSingle(true) //设置是否单选
.canPreview(true) //是否可以预览图片，默认为true
.start(this, REQUEST_CODE); // 打开相册
//仅拍照
ImageSelector.builder()
.onlyTakePhoto(true) // 仅拍照，不打开相册
.start(this, REQUEST_CODE);
//拍照并剪裁
ImageSelector.builder()
.setCrop(true) // 设置是否使用图片剪切功能。
.setCropRatio(1.0f) // 图片剪切的宽高比,默认1.0f。宽固定为手机屏幕的宽。
.onlyTakePhoto(true) // 仅拍照，不打开相册
.start(this, REQUEST_CODE);
REQUEST_CODE就是调用者自己定义的启动Activity时的requestCode，这个相信大家都能明白。selected可以在再次打开选择器时，把原来已经选择过的图片传入，使这些图片默认为选中状态。
如果是仅拍照模式(onlyTakePhoto = true)时，useCamera无论设置什么，都是为true。
4、接收选择器返回的数据
在Activity的onActivityResult方法中接收选择器返回的数据。
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == REQUEST_CODE && data != null) {
//获取选择器返回的数据
ArrayList<String> images = data.getStringArrayListExtra(
ImageSelector.SELECT_RESULT);
/**
* 是否是来自于相机拍照的图片，
* 只有本次调用相机拍出来的照片，返回时才为true。
* 当为true时，图片返回的结果有且只有一张图片。
*/
boolean isCameraImage = data.getBooleanExtra(ImageSelector.IS_CAMERA_IMAGE, false);
}
}ImageSelector.SELECT_RESULT是接收数据的key。数据是以ArrayList的字符串数组返回的，就算是单选，返回的也是ArrayList数组，只不过这时候ArrayList只有一条数据而已。ArrayList里面的数据就是选中的图片的文件路径。
适配android 10
兼容android 10的手机请使用1.7.0版本。
由于android 10不允许应用直接访问外部文件，所以在android 10及以上的手机，ImageSelect返回的图片链接可能无法直接加载,因为ImageSelector返回的是图片在手机里的地址。但是可以通过uri进行加载，ImageSelector内部提供了一些方法可以供外部使用，用于适配android 10。
如何在Android 10加载手机本地图片，请看我的这篇博客。
//是否是android 10及以上
VersionUtils.isAndroidQ();
// android 10可以通过图片uri加载手机本地图片。
//图片链接转uri
Uri uri = UriUtils.getImageContentUri(Context context, String path);
//通过uri加载图片
Glide.with(mContext).load(uri).into(ivImage);
ivImage.setImageURI(uri);
// 或者
Bitmap bitmap = ImageUtil.getBitmapFromUri(Context context, Uri uri);
注意： 剪切返回的图片的图片链接是放在应用的私有目录的，所以剪切返回的图片可以直接用path加载，不需要转成uri再加载。ImageSelector提供了判断图片链接是否是剪切的图片的方法。
// 是否是剪切返回的图片
ImageUtil.isCutImage(mContext, path);
图片预加载和缓存
由于从手机中加载图库是个耗时操作，图片太多时，打开图库可能等待时间过长，用户体验不好。所以在2.1.0版本和1.9.0版本开始，提供了预加载手机图片并缓存的功能。你可以在用户打开图片选择器前，预先加载手机图片，这样在用户打开图片选择器时，会直接从缓存中读取图片列表，大大提升选择器的加载速度。
选择器默认不开启预加载并缓存功能，如果需要预加载，请调用下面的方法：
ImageSelector.preload(context);调用这个方法的时机没有特殊的要求，只要是在打开选择器前调用就可以了。
注意： 由于加载手机图片需要申请WRITE_EXTERNAL_STORAGE权限，所以在调用该方法前，请确保权限已申请。
在选择器使用完毕，不再需要时，可以调用下面方法清空缓存：
ImageSelector.clearCache(context);清空缓存的操作不是必须的，如果不清空，缓存会一直保留，直到app被回收。因为缓存的是图片的路径，所以不会占用太多的内存。
版本节点
这里记录的是重要的版本更新节点，全部的版本及更新内容请看这里。
2.1.0版本&1.9.0版本
添加图片预加载和缓存功能。
2.0.0版本
迁移androidx。没有使用androidx的项目可以使用1.9.2版本。
1.8.0版本
1、添加直接打开相机拍照功能。
2、优化图片预览页，适配刘海屏。
1.7.0版本
1、适配android 10。
2、添加自定义FileProvider，从1.7.0开始，使用者不需要再配置FileProvider。
1.5.0版本
1、更新Glide版本到4.x。
2、修改targetSdkVersion为27。
ImageSelector从1.5.0版本开始使用了Glide 4.x的版本，由于Glide 3.x版本和4.x版本在使用上有所差异，如果你的项目使用了Glide 3.x版本，而又不想升级到4.x,那么你也可以使用ImageSelector:1.4.0版本，它和新的版本在使用和功能上都会有所差异。ImageSelector 1.4.0
想要了解ImageSelector的实现思路和核心代码的同学请看这里：Android 实现一个仿微信的图片选择器