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.PreviewActivity"
    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 实现一个仿微信的图片选择器