百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
Y

YImagePicker

> 编程语言
开源

小红书多图剪裁+微信图片选择器+大图预览+图片剪裁(支持圆形剪裁和镂空剪裁),已适配androidQ,借鉴并升级matisse加载内核!超强定制性可轻松实现知乎/马蜂窝/微博等特殊样式!支持跨进程回调!内部结构轻量级,无任何第三方开源库!支持support依赖!

1.2K stars0 点赞1 次浏览
访问官网GitHub

工具介绍

小红书多图剪裁+微信图片选择器+大图预览+图片剪裁(支持圆形剪裁和镂空剪裁),已适配androidQ,借鉴并升级matisse加载内核!超强定制性可轻松实现知乎/马蜂窝/微博等特殊样式!支持跨进程回调!内部结构轻量级,无任何第三方开源库!支持support依赖!

关于YImagePicker

点击查看2.x版本readme

本文档更新于:2020/4/15 上午10点36分

  • 支持小红书多图剪裁、微信多图选择、单图剪裁、多图批量剪裁、大图预览
  • 支持自定义所有UI,包括标题栏、底部栏、列表item、文件夹item、剪裁页面、预览页面等
  • 支持13种视频图片格式混合加载,支持过滤掉指定格式文件
  • 支持大图预览,支持超长图、超大图,拒绝too lagre(已修复单图剪裁长图)
  • 支持自定义剪裁比例、剪裁边距、圆形剪裁、镂空/充满剪裁(仿最新微信图片头像选择)
  • 支持视频多选和预览
  • 支持只选择图片或者视频类型
  • 支持恢复上一次选中的图片状态(微信样式)
  • 支持屏蔽指定媒体文件(微信样式)
  • 选择结果直接回调,拒绝配置ActivityForResult+requestCode,即调用即处理
  • 支持选择器调用失败回调
  • 支持自定义回调类型
  • 支持直接回调媒体相册列表及文件列表
  • 支持选择器所有文案修改、国际化定制
  • 支持多种特殊需求覆盖,支持自定义选择器拦截事件
  • 已全面适配androidQ
  • 支持直接拍摄视频、照片等
  • 轻量级,aar大小不超过300K,无so库,无任何第三方依赖
  • 支持androidx和support
  • 永久维护

引入依赖

androidx版本:

java
implementation 'com.ypx.yimagepicker:androidx:3.1.4'

support版本:后期可能不再维护,请使用者尽早切换androidx (support依赖最高兼容28)

java
implementation 'com.ypx.yimagepicker:support:3.1.4.1'

核心原理

YImagePicker与主项目通过IPickerPresenter进行交互与解耦,presenter采用序列化接口的方式实现。使用者需要自行实现presenter的方法。选择器回调采用嵌入fragment的方式实现,类似于Glide或RxPermisson.原理上还是使用OnActivityResult,但无需再配置requestCode并且支持跨进程回调。

调用选择器之前必须实现 IPickerPresenter 接口

选择器问题解答汇总

点击查看3.x详细API文档

apk体验地址 - 密码:123456

效果图集

  • demo效果

  • 小红书样式

  • 微信样式

  • 自定义样式

  • 自定义比例剪裁

  • 多图剪裁页面(仿aloha)

微信图片选择

支持视频、GIF、长图选择,支持选择状态保存。调用前请按照demo实现IPickerPresenter接口 ,示例如下: WeChatPresenter

…

小红书图片选择

高仿小红书图片剪裁框架,支持视频以及多图剪裁、支持视频预览,支持UI自定义,支持fragment样式侵入。调用前请按照demo实现IPickerPresenter接口 ,示例如下: RedBookPresenter

…

预览

支持多图预览和自定义预览界面,支持加载大图,超长图和高清图,示例如下:

java
//配置需要预览的所有图片列表,其中imageitem可替换为Uri或者String(绝对路径)
ArrayList allPreviewImageList = new ArrayList<>();

