Awesome
PictureSelector
Android 图片选择器(仿 IOS 图片选择控件)
效果图
功能特点
- 支持通过拍照获取图片
- 支持通过相册获取图片
- 支持图片是否裁剪两种场景
- 支持仿 IOS 底部弹出选择菜单 ActionSheet 效果
- 适配 Android Q 版本
使用
Step 1. 添加 JitPack 仓库
在项目的 build.gradle 添加 JitPack 仓库
allprojects {
repositories {
maven { url "https://jitpack.io" }
}
}
Step 2. 添加依赖
在需要使用的 module 中添加依赖
注意:从 2.0.0 版本开始,项目迁移到 AndroidX。如果你的项目还未迁移到 AndroidX,可以使用 1.2.0 版本。
dependencies {
implementation 'com.github.wildma:PictureSelector:2.1.0'
}
Step 3. 拍照或者从相册选择图片
使用场景:
- 不裁剪
PictureSelector
.create(MainActivity.this, PictureSelector.SELECT_REQUEST_CODE)
.selectPicture(false);
- 自由裁剪
PictureSelector
.create(MainActivity.this, PictureSelector.SELECT_REQUEST_CODE)
.selectPicture(true);
- 指定宽高及宽高比例裁剪
PictureSelector
.create(MainActivity.this, PictureSelector.SELECT_REQUEST_CODE)
.selectPicture(true, 200, 200, 1, 1);
参数解释:
- create():参数一是上下文,在 activity 中传 activity.this,在 fragment 中传 fragment.this。参数二是请求码,用于结果回调 onActivityResult() 中判断。
- selectPicture():参数分别为是否裁剪、裁剪后图片的宽(单位 px)、裁剪后图片的高、宽比例、高比例。
Step 4. 获取图片地址进行显示
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
/*结果回调*/
if (requestCode == PictureSelector.SELECT_REQUEST_CODE) {
if (data != null) {
PictureBean pictureBean = data.getParcelableExtra(PictureSelector.PICTURE_RESULT);
if (pictureBean.isCut()) {
mIvImage.setImageBitmap(BitmapFactory.decodeFile(pictureBean.getPath()));
} else {
mIvImage.setImageURI(pictureBean.getUri());
}
//使用 Glide 加载图片
/*Glide.with(this)
.load(pictureBean.isCut() ? pictureBean.getPath() : pictureBean.getUri())
.apply(RequestOptions.centerCropTransform()).into(mIvImage);*/
}
}
}
清理缓存
实际开发中将图片上传到服务器成功后需要删除全部缓存图片(即裁剪后的无用图片),调用如下方法即可:
FileUtils.deleteAllCacheImage(this);
注意
如果你没有使用依赖的方式,而是直接拷贝源码到你的项目中使用。那么需要自己适配 Android 7.0 导致的 FileUriExposedException 异常,具体方式如下:
将 PictureSelectUtils 中的 authority 与你项目中 AndroidManifest.xml 下的 authority 保持一致。 例如 AndroidManifest.xml 下的 authority 为:
android:authorities="myAuthority"
则需要修改 PictureSelectUtils 中的 authority( 这一行) 为:
String authority = "myAuthority";
详细介绍请看文章:一个非常好用的 Android 图片选择框架