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.0.1'

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"/>

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);
    }

工具類里只有簡單的兩個方法，至于里面的實現邏輯就直接交給了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);

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的使用就介紹到這里了。

項目主頁：http://www.baiduhome.net/lib/view/home/1494829233905