Android仿微信图片选择器ImageSelector使用详解

今天给大家介绍一个仿微信的图片选择器：ImageSelector。ImageSelector支持图片的单选、限数量的多选和不限数量的多选。支持图片预览和图片文件夹的切换。在上一篇文章 《Android 实现一个仿微信的图片选择器》 中我介绍了ImageSelector的实现思路和分析了它的核心代码，有兴趣的同学可以看一下。完整的代码放在了GitHub，欢迎大家下载和使用。本篇文章为大家介绍ImageSelector的具体使用方式。

先上效果图：

1、引入依赖

在Project的build.gradle在添加以下代码

 allprojects {
 repositories {
  ...
  maven { url 'https://jitpack.io' }
 }
 }

在Module的build.gradle在添加以下代码

compile 'com.github.donkingliang:ImageSelector:1.2.0'

2、配置AndroidManifest.xml

//储存卡的读取权限
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

//图片选择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" />

3、调起图片选择器

ImageSelector支持图片的单选、限数量的多选和不限数量的多选。在调起图片选择器的时候需要告诉选择器，是那种情况。为了方便大家的使用，我在项目中提供了一个工具类，可以方便地调起选择器。

 /**
 * 打开相册，选择图片,可多选,不限数量。
 *
 * @param activity
 * @param requestCode
 */
 public static void openPhoto(Activity activity, int requestCode) {
 openPhoto(activity, requestCode, false, 0);
 }

 /**
 * 打开相册，选择图片,可多选,限制最大的选择数量。
 *
 * @param activity
 * @param requestCode
 * @param isSingle 是否单选
 * @param maxSelectCount 图片的最大选择数量，小于等于0时，不限数量，isSingle为false时才有用。
 */
 public static void openPhoto(Activity activity, int requestCode,
     boolean isSingle, int maxSelectCount) {
 ImageSelectorActivity.openActivity(activity, requestCode, isSingle, maxSelectCount);

 /**
 * 打开相册，单选图片并剪裁。
 *
 * @param activity
 * @param requestCode
 */
 public static void openPhotoAndClip(Activity activity, int requestCode) {
 ClipImageActivity.openActivity(activity, requestCode);
 }

工具类里只有简单的两个方法，至于里面的实现逻辑就直接交给了ImageSelectorActivity自己处理，调用者无需关心。调起选择器只需要简单的一句代码就可以了。

 //单选
 ImageSelectorUtils.openPhoto(MainActivity.this, REQUEST_CODE, true, 0);

//限数量的多选(比喻最多9张)
ImageSelectorUtils.openPhoto(MainActivity.this, REQUEST_CODE, false, 9);

//不限数量的多选
ImageSelectorUtils.openPhoto(MainActivity.this, REQUEST_CODE);
//或者
ImageSelectorUtils.openPhoto(MainActivity.this, REQUEST_CODE, false, 0);

//单选并剪裁
ImageSelectorUtils.openPhotoAndClip(MainActivity.this, REQUEST_CODE);

REQUEST_CODE就是调用者自己定义的启动Activity时的requestCode，这个相信大家都能明白。

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(
  ImageSelectorUtils.SELECT_RESULT);
 }
 }

ImageSelectorUtils.SELECT_RESULT是接收数据的key。数据是以ArrayList的字符串数组返回的，就算是单选，返回的也是ArrayList数组，只不过这时候ArrayList只有一条数据而已。ArrayList里面的数据就是选中的图片的文件路径。

ImageSelector的使用就介绍到这里了。

最后给出ImageSelector的项目地址

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。

您可能感兴趣的文章:

• Android实现微信的图片选择器
• Android仿微信朋友圈图片选择器
• Android图片选择器ImageEditContainer
• Android仿微信图片选择器
• Android 高仿QQ图片选择器
• Android图片选择器 丰富的配置选项
• 浅谈谈Android 图片选择器
• Android自定义图片选择器简单版