# PictureSelector
**Repository Path**: mobingui/PictureSelector
## Basic Information
- **Project Name**: PictureSelector
- **Description**: Picture Selector Library for Android or 图片选择器
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-09
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# PictureSelector 2.0
一款针对android平台下的图片选择器，支持从相册或拍照选择图片或视频，支持动态权限获取、裁剪(单图or多图裁剪)、压缩、主题自定义配置等功能、适配android 6.0+系统的开源图片选择框架。
项目会一直维护，有bug请描述清楚，并请Issues会第一时间修复，Android开发QQ交流群 619458861，个人QQ 893855882@qq.com 希望用得着的朋友点个start。
[PictureSelector 2.0 无裁剪功能版](https://github.com/LuckSiege/PictureSelectorLight)
[我的博客地址](http://blog.csdn.net/luck_mw)
[](https://jitpack.io/#LuckSiege/PictureSelector)
[](https://github.com/LuckSiege)
[](http://blog.csdn.net/luck_mw)
[](https://github.com/LuckSiege/PictureSelector/issues)
[](https://github.com/LuckSiege/PictureSelector)
******功能特点：******
```
1.适配android6.0+系统
2.解决部分机型裁剪闪退问题
3.解决图片过大oom闪退问题
4.动态获取系统权限，避免闪退
5.支持相片or视频的单选和多选
6.支持裁剪比例设置，如常用的 1:1、3：4、3:2、16:9 默认为图片大小
7.支持视频预览
8.支持gif图片
9.支持.webp格式图片
10.支持一些常用场景设置：如:是否裁剪、是否预览图片、是否显示相机等
11.新增自定义主题设置
12.新增图片勾选样式设置
13.新增图片裁剪宽高设置
14.新增图片压缩处理
15.新增录视频最大时间设置
16.新增视频清晰度设置
17.新增QQ选择风格，带数字效果
18.新增自定义 文字颜色 背景色让风格和项目更搭配
19.新增多图裁剪功能
20.新增LuBan多图压缩
21.新增单独拍照功能
22.新增压缩大小设置
23.新增Luban压缩档次设置
24.新增圆形头像裁剪
```
******那些遇到拍照闪退问题的同学，请记得看清下面适配6.0的配置~******
重要的事情说三遍记得添加权限
```
```
******注：适配android6.0以上拍照问题，请在AndroidManifest.xml中添加标签******
```
```
******集成步骤******
方式一 compile引入
```
dependencies {
compile 'com.github.LuckSiege.PictureSelector:picture_library:v2.0.1'
}
```
项目根目录build.gradle加入
```
allprojects {
repositories {
jcenter()
maven { url 'https://jitpack.io' }
}
}
```
方式二 maven引入
step 1.
```
jitpack.io
https://jitpack.io
```
step 2.
```
com.github.LuckSiege.PictureSelector
picture_library
v2.0.1
```
******常见错误*******
```
问题一：
rxjava冲突：在app build.gradle下添加
packagingOptions {
exclude 'META-INF/rxjava.properties'
}
问题二：
java.lang.NullPointerException:
Attempt to invoke virtual method 'android.content.res.XmlResourceParser
android.content.pm.ProviderInfo.loadXmlMetaData(android.content.pm.PackageManager, java.lang.String)'
on a null object reference
application下添加如下节点:
注意：如已添加其他sdk或项目中已使用过provider节点，
[请参考我的博客](http://blog.csdn.net/luck_mw/article/details/54970105)的解决方案
问题三：
PhotoView 库冲突，可以删除自己项目中引用的，Picture_library中已经引用过
com.github.chrisbanes.photoview:library:1.2.4
问题四：
经测试在小米部分低端机中，Fragment调用PictureSelector 2.0 拍照有时内存不足会暂时回收activity,
导致其fragment会重新创建 建议在fragment所依赖的activity加上如下代码:
if (savedInstanceState == null) {
// 添加显示第一个fragment
fragment = new PhotoFragment();
getSupportFragmentManager().beginTransaction().add(R.id.tab_content, fragment,
PictureConfig.FC_TAG).show(fragment)
.commit();
} else {
fragment = (PhotoFragment) getSupportFragmentManager()
.findFragmentByTag(PictureConfig.FC_TAG);
}
这里就是如果是被回收时，则不重新创建 通过tag取出fragment的实例。
问题五(较重要)：
当在使用ucrop裁剪功能时经测试在对部分大图片进行裁剪时会导致特别慢，后经过查找发现是加载.so的原因
不要在app下的build.gradle 设置如下标签，如果强行要指定也要指定对应机型所支持的cpu架构的.so文件
ndk {
//设置支持的SO库架构
abiFilters ''
}
```
******相册启动构造方法******
```
// 进入相册 以下是例子：用不到的api可以不写
PictureSelector.create(MainActivity.this)
.openGallery()//全部.PictureMimeType.ofAll()、图片.ofImage()、视频.ofVideo()
.theme()//主题样式(不设置为默认样式) 也可参考demo values/styles下 例如：R.style.picture.white.style
.maxSelectNum()// 最大图片选择数量 int
.minSelectNum()// 最小选择数量 int
.imageSpanCount(4)// 每行显示个数 int
.selectionMode()// 多选 or 单选 PictureConfig.MULTIPLE or PictureConfig.SINGLE
.previewImage()// 是否可预览图片 true or false
.previewVideo()// 是否可预览视频 true or false
.compressGrade()// luban压缩档次，默认3档 Luban.THIRD_GEAR、Luban.FIRST_GEAR、Luban.CUSTOM_GEAR
.isCamera()// 是否显示拍照按钮 true or false
.enableCrop()// 是否裁剪 true or false
.compress()// 是否压缩 true or false
.compressMode()//系统自带 or 鲁班压缩 PictureConfig.SYSTEM_COMPRESS_MODE or LUBAN_COMPRESS_MODE
.glideOverride()// int glide 加载宽高，越小图片列表越流畅，但会影响列表图片浏览的清晰度
.withAspectRatio()// int 裁剪比例 如16:9 3:2 3:4 1:1 可自定义
.hideBottomControls()// 是否显示uCrop工具栏，默认不显示 true or false
.isGif()// 是否显示gif图片 true or false
.freeStyleCropEnabled()// 裁剪框是否可拖拽 true or false
.circleDimmedLayer()// 是否圆形裁剪 true or false
.showCropFrame()// 是否显示裁剪矩形边框 圆形裁剪时建议设为false true or false
.showCropGrid()// 是否显示裁剪矩形网格 圆形裁剪时建议设为false true or false
.openClickSound()// 是否开启点击声音 true or false
.selectionMedia()// 是否传入已选图片 List list
.previewEggs()// 预览图片时 是否增强左右滑动图片体验(图片滑动一半即可看到上一张是否选中) true or false
.cropCompressQuality()// 裁剪压缩质量 默认90 int
.compressMaxKB()//压缩最大值kb compressGrade()为Luban.CUSTOM_GEAR有效 int
.compressWH() // 压缩宽高比 compressGrade()为Luban.CUSTOM_GEAR有效 int
.cropWH()// 裁剪宽高比，设置如果大于图片本身宽高则无效 int
.rotateEnabled() // 裁剪是否可旋转图片 true or false
.scaleEnabled()// 裁剪是否可放大缩小图片 true or false
.videoQuality()// 视频录制质量 0 or 1 int
.videoSecond()//显示多少秒以内的视频 int
.recordVideoSecond()//视频秒数录制 默认60s int
.forResult(PictureConfig.CHOOSE_REQUEST);//结果回调onActivityResult code
```
******清除PictureSelector 2.0缓存******
```
//包括裁剪和压缩后的缓存，要在上传成功后调用，注意：需要系统sd卡权限
PictureFileUtils.deleteCacheDirFile(MainActivity.this);
```
******PictureSelector 2.0 主题配置******
```
```
******启动相册并拍照******
```
PictureSelector.create(MainActivity.this)
.openGallery(PictureMimeType.ofImage())
.forResult(PictureConfig.CHOOSE_REQUEST);
```
******单独启动拍照或视频 根据PictureMimeType自动识别******
```
PictureSelector.create(MainActivity.this)
.openCamera(PictureMimeType.ofImage())
.forResult(PictureConfig.CHOOSE_REQUEST);
```
******预览图片******
```
// 预览图片 可自定长按保存路径
PictureSelector.create(MainActivity.this).externalPicturePreview(position, "/custom_file", selectList);
PictureSelector.create(MainActivity.this).externalPicturePreview(position, selectList);
```
******预览视频******
```
PictureSelector.create(MainActivity.this).externalPictureVideo(video_path);
```
******图片回调完成结果返回******
```
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (resultCode == RESULT_OK) {
switch (requestCode) {
case PictureConfig.CHOOSE_REQUEST:
// 图片选择结果回调
selectList = PictureSelector.obtainMultipleResult(data);
// 例如 LocalMedia 里面返回三种path
// 1.media.getPath(); 为原图path
// 2.media.getCutPath();为裁剪后path，需判断media.isCut();是否为true
// 3.media.getCompressPath();为压缩后path，需判断media.isCompressed();是否为true
// 如果裁剪并压缩了，以取压缩路径为准，因为是先裁剪后压缩的
adapter.setList(selectList);
adapter.notifyDataSetChanged();
DebugUtil.i(TAG, "onActivityResult:" + selectList.size());
break;
}
}
}
```
# 更新日志：
# 当前版本：
###### 版本 v2.0.1
###### 修复图片排序问题
###### 修复设置预览图片为false时，单选无效问题
###### 过滤已损坏图片or视频
###### 修改启动动画
###### 移除isRemove() api
# 历版版本：
###### 版本 v2.0.0
###### PictureSelector 2.0 UI界面大改版
###### PictureSelector 2.0 新增全部模式查询 包括图片or视频
###### PictureSelector 2.0 启动模式由单例模式，改为链式调用
###### UI主题 改为style.xml 配置，各界面随意定制更加方便
###### 优化部分代码和体验去除多余逻辑
###### 重构PictureSelector和urop库关系，解耦两者关系
###### 修复1.0版本在fragment不回调onActivityResult()
# 项目使用第三方库：
###### 1.glide:3.7.0
###### 2.rxjava:2.0.5
###### 3.rxandroid:2.0.1
###### 4.PhotoView:1.2.4
###### 5.luban
###### 6.裁剪使用ucrop
# 混淆配置
```
#PictureSelector 2.0
-keep class com.luck.picture.lib.** { *; }
-dontwarn com.yalantis.ucrop**
-keep class com.yalantis.ucrop** { *; }
-keep interface com.yalantis.ucrop** { *; }
#rxjava
-dontwarn sun.misc.**
-keepclassmembers class rx.internal.util.unsafe.*ArrayQueue*Field* {
long producerIndex;
long consumerIndex;
}
-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueProducerNodeRef {
rx.internal.util.atomic.LinkedQueueNode producerNode;
}
-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueConsumerNodeRef {
rx.internal.util.atomic.LinkedQueueNode consumerNode;
}
#rxandroid
-dontwarn sun.misc.**
-keepclassmembers class rx.internal.util.unsafe.*ArrayQueue*Field* {
long producerIndex;
long consumerIndex;
}
-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueProducerNodeRef {
rx.internal.util.atomic.LinkedQueueNode producerNode;
}
-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueConsumerNodeRef {
rx.internal.util.atomic.LinkedQueueNode consumerNode;
}
#glide
-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
**[] $VALUES;
public *;
}
```
# 兼容性测试：
******腾讯优测-深度测试-通过率达到100%******
# 演示效果：