//默认选中的图片索引
int defaultPosition = 0;
//开启预览
ImagePicker.preview(this, new WXImgPickerPresenter(), allPreviewImageList, defaultPosition, new OnImagePickCompleteListener() {
        @Override
        public void onImagePickComplete(ArrayList items) {
            //图片编辑回调,主线程
        }
    });                                                           

拍照 3.1版本已变更

支持直接打开摄像头拍照,3.1版本去除了原有的拍照保存路径,新增了isCopyInDCIM入参,代表是否将拍照的图片copy一份到外部DCIM目录中 因为安卓Q禁止直接写入文件到系统DCIM文件下,所以拍照入参必须是私有目录路径.所以废弃掉原有的imagepath入参 如果想让拍摄的照片写入外部存储中,则需要copy一份文件到DCIM目录中并刷新媒体库 示例如下:

java
String name="图片名称,不要加后缀";//可为null
boolean isCopyInDCIM=true;//copy一份保存到系统相册文件
ImagePicker.takePhoto(this,name,isCopyInDCIM, new OnImagePickCompleteListener() {
        @Override
        public void onImagePickComplete(ArrayList items) {
            //拍照回调,主线程
        }
    });

拍摄视频 3.1版本已变更

支持直接打开摄像头拍视频,3.1已变更,变更理由参考拍照 示例如下:

java
String name="视频名称,不要加后缀";//可为null
long maxDuration=10000l;//可录制的最大时常,单位毫秒ms
boolean isCopyInDCIM=true;//copy一份保存到系统相册文件
ImagePicker.takeVideo(this,name,maxDuration, isCopyInDCIM,new OnImagePickCompleteListener() {
        @Override
        public void onImagePickComplete(ArrayList items) {
            //视频回调,主线程
        }
    });

调用选择器并剪裁

支持选择图片完调用剪裁,支持自定义比例剪裁,支持圆形剪裁,示例如下:

…

拍照并剪裁

支持直接打开摄像头拍照并剪裁,支持自定义比例剪裁和圆形剪裁,示例如下:

…

直接剪裁

支持直接跳转剪裁页面,示例如下:

…

提供媒体数据——支持回调相册数据、所有媒体数据、指定相册内媒体数据

获取媒体相册数据

java
//指定要回调的相册类型,可以指定13种图片视频文件格式混合
Set mimeTypes = MimeType.ofAll();
ImagePicker.provideMediaSets(this, mimeTypes, new MediaSetsDataSource.MediaSetProvider() {
    @Override
    public void providerMediaSets(ArrayList imageSets) {
        //相册列表回调,主线程
    }
});

获取全部媒体文件

java
//指定要回调的相册类型,可以指定13种图片视频文件格式混合
Set mimeTypes = MimeType.ofAll();
ImagePicker.provideAllMediaItems(this, mimeTypes, new MediaItemsDataSource.MediaItemProvider() {
        @Override
        public void providerMediaItems(ArrayList imageItems, ImageSet allVideoSet) {
            //全部媒体数据回调,主线程
            //只有当mimeTypes既包含图片或者视频格式文件时,allVideoSet才有值
        }
    });

获取指定相册内全部媒体文件

java
//指定要回调的相册类型,可以指定13种图片视频文件格式混合
Set mimeTypes = MimeType.ofAll();
//指定相册,id不能为空
ImageSet imageSet = new ImageSet();
ImagePicker.provideMediaItemsFromSet(this, imageSet, mimeTypes, new MediaItemsDataSource.MediaItemProvider() {
        @Override
        public void providerMediaItems(ArrayList imageItems, ImageSet allVideoSet) {
            //全部媒体数据回调,主线程
            //只有当mimeTypes既包含图片或者视频格式文件时,allVideoSet才有值
        }
    });

预加载获取指定相册内全部媒体文件

…

使用前请务必阅读选择器问题解答汇总以及 3.x使用文档

版本记录

查看详细版本记录

3.1.4版本 [2020.04.15]

  1. 修复3.1.3版本path取不到绝对路径问题
  2. 修复quicktime类型视频无法过滤的问题

