探索优雅的图片选择：Pluck - Compose 图片库

在您的 Jetpack Compose 项目中寻找一个简单易用的图片选择器吗？欢迎尝试 Pluck，这是一个专为 Android 开发者打造的 Material You 风格的图像选择库，支持从相册和相机选取图像。

创建者: 由 Himanshu 精心制作并分享给所有 Android 开发者
版本信息: 查看 Maven Central 获取最新版本

快速集成

在开始之前，请确保在 AndroidManifest.xml 文件中添加了以下权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

接下来，在应用模块的 build.gradle 文件中添加依赖项：

dependencies {
  implementation("com.himanshoe:pluck:1.0.0-RC2")
}

使用教程

使用 Pluck 只需几步：

1. 调用可组合元素 Pluck 并设置图片选中回调：

   Pluck(onPhotoSelected = {
       // 处理选中的 PluckImage 列表。从相机获取时，列表仅包含一项
   })
   

2. 如果希望 Pluck 自动处理权限请求，可以这样：

   Permission(
       permissions = listOf(
           Manifest.permission.CAMERA,
           Manifest.permission.READ_EXTERNAL_STORAGE
       ),
       goToAppSettings = {
           // 导航到应用设置
       }
   ) {
       Pluck(onPhotoSelected = {
           // 处理选中的 PluckImage 列表
       })
   }
   

3. 要配置是否允许从相册选择多张图片，调整 PluckConfiguration：

   Pluck(
       pluckConfiguration = PluckConfiguration(multipleImagesAllowed = true),
       onPhotoSelected = {}
   )
   

应用场景与特性

• 适用于各种应用场景: 无论是在社交应用中上传照片，还是在图片编辑应用中选择源文件，Pluck 都能轻松胜任。
• Material You 设计: 充分利用现代 Android 的设计语言，提供一致且美观的用户体验。
• 自动权限管理: 用户不再需要因权限问题而困扰，Pluck 会自动请求并处理相关权限。
• 灵活配置: 支持单图和多图选择模式，可根据应用需求进行定制。

别忘了，如果你喜欢这个项目并希望看到更多更新，给它点个 star 吧！更多的精彩更新即将到来！

让我们一起体验 Pluck 带来的便捷与高效，提升你的 Android 应用程序的图片选择体验吧！