Android目录选择器指南：Android-DirectoryChooser-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00951/article/details/141316599

Android目录选择器指南：Android-DirectoryChooser

Android-DirectoryChooserA directory chooser library for Android.项目地址:https://gitcode.com/gh_mirrors/an/Android-DirectoryChooser

项目介绍

Android-DirectoryChooser 是由 Passy 开发的一款简洁的目录选择库，专为简化在Android应用程序中集成友好型目录选取功能而设计。该库源自于AntennaPod项目中的目录选择组件，适用于希望让用户能够浏览并选择存储路径的应用程序。自适应Android API级别11及以上版本，且不依赖其他额外库，使得它成为众多开发者的选择。

项目快速启动

要迅速将 Android-DirectoryChooser 引入你的项目，首先确保你的开发环境支持Gradle插件，并遵循以下步骤：

添加依赖

打开你的项目的build.gradle(Module)文件，添加JitPack仓库以及库的依赖：

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

dependencies {
    implementation 'com.github.passy:Android-DirectoryChooser:vX.Y.Z'  // 替换X.Y.Z为最新的版本号
}

使用示例

在你需要展示目录选择界面的地方调用库提供的方法，示例如下：

import net.rdrei.android.dirchooser.DirectoryChooserActivity;

...

Intent intent = new Intent(this, DirectoryChooserActivity.class);
startActivityForResult(intent, REQUEST_CODE_PICK_DIRECTORY);

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_CODE_PICK_DIRECTORY && resultCode == RESULT_OK) {
        String selectedDirectoryPath = data.getStringExtra(DirectoryChooserActivity.EXTRA_SELECTED_PATH);
        // 处理选择的目录路径
    }
}

记住替换REQUEST_CODE_PICK_DIRECTORY为你自定义的请求码。

应用案例和最佳实践

在实际应用中，为了提供更佳用户体验，可以定制化对话框样式，例如设置初始目录或者限制只允许选择可读写目录：

intent.putExtra(DirectoryChooserActivity.EXTRA_ALLOW_MULTIPLE_SELECTION, false); // 是否允许多选
intent.putExtra(DirectoryChooserActivity.EXTRA_START_PATH, "/storage/emulated/0"); // 设置起始目录
intent.putExtra(DirectoryChooserActivity.EXTRA_ONLY_DIRS, true); // 只允许选择目录
intent.putExtra(DirectoryChooserActivity.EXTRA_READ_ONLY, false); // 允许选择只读目录或读写目录

通过这些参数配置，你可以灵活地调整目录选择器以满足特定需求。