3.1.3版本 [2020.04.09]

  1. 修复安卓10上全部视频文件夹缩略图不展示
  2. 修复安卓10上部分手机上部分图片无法展示问题
  3. 修复大图预览放大缩小卡顿问题
  4. 彻底修复toolarge闪退
  5. 优化了图片剪裁预览质量
  6. 修复预览界面无法预览视频问题
  7. 预览支持自定义预览item,可根据图片还是视频动态显示布局
  8. presenter的interceptItemClick方法新增isClickCheckBox入参,代表拦截的对象是否是点击右上角checkbox
  9. 新增showCameraOnlyInAllMediaSet方法代表是否只在全部文件夹里才展示拍照item,其他文件夹不展示
  10. imageitem新增displayName字段代表文件名称
  11. 其他更多细节优化

3.1版本 [2020.02.24]

  1. [优化]isOriginalImage加入到imageitem里
  2. [变更]自定义文本统一,删除了PickerConstants类,presenter中无需对选择器文案进行修改,若需要修改文案,则直接复制imagepicker中string文件,另外demo已覆盖英文适配
  3. [优化]多图剪裁已加入demo(AlohaActivity)
  4. [bug修复]长图剪裁崩溃问题
  5. [bug修复]关闭屏幕旋转问题
  6. [新增]新增setDefaultOriginal用于设置此次打开选择器的默认原图开关
  7. [新增]单图剪裁支持保存状态,下次恢复
  8. [新增]录制视频添加最大时长配置
  9. [优化]完全兼容androudQ拍照问题
  10. [新增]UiPickerConfig新增主题色设置
  11. [优化]demo架构调整,使用者参考更清晰

下个版本排期

时间:暂定2020年5月中旬

  1. 剪裁支持输出大小
  2. 剪裁支持旋转(尽量)
  3. 文件大小加载限制
  4. 支持darkmode模式
  5. 支持activity自定义跳转动画
  6. 内置新版本微信样式,知乎样式等
  7. 支持切换视频底层框架(吐槽:官方videoView太难用了~~/(ㄒoㄒ)/~~)
  8. 等你来提

永不TODO:

  1. 不会支持图片压缩,请使用者自行使用luBan
  2. 不会支持图片和视频高级编辑(滤镜、贴纸等)

感谢

  • 本框架媒体库查询部分借鉴于知乎开源框架Matisee,并在其基础上拓展并延伸,让查询更富有定制性,在此对Matisee原作者表示感谢。

  • 本库来源于mars App,想要体验城市最新的吃喝玩乐,欢迎读者下载体验mars!

  • 感谢所有支持或star本项目的使用者,感谢所有给我提issue的朋友们 !

心声

YImagePicker从当初的只支持微信图片选择器到支持小红书样式,再到各种自定义,可谓花费了我近一年多的时光,可能有人觉得这个项目很简单,但是从开源性的角度上来说,很多时候代码不是我们想怎么写就怎么写的。为了达成统一风格,本人也借鉴了不下于20多个图片选择库。但是随着业务的复杂和机型的多样,不得不一遍遍重构,其中带来了不少的问题,也学习到了很多。在我的计划中,本库3.0版本算是一次较大的更新,相比2.x有着更优异的稳定性和定制性。但这绝不是最优版本,随着越来越多的定制化需求,架构可能会面临一次又一次的更新。所以使用者在使用的过程中如果出现各种各样的问题,还请不要放弃本库,可以直接加我联系方式并反馈给我(喷我),如果有更好的建议,也可以给我提request,我们一起完善此框架。最后说一句,没有什么是完美的,但我会力所能及~

  • 作者:calorYang
  • 邮箱:[email protected]
  • QQ号: 313930500
  • 微信:calor0616
  • 博客:CSDN

遇到问题别绕路,QQ微信直接呼~ 您的star就是我前进的动力~

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Javaandroid-image-selectorgalleryimagepickerimageselector

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言