Android 文件和图片选择器库（无需权限）

1. 项目介绍

本项目是一个Android库，旨在简化文件和图片的选择过程，无需申请任何存储权限。它支持从存储或相机中选择文件和图片，并且可以将它们转换为请求体，方便上传至服务器。该库的目的是减少处理文件选择的复杂性和上传文件所需的努力。

2. 项目快速启动

首先，您需要在项目的build.gradle文件中添加以下依赖项：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.atwa:filepicker:2.0.0'
}

然后，在您的Activity或Fragment中初始化FilePicker实例，并使用相应的方法来选择文件或图片。

private val filePicker = FilePicker.getInstance(this)

fun pickImage() {
    filePicker.pickImage { meta ->
        val name: String? = meta?.name
        val sizeKb: Int? = meta?.sizeKb
        val file: File? = meta?.file
        val bitmap: Bitmap? = meta?.bitmap
        // 处理图片选择后的逻辑
    }
}

// 更多选择方法参考官方文档

3. 应用案例和最佳实践

• 图片选择：在用户需要上传头像或图片时，使用pickImage方法。
• 多图片选择：在需要一次性选择多张图片的场景，使用pickMultiImage方法。
• 文件选择：在用户需要上传文件时，使用pickFile方法。
• 视频选择：在需要选择视频文件时，使用pickVideo方法。

请确保在调用这些方法时，正确处理返回的meta对象，以获取文件或图片的详细信息。

4. 典型生态项目

目前，该库作为一个独立组件被广泛用于多个Android项目中，以简化文件和图片的处理流程。以下是一些典型的使用场景：

• 社交媒体应用：用户发布动态时选择图片或视频。
• 在线教育应用：学生上传作业或教师分享教学资料。
• 文件管理应用：用户管理和上传文件。

通过上述介绍，您可以看到FilePicker库的灵活性和实用性，它可以帮助开发者节省时间并提升用户体验。