图片选择器使用-快捷迅速集成

简介

1. 完美支持7.0，不存在Android7.0 FileUriExposedException。
2. 支持组件：Activity、Fragment。
3. UI可以配置，比如：Toolbar、StatusBar、NavigationBar。
4. 相册选图，单选、多选、文件夹预览。
5. 相机拍照，可以单独调用、也可以以Item展示在相册中。
6. 画廊，支持缩放、支持浏览本地图片、支持浏览网络图片。
7. 支持配置相册列数，支持配置相册是否使用相机。
8. 画廊预览选择的图片，预览时可以反选。
9. 支持自定义LocalImageLoader，例如使用：Glide、Picasso、ImageLoader实现。
   

   ---

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

开发者不需要担心Android6.0的运行时权限，Album已经非常完善的处理过了。

Album

主要功能分为三部分：相册选图、相机拍照、画廊预览，下面分别说明。

Album 相册

使用Album.album(context).start()即可调起相册。

Album.album(context)    .requestCode(999) // 请求码，返回时onActivityResult()的第一个参数。    .toolBarColor(toolbarColor) // Toolbar 颜色，默认蓝色。    .statusBarColor(statusBarColor) // StatusBar 颜色，默认蓝色。    .navigationBarColor(navigationBarColor) // NavigationBar 颜色，默认黑色，建议使用默认。    .title("图库") // 配置title。    .selectCount(9) // 最多选择几张图片。    .columnCount(2) // 相册展示列数，默认是2列。    .camera(true) // 是否有拍照功能。    .checkedList(mImageList) // 已经选择过得图片，相册会自动选中选过的图片，并计数。    .start();

重写onActivityResult()方法，接受图片选择结果：

@Overrideprotected 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()即可调起相机，已经处理了权限和Android7.0的FileProvider问题。

Album.camera(context)    .requestCode(666)    // .imagePath() // 指定相机拍照的路径，建议非特殊情况不要指定.    .start();

重写onActivityResult()方法，接受图片选择结果：

@Overrideprotected 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()即可调起画廊。画廊默认支持预览本地图片，如果要预览网络图片，你需要在初始化的时候配置ImageLoader，具体见下文。

调用的时候你只需要传入一个路径集合：

Album.gallery(context)    .requestCode(555) // 请求码，返回时onActivityResult()的第一个参数。    .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;@Overrideprotected 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等其它第三方框架来实现。
2. Locale，默认已经支持国际化了，支持简体中文、繁体中文、英语。如果你要指定语言，可以使用Locale配置。

ImageLoader配置

我推荐优先使用默认ImageLoader，其次用Glide实现、其次是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实现：

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实现

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是完全可以混淆的，如果混淆后相册出现了问题，请在混淆规则中添加：

-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://www.jianshu.com/p/f91dcf91feec

---