現在大部分的App都上傳圖片的功能，比如設定使用者頭像、聊天傳送圖片、發表動態、論壇帖子等。上傳圖片需要先從選擇手機中選擇要上傳的圖片，所以圖片選擇器在App中是很常見的元件，一般的手機都會自帶一個圖片選擇器。不過很多App並不喜歡用手機自帶的選擇器，而是自己實現一個圖片選擇器。比如微信的圖片選擇器就做的很好。所以我也仿照微信的樣式和互動效果，自己做了一個圖片選擇器：ImageSelector。ImageSelector支援圖片的單選、限數量的多選和不限數量的多選。支援圖片預覽和圖片資料夾的切換。專案已經上傳到了我的GitHub，歡迎大家下載和使用。
本篇文章我將為大家介紹ImageSelector是如何現實的。由於ImageSelector的專案程式碼比較多，所以這篇文章只講解ImageSelector的實現思路和分析主要的專案程式碼。想要看完整程式碼的同學請到GitHub下載專案。至於ImageSelector的使用，在我的另一篇文章中有詳細的介紹：《Android 仿微信的圖片選擇器ImageSelector的使用》。
先上效果圖：
要實現一個圖片選擇器，需要做的主要就是以下幾個事情：
1、從手機儲存卡中掃描載入圖片。
2、用一個列表將圖片顯示出來。
3、選擇圖片。
4、把選中的圖片返回給呼叫者。
準備工作
首先需要匯入兩個第三方庫。
//圖片載入庫，用於載入圖片
compile 'com.github.bumptech.glide:glide:3.7.0'
//圖片縮放庫，用於圖片的預覽
compile 'com.github.chrisbanes:PhotoView:2.0.0'複製程式碼第一步：從手機儲存卡中掃描載入圖片
讀取手機儲存卡需要先申請許可權：
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />複製程式碼對Android 6.0以上的系統做動態許可權處理。
/**
* 檢查許可權並載入SD卡里的圖片。
*/
private void checkPermissionAndLoadImages() {
int hasWriteContactsPermission = ContextCompat.checkSelfPermission(getApplication(),
Manifest.permission.WRITE_EXTERNAL_STORAGE);
if (hasWriteContactsPermission == PackageManager.PERMISSION_GRANTED) {
//有許可權，載入圖片。
loadImageForSDCard();
} else {
//沒有許可權，申請許可權。
ActivityCompat.requestPermissions(ImageSelectorActivity.this,
new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, PERMISSION_REQUEST_CODE);
}
}
/**
* 處理許可權申請的回撥。
*/
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
if (requestCode == PERMISSION_REQUEST_CODE) {
if (grantResults.length > 0
&& grantResults[0] == PackageManager.PERMISSION_GRANTED) {
//允許許可權，載入圖片。
loadImageForSDCard();
} else {
//拒絕許可權，彈出提示框。
showExceptionDialog();
}
}
}複製程式碼接著就是從手機儲存卡中掃描載入圖片。
/**
* 從SDCard載入圖片。
*/
private void loadImageForSDCard() {
ImageModel.loadImageForSDCard(this, new ImageModel.DataCallback() {
@Override
public void onSuccess(ArrayList<Folder> folders) {
//folders是圖片資料夾的列表，每個資料夾中都有若干張圖片。
}
});
}複製程式碼我將掃描手機儲存卡的操作封裝在ImageModel類，並通過DataCallback把掃描的結果返回給呼叫者。返回的結果是一個資料夾的列表，這是因為我們的圖片選擇器需要實現資料夾切換的功能，所以我把掃描出來的圖片按資料夾進行了拆分。
下面看資料夾實體類Folder 和圖片實體類 Image：
/**
* 圖片資料夾實體類
*/
public class Folder {
private String name;
private ArrayList<Image> images;
public Folder(String name) {
this.name = name;
}
public Folder(String name, ArrayList<Image> images) {
this.name = name;
this.images = images;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public ArrayList<Image> getImages() {
return images;
}
public void setImages(ArrayList<Image> images) {
this.images = images;
}
public void addImage(Image image) {
if (image != null && StringUtils.isNotEmptyString(image.getPath())) {
if (images == null) {
images = new ArrayList<>();
}
images.add(image);
}
}
}
/**
*圖片實體類
*/
public class Image {
private String path;
private long time;
private String name;
public Image(String path, long time, String name) {
this.path = path;
this.time = time;
this.name = name;
}
public String getPath() {
return path;
}
public void setPath(String path) {
this.path = path;
}
public long getTime() {
return time;
}
public void setTime(long time) {
this.time = time;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}複製程式碼注意，最核心的程式碼來了：使用ContentProvider掃描手機中的所有圖片。
public class ImageModel {
/**
* 從SDCard載入圖片
*/
public static void loadImageForSDCard(final Context context, final DataCallback callback) {
//由於掃描圖片是耗時的操作，所以要在子執行緒處理。
new Thread(new Runnable() {
@Override
public void run() {
//掃描圖片
Uri mImageUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
ContentResolver mContentResolver = context.getContentResolver();
Cursor mCursor = mContentResolver.query(mImageUri, new String[]{
MediaStore.Images.Media.DATA,
MediaStore.Images.Media.DISPLAY_NAME,
MediaStore.Images.Media.DATE_ADDED,
MediaStore.Images.Media._ID},
null,
null,
MediaStore.Images.Media.DATE_ADDED);
ArrayList<Image> images = new ArrayList<>();
//讀取掃描到的圖片
while (mCursor.moveToNext()) {
// 獲取圖片的路徑
String path = mCursor.getString(
mCursor.getColumnIndex(MediaStore.Images.Media.DATA));
//獲取圖片名稱
String name = mCursor.getString(
mCursor.getColumnIndex(MediaStore.Images.Media.DISPLAY_NAME));
//獲取圖片時間
long time = mCursor.getLong(
mCursor.getColumnIndex(MediaStore.Images.Media.DATE_ADDED));
images.add(new Image(path, time, name));
}
mCursor.close();
Collections.reverse(images);
callback.onSuccess(splitFolder(images));
}
}).start();
}
/**
* 把圖片按資料夾拆分，第一個資料夾儲存所有的圖片
*/
private static ArrayList<Folder> splitFolder(ArrayList<Image> images) {
ArrayList<Folder> folders = new ArrayList<>();
folders.add(new Folder("全部圖片", images));
if (images != null && !images.isEmpty()) {
int size = images.size();
for (int i = 0; i < size; i++) {
String path = images.get(i).getPath();
String name = getFolderName(path);
if (StringUtils.isNotEmptyString(name)) {
Folder folder = getFolder(name, folders);
folder.addImage(images.get(i));
}
}
}
return folders;
}
/**
* 根據圖片路徑，獲取圖片資料夾名稱
*/
private static String getFolderName(String path) {
if (StringUtils.isNotEmptyString(path)) {
String[] strings = path.split(File.separator);
if (strings.length >= 2) {
return strings[strings.length - 2];
}
}
return "";
}
private static Folder getFolder(String name, List<Folder> folders) {
if (folders != null && !folders.isEmpty()) {
int size = folders.size();
for (int i = 0; i < size; i++) {
Folder folder = folders.get(i);
if (name.equals(folder.getName())) {
return folder;
}
}
}
Folder newFolder = new Folder(name);
folders.add(newFolder);
return newFolder;
}
public interface DataCallback {
void onSuccess(ArrayList<Folder> folders);
}
}複製程式碼到這裡，我們就已經拿到了手機裡的所有圖片了，接下來就是展示圖片列表。
第二步：展示圖片
這個非常的簡單，其實就是寫一個圖片列表。
//圖片列表
private RecyclerView rvImage;
// 初始化圖片列表
private void initImageList() {
mLayoutManager = new GridLayoutManager(this, 3);
rvImage.setLayoutManager(mLayoutManager);
mAdapter = new ImageAdapter(this, mMaxCount, isSingle);
rvImage.setAdapter(mAdapter);
}複製程式碼這裡的ImageAdapter，就是圖片列表的Adapter。
public class ImageAdapter extends RecyclerView.Adapter<ImageAdapter.ViewHolder> {
private Context mContext;
private ArrayList<Image> mImages;
private LayoutInflater mInflater;
private int mMaxCount;
private boolean isSingle;
/**
* @param maxCount 圖片的最大選擇數量，小於等於0時，不限數量，isSingle為false時才有用。
* @param isSingle 是否單選
*/
public ImageAdapter(Context context, int maxCount, boolean isSingle) {
mContext = context;
this.mInflater = LayoutInflater.from(mContext);
mMaxCount = maxCount;
this.isSingle = isSingle;
}
@Override
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = mInflater.inflate(R.layout.adapter_images_item, parent, false);
return new ViewHolder(view);
}
@Override
public void onBindViewHolder(final ViewHolder holder, final int position) {
final Image image = mImages.get(position);
Glide.with(mContext).load(new File(image.getPath()))
.diskCacheStrategy(DiskCacheStrategy.NONE).into(holder.ivImage);
}
@Override
public int getItemCount() {
return mImages == null ? 0 : mImages.size();
}
static class ViewHolder extends RecyclerView.ViewHolder {
ImageView ivImage;
ImageView ivSelectIcon;
ImageView ivMasking;
public ViewHolder(View itemView) {
super(itemView);
ivImage = (ImageView) itemView.findViewById(R.id.iv_image);
ivSelectIcon = (ImageView) itemView.findViewById(R.id.iv_select);
ivMasking = (ImageView) itemView.findViewById(R.id.iv_masking);
}
}
}複製程式碼第三步：選擇圖片
點選選擇圖片，主要是對圖片列表的ImageAdapter中的item進行操作，所以我就直接寫在了ImageAdapter類裡。選中的圖片用一個陣列儲存。
//儲存選中的圖片
private ArrayList<Image> mSelectImages = new ArrayList<>();
//點選選中/取消選中圖片
holder.ivSelectIcon.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (mSelectImages.contains(image)) {
//如果圖片已經選中，就取消選中
unSelectImage(image);
setItemSelect(holder, false);
} else if (isSingle) {
//如果是單選，就先清空已經選中的圖片，再選中當前圖片
clearImageSelect();
selectImage(image);
setItemSelect(holder,true);
} else if (mMaxCount <= 0 || mSelectImages.size() < mMaxCount) {
//如果不限制圖片的選中數量，或者圖片的選中數量還沒有達到最大限制，就直接選中當前圖片。
selectImage(image);
setItemSelect(holder, true);
}
}
});
/**
* 選中圖片
*/
private void selectImage(Image image){
mSelectImages.add(image);
}
/**
* 取消選中圖片
*/
private void unSelectImage(Image image){
mSelectImages.remove(image);
}
/**
* 設定圖片選中和未選中的效果
*/
private void setItemSelect(ViewHolder holder, boolean isSelect) {
if (isSelect) {
holder.ivSelectIcon.setImageResource(R.drawable.icon_image_select);
holder.ivMasking.setAlpha(0.5f);
} else {
holder.ivSelectIcon.setImageResource(R.drawable.icon_image_un_select);
holder.ivMasking.setAlpha(0.2f);
}
}複製程式碼第四步：把選中的圖片返回給呼叫者
點選“確定”按鈕時，把選中的圖片通過Intent返回給呼叫者。
private void confirm() {
//因為圖片的實體類是Image，而我們返回的是String陣列，所以要進行轉換。
ArrayList<Image> selectImages = mAdapter.getSelectImages();
ArrayList<String> images = new ArrayList<>();
for (Image image : selectImages) {
images.add(image.getPath());
}
//點選確定，把選中的圖片通過Intent傳給上一個Activity。
Intent intent = new Intent();
intent.putStringArrayListExtra(ImageSelectorUtils.SELECT_RESULT, images);
setResult(RESULT_OK, intent);
//關閉頁面
finish();
}複製程式碼到這裡，圖片選擇器的基本現實思路和主要的功能程式碼就介紹完了。在這個ImageSelector專案中，還有很多其他的知識，比如圖片資料夾切換、手機橫豎屏切換、圖片預覽、動畫效果、點選效果等，這裡就不一一介紹了，有興趣的同學可以去看完整的專案程式碼。在專案中，我也給出了很詳細的程式碼註釋，方便大家閱讀。
最後給出ImageSelector的專案地址：github.com/donkinglian…