如何在Android项目中快速集成FishBun？5分钟上手教程

如何在Android项目中快速集成FishBun？5分钟上手教程

【免费下载链接】FishBun:blowfish:FishBun is Image Picker for android.项目地址: https://gitcode.com/gh_mirrors/fi/FishBun

FishBun是一款专为Android开发者打造的高效图片选择器，它提供了简洁的API和丰富的自定义选项，帮助你在应用中快速实现图片选择功能。本文将带你通过简单几步，在5分钟内完成FishBun的集成与基础使用。

准备工作：获取FishBun项目

首先需要将FishBun项目克隆到本地：

git clone https://gitcode.com/gh_mirrors/fi/FishBun

第一步：添加依赖

在你的Android项目中，打开build.gradle文件，添加FishBun依赖：

implementation project(':FishBun')

第二步：配置AndroidManifest.xml

FishBun需要一些必要的配置，确保在AndroidManifest.xml中添加以下内容：

<provider android:name="com.sangcomz.fishbun.FishBunFileProvider" android:authorities="${applicationId}.fishbunfileprovider" android:exported="false" android:grantUriPermissions="true"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/provider_paths" /> </provider> <activity android:name=".ui.album.ui.AlbumActivity" android:label="@string/album" android:theme="@style/FishBunTheme"/> <activity android:name=".ui.picker.PickerActivity" android:theme="@style/FishBunTheme" /> <activity android:name=".ui.detail.ui.DetailImageActivity" android:theme="@style/DetailViewTheme" />

第三步：请求必要权限

FishBun需要访问设备的照片和媒体文件权限。当应用运行时，会弹出权限请求对话框：

确保用户授予"允许访问照片、媒体和文件"权限，这是FishBun正常工作的基础。

第四步：基础使用代码

在你的Activity或Fragment中，使用以下代码启动FishBun图片选择器：

FishBun.with(this) .setImageAdapter(GlideAdapter()) // 使用Glide加载图片 .setSelectedImages(selectedImages) // 设置已选图片 .startAlbumWithActivityResultCallback(callback) // 启动相册选择

第五步：自定义配置选项

FishBun提供了丰富的自定义选项，让你可以根据应用需求调整图片选择器的外观和行为：

FishBun.with(this) .setImageAdapter(CoilAdapter()) // 支持Coil图片加载 .setMaxCount(5) // 设置最大选择数量 .setMinCount(3) // 设置最小选择数量 .setPickerSpanCount(5) // 设置选择器网格列数 .enableEdgeToEdge(true) // 启用边缘到边缘显示 .setActionBarColor( // 设置操作栏颜色 Color.parseColor("#795548"), Color.parseColor("#5D4037"), false ) .hasCameraInPickerPage(true) // 在选择页面显示相机 .exceptMimeType(arrayListOf(MimeType.GIF)) // 排除GIF格式 .startAlbum() // 启动相册

总结

通过以上五个简单步骤，你已经成功在Android项目中集成了FishBun图片选择器。FishBun的强大之处在于其简洁的API和丰富的自定义选项，让你能够快速实现符合应用风格的图片选择功能。无论是简单的图片选择还是复杂的自定义需求，FishBun都能满足你的开发需求。

现在，你可以开始探索FishBun更多高级功能，如主题定制、图片预览和相机集成等，为你的应用添加更加丰富的媒体选择体验。

【免费下载链接】FishBun:blowfish:FishBun is Image Picker for android.项目地址: https://gitcode.com/gh_mirrors/fi/FishBun