簡(jiǎn)介
- 完美支持7.0，不存在Android7.0 FileUriExposedException抓半。
- 支持組件：
Activity喂急、Fragment。 - UI可以配置笛求，比如：
Toolbar廊移、StatusBar、NavigationBar探入。 - 相冊(cè)選圖狡孔，單選、多選蜂嗽、文件夾預(yù)覽苗膝。
- 相機(jī)拍照，可以單獨(dú)調(diào)用徒爹、也可以以Item展示在相冊(cè)中荚醒。
- 畫廊芋类，支持縮放隆嗅、支持瀏覽本地圖片、支持瀏覽網(wǎng)絡(luò)圖片侯繁。
- 支持配置相冊(cè)列數(shù)胖喳，支持配置相冊(cè)是否使用相機(jī)。
- 畫廊預(yù)覽選擇的圖片贮竟，預(yù)覽時(shí)可以反選丽焊。
- 支持自定義
LocalImageLoader较剃，例如使用：Glide、Picasso技健、ImageLoader實(shí)現(xiàn)写穴。
Demo效果預(yù)覽
使用方法
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請(qǐng)下載源碼自行轉(zhuǎn)換成Library project。
mainifest.xml中需要注冊(cè)
<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是調(diào)起的Activity的標(biāo)題雌贱，你可以自定義啊送，其它請(qǐng)照抄即可。
需要的權(quán)限
<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ā)者不需要擔(dān)心Android6.0的運(yùn)行時(shí)權(quán)限欣孤，Album已經(jīng)非常完善的處理過了馋没。
Album
主要功能分為三部分：相冊(cè)選圖、相機(jī)拍照降传、畫廊預(yù)覽篷朵，下面分別說明。
Album 相冊(cè)
使用Album.album(context).start()即可調(diào)起相冊(cè)婆排。
Album.album(context)
.requestCode(999) // 請(qǐng)求碼声旺，返回時(shí)onActivityResult()的第一個(gè)參數(shù)。
.toolBarColor(toolbarColor) // Toolbar 顏色段只，默認(rèn)藍(lán)色艾少。
.statusBarColor(statusBarColor) // StatusBar 顏色，默認(rèn)藍(lán)色翼悴。
.navigationBarColor(navigationBarColor) // NavigationBar 顏色缚够，默認(rèn)黑色，建議使用默認(rèn)鹦赎。
.title("圖庫(kù)") // 配置title谍椅。
.selectCount(9) // 最多選擇幾張圖片。
.columnCount(2) // 相冊(cè)展示列數(shù)古话，默認(rèn)是2列雏吭。
.camera(true) // 是否有拍照功能。
.checkedList(mImageList) // 已經(jīng)選擇過得圖片陪踩，相冊(cè)會(huì)自動(dòng)選中選過的圖片杖们，并計(jì)數(shù)。
.start();
重寫onActivityResult()方法肩狂，接受圖片選擇結(jié)果：
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if(requestCode == 999) {
if (resultCode == RESULT_OK) { // Successfully.
// 不要質(zhì)疑你的眼睛摘完，就是這么簡(jiǎn)單。
ArrayList<String> pathList = Album.parseResult(data);
} else if (resultCode == RESULT_CANCELED) { // User canceled.
// 用戶取消了操作傻谁。
}
}
}
Camera 相機(jī)
使用Album.camera(context).start()即可調(diào)起相機(jī)孝治，已經(jīng)處理了權(quán)限和Android7.0的FileProvider問題。
Album.camera(context)
.requestCode(666)
// .imagePath() // 指定相機(jī)拍照的路徑，建議非特殊情況不要指定.
.start();
重寫onActivityResult()方法谈飒，接受圖片選擇結(jié)果：
@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()即可調(diào)起畫廊杭措。畫廊默認(rèn)支持預(yù)覽本地圖片费什，如果要預(yù)覽網(wǎng)絡(luò)圖片，你需要在初始化的時(shí)候配置ImageLoader手素，具體見下文吕喘。
調(diào)用的時(shí)候你只需要傳入一個(gè)路徑集合：
Album.gallery(context)
.requestCode(555) // 請(qǐng)求碼，返回時(shí)onActivityResult()的第一個(gè)參數(shù)刑桑。
.toolBarColor(toolbarColor) // Toolbar 顏色氯质，默認(rèn)藍(lán)色。
.statusBarColor(statusBarColor) // StatusBar 顏色祠斧，默認(rèn)藍(lán)色闻察。
.navigationBarColor(navigationBarColor) // NavigationBar 顏色，默認(rèn)黑色琢锋，建議使用默認(rèn)辕漂。
.checkedList(mImageList) // 要預(yù)覽的圖片list。
.currentPosition(position) // 預(yù)覽的時(shí)候要顯示list中的圖片的index吴超。
.checkFunction(true) // 預(yù)覽時(shí)是否有反選功能钉嘹。
.start();
注意：
- 一定要傳入要預(yù)覽的圖片集合，否則啟動(dòng)會(huì)立即返回鲸阻。
- 調(diào)用畫廊預(yù)覽時(shí)判斷
if(currentPosition < mImageList.size())跋涣，這樣才能保證傳入的position在list中，否則會(huì)立即返回鸟悴。
如果你需要預(yù)覽時(shí)的反選功能陈辱，那么重寫onActivityResult()方法，接受反選后的圖片List結(jié)果：
ArrayList<String> mImageList;
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if(requestCode == 555) {
if (resultCode == RESULT_OK) { // Successfully.
// 不要再次質(zhì)疑你的眼睛细诸，還是這么簡(jiǎn)單沛贪。
mImageList = Album.parseResult(data);
} else if (resultCode == RESULT_CANCELED) { // User canceled.
// 用戶取消了操作。
}
}
}
高級(jí)配置
這個(gè)配置不是必須的震贵，不配置也完全可以用：利赋。
-
ImageLoader，默認(rèn)使用LocalImageLoader猩系，你可以用Glide和Picasso等其它第三方框架來實(shí)現(xiàn)媚送。 -
Locale，默認(rèn)已經(jīng)支持國(guó)際化了蝙眶，支持簡(jiǎn)體中文季希、繁體中文褪那、英語幽纷。如果你要指定語言式塌，可以使用Locale配置。
ImageLoader配置
我推薦優(yōu)先使用默認(rèn)ImageLoader友浸，其次用Glide實(shí)現(xiàn)峰尝、其次是Picasso，最后是ImageLoader收恢，暫時(shí)不支持Fresco武学。
Album提供的默認(rèn)的LocalImageLoader如下：
public class Application extends android.app.Application {
@Override
public void onCreate() {
super.onCreate();
Album.initialize(
new AlbumConfig.Build()
.setImageLoader(new LocalImageLoader()) // 使用默認(rèn)loader.
.build()
);
}
}
用Glide實(shí)現(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實(shí)現(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是完全可以混淆的，如果混淆后相冊(cè)出現(xiàn)了問題伦意，請(qǐng)?jiān)诨煜?guī)則中添加：
-dontwarn com.yanzhenjie.album.**
-keep class com.yanzhenjie.album.**{*;}
參考文檔：
PhotoView： https://github.com/chrisbanes/PhotoView
LoadingDrawable：https://github.com/dinuscxj/LoadingDrawable
本項(xiàng)目開源地址：https://github.com/yanzhenjie/album
Demo地址：https://github.com/huangshuyuan/SelectPhotoDemo
我的博客：http://blog.csdn.net/Imshuyuan/article/details/71610064
