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: 用于本地数据库存储图片信息。

通过这些集成，您可以构建一个完整的图片管理应用，从选择图片到上传和存储，形成一个完整的生态系统。