NoNonsense-FilePicker 开源项目教程

NoNonsense-FilePicker 开源项目教程

NoNonsense-FilePickerA file/directory-picker for android. Implemented as a library project.项目地址:https://gitcode.com/gh_mirrors/no/NoNonsense-FilePicker

项目介绍

NoNonsense-FilePicker 是一个用于 Android 的文件/目录选择器，由 @spacecowboy 开发并在 GitHub 上开源。该项目的主要特点包括：

• 易于扩展：支持 SD 卡上的普通文件以及通过 Dropbox API 等外部源。
• 能够在选择器中创建新目录。
• 支持多选、选择目录或文件或两者。
• 使用 Material 主题与 AppCompat。

项目快速启动

添加依赖

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

repositories {
    jcenter()
}

dependencies {
    compile 'com.nononsenseapps:filepicker:3.0.0'
}

配置权限和活动

在你的 AndroidManifest.xml 文件中添加必要的权限和活动配置：

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

<activity
    android:name="com.nononsenseapps.filepicker.FilePickerActivity"
    android:label="@string/app_name"
    android:theme="@style/FilePickerTheme">
    <intent-filter>
        <action android:name="android.intent.action.GET_CONTENT" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

启动文件选择器

在你的代码中启动文件选择器：

Intent i = new Intent(this, FilePickerActivity.class);
startActivityForResult(i, REQUEST_CODE);

处理选择结果

在 onActivityResult 方法中处理选择结果：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_CODE && resultCode == Activity.RESULT_OK) {
        if (data.getBooleanExtra(FilePickerActivity.EXTRA_ALLOW_MULTIPLE, false)) {
            ArrayList<String> paths = data.getStringArrayListExtra(FilePickerActivity.EXTRA_PATHS);
            if (paths != null) {
                for (String path : paths) {
                    Uri uri = Uri.parse(path);
                    // 处理 URI
                }
            }
        } else {
            Uri uri = data.getData();
            // 处理 URI
        }
    }
}

应用案例和最佳实践

自定义文件选择器

你可以通过扩展 AbstractFilePickerActivity 和实现 getFragment 方法来自定义文件选择器：

public class MyPickerActivity extends AbstractFilePickerActivity<File> {
    public MyPickerActivity() {
        super();
    }

    @Override
    protected AbstractFilePickerFragment<File> getFragment(
            @Nullable String startPath, int mode, boolean allowMultiple,
            boolean allowCreateDir, boolean allowExistingFile,
            boolean singleClick) {
        AbstractFilePickerFragment<File> fragment = new MyPickerFragment();
        fragment.setArgs(startPath, mode, allowMultiple, allowCreateDir, allowExistingFile, singleClick);
        return fragment;
    }
}

使用 Dropbox API

项目示例中包含了一个使用 Dropbox API 的示例，展示了如何将外部源集成到文件选择器中。

典型生态项目

NoNonsense-FilePicker 可以与其他 Android 开发库和工具结合使用，例如：

• Retrofit：用于处理网络请求。
• Glide：用于图片加载和缓存。
• Room：用于数据库操作。

这些工具和库可以与 NoNonsense-FilePicker 一起使用，以构建功能丰富的 Android 应用程序。

---

以上是 NoNonsense-FilePicker 开源项目的详细教程，涵盖了项目介绍、快速启动、应用案例和最佳实践以及典型生态项目。希望这些内容能帮助你更好地理解和使用该开源项目。

NoNonsense-FilePickerA file/directory-picker for android. Implemented as a library project.项目地址:https://gitcode.com/gh_mirrors/no/NoNonsense-FilePicker