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

PenYZQ 8年前
   <p>今天给大家介绍一个仿微信的图片选择器: <a href="/misc/goto?guid=4959748765044455329" rel="nofollow,noindex">ImageSelector</a> 。ImageSelector支持图片的单选、限数量的多选和不限数量的多选。支持图片预览和图片文件夹的切换。在上一篇文章 <a href="/misc/goto?guid=4959748765143693721" rel="nofollow,noindex">《Android 实现一个仿微信的图片选择器》</a> 中我介绍了ImageSelector的实现思路和分析了它的核心代码,有兴趣的同学可以看一下。完整的代码放在了GitHub,欢迎大家下载和使用。本篇文章为大家介绍ImageSelector的具体使用方式。</p>    <p>先上效果图:</p>    <p><img src="https://simg.open-open.com/show/5d3c42f2fae32c79a527fc2b44f0bb91.jpg"></p>    <p>相册</p>    <p><img src="https://simg.open-open.com/show/86481815aee258ebd0db2e58b2f47535.jpg"></p>    <p>文件夹</p>    <p><img src="https://simg.open-open.com/show/2cce0f1141a7bc22169e22cdc940d3e1.jpg"></p>    <p>预览</p>    <p>1、引入依赖</p>    <p>在Project的build.gradle在添加以下代码</p>    <pre>  <code class="language-java">allprojects {          repositories {              ...              maven { url 'https://jitpack.io' }          }      }</code></pre>    <p>在Module的build.gradle在添加以下代码</p>    <pre>  <code class="language-java">compile 'com.github.donkingliang:ImageSelector:1.0.1'</code></pre>    <p>2、配置AndroidManifest.xml</p>    <pre>  <code class="language-java">//储存卡的读取权限  <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"/></code></pre>    <p>3、调起图片选择器</p>    <p>ImageSelector支持图片的单选、限数量的多选和不限数量的多选。在调起图片选择器的时候需要告诉选择器,是那种情况。为了方便大家的使用,我在项目中提供了一个工具类,可以方便地调起选择器。</p>    <pre>  <code class="language-java">/**       * 打开相册,选择图片,可多选,不限数量。       *       * @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);      }</code></pre>    <p>工具类里只有简单的两个方法,至于里面的实现逻辑就直接交给了ImageSelectorActivity自己处理,调用者无需关心。调起选择器只需要简单的一句代码就可以了。</p>    <pre>  <code class="language-java">//单选   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);</code></pre>    <p>REQUEST_CODE就是调用者自己定义的启动Activity时的requestCode,这个相信大家都能明白。</p>    <p>4、接收选择器返回的数据</p>    <p>在Activity的onActivityResult方法中接收选择器返回的数据。</p>    <pre>  <code class="language-java">@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);          }      }</code></pre>    <p>ImageSelectorUtils.SELECT_RESULT是接收数据的key。数据是以ArrayList的字符串数组返回的,就算是单选,返回的也是ArrayList数组,只不过这时候ArrayList只有一条数据而已。ArrayList里面的数据就是选中的图片的文件路径。</p>    <p>ImageSelector的使用就介绍到这里了。</p>    <p> </p>    <p>项目主页:<a href="http://www.open-open.com/lib/view/home/1494829233905">http://www.open-open.com/lib/view/home/1494829233905</a></p>