FishBun 图像选择器使用教程
FishBun:blowfish:FishBun is Image Picker for android.项目地址:https://gitcode.com/gh_mirrors/fi/FishBun
项目介绍
FishBun 是一个高度可定制的 Android 图像选择器。它允许用户从设备中选择图片,并提供了丰富的自定义选项,以适应不同的应用需求。FishBun 支持多种图片选择模式,包括单选和多选,并且可以轻松集成到任何 Android 项目中。
项目快速启动
添加依赖
首先,在项目的 build.gradle
文件中添加 JitPack 仓库:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
然后在 app
模块的 build.gradle
文件中添加 FishBun 依赖:
dependencies {
implementation 'com.github.sangcomz:FishBun:1.0.0-alpha01'
}
初始化 FishBun
在您的 Activity 或 Fragment 中初始化 FishBun:
FishBun.with(YourActivity.this)
.setImageAdapter(new GlideAdapter())
.startAlbum();
处理选择结果
重写 onActivityResult
方法以处理用户选择的图片:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == FishBun.FISHBUN_REQUEST_CODE && resultCode == RESULT_OK) {
List<Uri> path = data.getParcelableArrayListExtra(FishBun.INTENT_PATH);
// 处理选择的图片路径
}
}
应用案例和最佳实践
单选模式
如果您只需要用户选择一张图片,可以使用单选模式:
FishBun.with(YourActivity.this)
.setImageAdapter(new GlideAdapter())
.setMaxCount(1)
.startAlbum();
多选模式
如果需要用户选择多张图片,可以设置最大选择数量:
FishBun.with(YourActivity.this)
.setImageAdapter(new GlideAdapter())
.setMaxCount(5)
.startAlbum();
自定义 UI
FishBun 允许您自定义 UI,例如更改主题颜色和按钮样式:
FishBun.with(YourActivity.this)
.setImageAdapter(new GlideAdapter())
.setPickerSpanCount(3)
.setActionBarColor(Color.parseColor("#FF0000"))
.startAlbum();
典型生态项目
FishBun 可以与其他流行的 Android 库和框架集成,例如:
- Glide: 用于图片加载和缓存。
- Retrofit: 用于网络请求,以便上传选择的图片。
- Room: 用于本地数据库存储图片信息。
通过这些集成,您可以构建一个完整的图片管理应用,从选择图片到上传和存储,形成一个完整的生态系统。
FishBun:blowfish:FishBun is Image Picker for android.项目地址:https://gitcode.com/gh_mirrors/fi/FishBun