簡介

1. 完美支持7.0，不存在Android7.0 FileUriExposedException。
2. 支持組件：Activity、Fragment。
3. UI可以配置，比如：Toolbar、StatusBar、NavigationBar。
4. 相冊選圖，單選、多選、文件夾預覽。
5. 相機拍照，可以單獨調用、也可以以Item展示在相冊中。
6. 畫廊，支持縮放、支持瀏覽本地圖片、支持瀏覽網(wǎng)絡圖片。
7. 支持配置相冊列數(shù)，支持配置相冊是否使用相機。
8. 畫廊預覽選擇的圖片，預覽時可以反選。
9. 支持自定義LocalImageLoader，例如使用：Glide、Picasso、ImageLoader實現(xiàn)。

Demo效果預覽

效果圖

使用方法

Gradle：

compile 'com.yanzhenjie:album:1.0.0'

Maven:

<dependency>
  <groupId>com.yanzhenjie</groupId>
  <artifactId>album</artifactId>
  <version>1.0.6</version>
  <type>pom</type>
</dependency>

Eclipse請下載源碼自行轉換成Library project。

mainifest.xml中需要注冊

<activity
    android:name="com.yanzhenjie.album.AlbumActivity"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:theme="@style/Theme.AppCompat.Light.NoActionBar"
    android:windowSoftInputMode="stateAlwaysHidden|stateHidden" />

其中android:label="xx"中的xx是調起的Activity的標題，你可以自定義，其它請照抄即可。

需要的權限

<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>

開發(fā)者不需要擔心Android6.0的運行時權限，Album已經(jīng)非常完善的處理過了。

Album

主要功能分為三部分：相冊選圖、相機拍照、畫廊預覽，下面分別說明。

Album 相冊

使用Album.album(context).start()即可調起相冊。

Album.album(context)
    .requestCode(999) // 請求碼，返回時onActivityResult()的第一個參數(shù)。
    .toolBarColor(toolbarColor) // Toolbar 顏色，默認藍色。
    .statusBarColor(statusBarColor) // StatusBar 顏色，默認藍色。
    .navigationBarColor(navigationBarColor) // NavigationBar 顏色，默認黑色，建議使用默認。
    .title("圖庫") // 配置title。
    
    .selectCount(9) // 最多選擇幾張圖片。
    .columnCount(2) // 相冊展示列數(shù)，默認是2列。
    .camera(true) // 是否有拍照功能。
    .checkedList(mImageList) // 已經(jīng)選擇過得圖片，相冊會自動選中選過的圖片，并計數(shù)。
    .start();

重寫onActivityResult()方法，接受圖片選擇結果：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if(requestCode == 999) {
        if (resultCode == RESULT_OK) { // Successfully.
            // 不要質疑你的眼睛，就是這么簡單。
            ArrayList<String> pathList = Album.parseResult(data);
        } else if (resultCode == RESULT_CANCELED) { // User canceled.
            // 用戶取消了操作。
        }
    }
}

Camera 相機

使用Album.camera(context).start()即可調起相機，已經(jīng)處理了權限和Android7.0的FileProvider問題。

Album.camera(context)
    .requestCode(666)
    // .imagePath() // 指定相機拍照的路徑，建議非特殊情況不要指定.
    .start();

重寫onActivityResult()方法，接受圖片選擇結果：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if(requestCode == 666) {
        if (resultCode == RESULT_OK) { // Successfully.
            // 這里的List的size肯定是1。
            List<String> pathList = Album.parseResult(data); // Parse path.
        } else if (resultCode == RESULT_CANCELED) {
            // 用戶取消了操作。
        }
    }
}

Gallery 畫廊

使用Album.gallery(context).start()即可調起畫廊。畫廊默認支持預覽本地圖片，如果要預覽網(wǎng)絡圖片，你需要在初始化的時候配置ImageLoader，具體見下文。

調用的時候你只需要傳入一個路徑集合：

Album.gallery(context)
    .requestCode(555) // 請求碼，返回時onActivityResult()的第一個參數(shù)。
    .toolBarColor(toolbarColor) // Toolbar 顏色，默認藍色。
    .statusBarColor(statusBarColor) // StatusBar 顏色，默認藍色。
    .navigationBarColor(navigationBarColor) // NavigationBar 顏色，默認黑色，建議使用默認。
    
    .checkedList(mImageList) // 要預覽的圖片list。
    .currentPosition(position) // 預覽的時候要顯示list中的圖片的index。
    .checkFunction(true) // 預覽時是否有反選功能。
    .start();

注意：

• 一定要傳入要預覽的圖片集合，否則啟動會立即返回。
• 調用畫廊預覽時判斷if(currentPosition < mImageList.size())，這樣才能保證傳入的position在list中，否則會立即返回。

如果你需要預覽時的反選功能，那么重寫onActivityResult()方法，接受反選后的圖片List結果：

ArrayList<String> mImageList;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if(requestCode == 555) {
        if (resultCode == RESULT_OK) { // Successfully.
            // 不要再次質疑你的眼睛，還是這么簡單。
            mImageList = Album.parseResult(data);
        } else if (resultCode == RESULT_CANCELED) { // User canceled.
            // 用戶取消了操作。
        }
    }
}

高級配置

這個配置不是必須的，不配置也完全可以用：。

1. ImageLoader，默認使用LocalImageLoader，你可以用Glide和Picasso等其它第三方框架來實現(xiàn)。
2. Locale，默認已經(jīng)支持國際化了，支持簡體中文、繁體中文、英語。如果你要指定語言，可以使用Locale配置。

ImageLoader配置

我推薦優(yōu)先使用默認ImageLoader，其次用Glide實現(xiàn)、其次是Picasso，最后是ImageLoader，暫時不支持Fresco。

Album提供的默認的LocalImageLoader如下：

public class Application extends android.app.Application {
    @Override
    public void onCreate() {
        super.onCreate();

        Album.initialize(
            new AlbumConfig.Build()
                .setImageLoader(new LocalImageLoader()) // 使用默認loader.
                .build()
        );
    }
}

用Glide實現(xiàn)：

public class GlideImageLoader implements AlbumImageLoader {
    @Override
    public void loadImage(ImageView imageView, String imagePath, int width, int height) {
        Glide.with(imageView.getContext())
            .load(new File(imagePath))
            .into(imageView);
    }
}

...

Album.initialize(new AlbumConfig.Build()
    .setImageLoader(new GlideImageLoader()) // Use glide loader.
    .build()

用Picasso實現(xiàn)

public class PicassoImageLoader implements AlbumImageLoader {

    @Override
    public void loadImage(ImageView imageView, String imagePath, int width, int height) {
        Picasso.with(imageView.getContext())
            .load(new File(imagePath))
            .centerCrop()
            .resize(width, height)
            .into(imageView);
    }
}

...

Album.initialize(new AlbumConfig.Build()
    .setImageLoader(new PicassoImageLoader()) // Use picasso loader.
    .build()

混淆

Album是完全可以混淆的，如果混淆后相冊出現(xiàn)了問題，請在混淆規(guī)則中添加：

-dontwarn com.yanzhenjie.album.**
-keep class com.yanzhenjie.album.**{*;}

參考文檔：

PhotoView： https://github.com/chrisbanes/PhotoView
LoadingDrawable：https://github.com/dinuscxj/LoadingDrawable
本項目開源地址：https://github.com/yanzhenjie/album
Demo地址：https://github.com/huangshuyuan/SelectPhotoDemo
我的博客：http://blog.csdn.net/Imshuyuan/article/details/71610064