ImagePicker 快速上手5 分钟搞定 Android 图片选择器的集成与首次调用【免费下载链接】ImagePickerA customizable library for selecting images on the device.项目地址: https://gitcode.com/gh_mirrors/imagepi/ImagePickerImagePicker 是一款可高度定制的Android 图片选择器开源库支持从设备相册多选图片、调用相机拍照并提供丰富的 UI 自定义能力。本教程带你用 5 分钟完成依赖添加、注册选择器与首次调用三步走无复杂样板代码新手也能轻松上手。一、ImagePicker 能做什么在动手之前先花 30 秒了解这个 Android 图片选择器的核心能力相册选图支持单选/多选可按文件夹分组浏览相机拍照内置拍照模式照片自动保存到指定目录深度定制颜色、图标、提示文案、网格列数、排序方式均可配置接入简单Activity 与 Fragment 通用基于ActivityResult实现权限处理已内置项目结构速览后文示例会引用到模块路径说明库源码imagepicker/src/main/java/com/nguyenhoanglam/imagepicker/图片选择器核心实现示例工程example/src/main/java/com/imagepicker/example/完整可运行的 Demo二、一键安装添加 ImagePicker 依赖第 1 步在settings.gradle中添加 JitPack 仓库dependencyResolutionManagement { repositories { ... maven { url https://jitpack.io } } }第 2 步在 App 模块的build.gradle中添加依赖dependencies { implementation com.github.nguyenhoanglam:ImagePicker:1.6.4 }依赖坐标即最新版 1.6.4Sync 后即可在项目中引用。三、注册图片选择器registerImagePicker在Activity或Fragment中定义一个类级别变量注意不要放在回调函数里注册private val launcher registerImagePicker { images - if (images.isNotEmpty()) { val uri images[0].uri // 第一张图片的地址 } }回调中的images就是用户选中或拍摄的图片列表。registerImagePicker的注册逻辑见 ImagePicker.kt。四、首次调用两种启动方式默认配置启动——最简单的方式一行代码launcher.launch()自定义配置启动——通过ImagePickerConfig控制行为最常用的三个选项val config ImagePickerConfig( isFolderMode true, // 按文件夹分组 isShowCamera true, // 显示相机按钮 limitSize 10 // 最多选择 10 张 ) launcher.launch(config)所有可配置项30 个集中在 ImagePickerConfig.kt下面是最常调的几个。五、常用配置项速查表配置项作用默认值isCameraMode直接打开相机拍照忽略大部分其他选项falseisSingleSelectMode选中即返回适合头像等单图场景falseisFolderMode是否按文件夹分组展示trueisShowCamera是否显示相机按钮truelimitSize最大可选图片数不限制imageGridCount图片网格列数竖屏/横屏GridCount(3, 5)selectedIndicatorType选中标识数字或打勾数字rootDirectory/subDirectory拍照图片的保存目录DCIM/ 应用名selectedImages打开选择器时预先标记为已选的图片空列表customColor/customDrawable/customMessage自定义颜色、图标、提示文案默认主题 小技巧想改主题色只需覆盖CustomColor中的toolbar、selectedImageIndicator等字段即可无需改任何布局。六、跟着示例学example 工程怎么写的仓库自带一个功能完整的示例工程可以直接对照学习Activity 接入MainActivity.kt 演示了如何组合全部配置项文件夹模式、单选模式、相机模式、自定义颜色与文案并启动选择器还展示了把选中的图片回填到列表的效果Fragment 接入MainFragment.kt 演示了在 Fragment 中注册并调用图片选择器开关调试界面activity_main.xml 中的开关组对应上面速查表里的每个选项非常适合边调边看效果七、常见问题FAQQ1registerImagePicker报错或回调不生效必须把launcher声明为类的成员变量不能在onCreate之外的运行时动态注册否则会在状态恢复时失败。Q2相机拍的照片存在哪里默认保存在设备DCIM目录下、以应用名为子文件夹的位置可通过rootDirectory和subDirectory修改例如保存到Downloads目录下的自定义文件夹。Q3如何编辑时保留用户之前选中的图片把上次的结果通过selectedImages传入配置打开选择器时这些图片会自动标记为已选中。Q4提示没有相册权限权限申请由库自动处理被拒时会显示customMessage中定义的提示文案可将其改成符合你应用的中文提示。 至此你已经完成了 Android 图片选择器 ImagePicker 的依赖安装、注册与首次调用。后续想打造暗黑风相册或九宫格头像选择器只需在ImagePickerConfig中继续调整参数即可——完整选项说明见 README.md。【免费下载链接】ImagePickerA customizable library for selecting images on the device.项目地址: https://gitcode.com/gh_mirrors/imagepi/ImagePicker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
