Android 仿微信的圖片選擇器ImageSelector的使用

DonKingLiang發表於2019-03-01
Android

今天給大家介紹一個仿微信的圖片選擇器：ImageSelector。ImageSelector支援圖片的單選、限數量的多選和不限數量的多選。支援圖片預覽和圖片資料夾的切換。在上一篇文章 《Android 實現一個仿微信的圖片選擇器》 中我介紹了ImageSelector的實現思路和分析了它的核心程式碼，有興趣的同學可以看一下。完整的程式碼放在了GitHub，歡迎大家下載和使用。本篇文章為大家介紹ImageSelector的具體使用方式。
先上效果圖：

相簿
資料夾
預覽

**1、引入依賴 **
在Project的build.gradle在新增以下程式碼

	allprojects {
		repositories {
			...
			maven { url `https://jitpack.io` }
			maven { url `https://maven.google.com` }
		}
	}
複製程式碼

在Module的build.gradle在新增以下程式碼

	compile `com.github.donkingliang:ImageSelector:1.6.0`
複製程式碼

2、配置AndroidManifest.xml

<!-- 儲存卡的讀寫許可權 -->
<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 檔案共享配置，必須配置 -->
<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)  //設定是否單選
        .start(this, REQUEST_CODE); // 開啟相簿

//限數量的多選(比喻最多9張)
ImageSelector.builder()
        .useCamera(true) // 設定是否使用拍照
        .setSingle(false)  //設定是否單選
        .setMaxSelectCount(9) // 圖片的最大選擇數量，小於等於0時，不限數量。
	.setSelected(selected) // 把已選的圖片傳入預設選中。
        .start(this, REQUEST_CODE); // 開啟相簿

//不限數量的多選
ImageSelector.builder()
        .useCamera(true) // 設定是否使用拍照
        .setSingle(false)  //設定是否單選
        .setMaxSelectCount(0) // 圖片的最大選擇數量，小於等於0時，不限數量。
	.setSelected(selected) // 把已選的圖片傳入預設選中。
        .start(this, REQUEST_CODE); // 開啟相簿

//單選並剪裁
ImageSelector.builder()
       .useCamera(true) // 設定是否使用拍照
       .setCrop(true)  // 設定是否使用圖片剪下功能。
       .setSingle(true)  //設定是否單選
       .start(this, REQUEST_CODE); // 開啟相簿
複製程式碼

REQUEST_CODE就是呼叫者自己定義的啟動Activity時的requestCode，這個相信大家都能明白。selected可以在再次開啟選擇器時，把原來已經選擇過的圖片傳入，使這些圖片預設為選中狀態。

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的專案地址：github.com/donkinglian…

相關文章