【亲测免费】 Android 文件选择器库 AndroidFilePicker 教程

1. 项目介绍

AndroidFilePicker 是由 rosuH 开发的一个轻量级、高效的 Android 本地文件选择器框架。它的目标是简化集成过程，提供高度自定义和配置选项。该库支持 AndroidX，并具有灵活的权限管理机制，允许开发者根据需求自行请求权限。

2. 项目快速启动

添加依赖

在你的 build.gradle 文件中添加以下依赖项：

dependencies {
    implementation 'me.rosuh:AndroidFilePicker:$latest_version'
}

确保替换 $latest_version 为最新版本号，可从 GitHub releases 获取。

使用步骤

1. 在需要调用文件选择器的地方，创建 FilePickerManager 实例：

   val filePicker = FilePickerManager.from(this)
   

2. 设置请求码并启动选择器：

   filePicker.forResult(FilePickerManager.REQUEST_CODE)
   

3. 处理回调结果： 在你的 Activity 或 Fragment 的 onActivityResult() 方法中：

   override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
       super.onActivityResult(requestCode, resultCode, data)
       if (requestCode == FilePickerManager.REQUEST_CODE) {
           if (resultCode == Activity.RESULT_OK) {
               val fileList = FilePickerManager.instance.obtainData()
               // 处理选取的文件列表
           } else {
               // 用户未选择任何文件
           }
       }
   }
   

3. 应用案例和最佳实践

• 最佳实践是在用户需要访问文件时才请求权限，而不是在应用启动时。
• 自定义主题颜色以匹配你的应用风格，通过设置文件选择器的主题属性。
• 当不需要文件选择器时，确保正确地清理资源，避免内存泄漏。

4. 典型生态项目

虽然 AndroidFilePicker 是一个独立的库，但可以与其他Android开发工具配合使用，例如：

• Matisse: 也是一个文件选择库，提供了类似的功能，可以作为替代方案或者灵感来源。
• Android Jetpack Components: 可以与Android Room、ViewModel等组件结合，用于存储和管理选择的文件数据。

了解更多详情和示例，参考AndroidFilePicker的GitHub仓库 和 README。