今天给大家介绍一个仿微信的图片选择器: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的项目地址
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持找一找教程网。