# mlhfileselectorlib **Repository Path**: lovecoding/mlhfileselectorlib ## Basic Information - **Project Name**: mlhfileselectorlib - **Description**: 🔥🔥🔥文件或路径选择，自动申请存储权限，支持安卓4.4 ~ 12，支持Android/data目录访问，支持自定义UI，支持SD卡。(Provide file or path selection, automatically apply for storage permission, support Android 4.4 to 12, support Android/data directory access, support custom UI,Support SD card.The Keyword:file selector operator android/data android 11) - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 8 - **Created**: 2025-05-23 - **Last Updated**: 2025-05-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

Banner

mlhfileselector

[![Maven Central](https://img.shields.io/maven-central/v/io.github.molihuan/pathselector.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22io.github.molihuan%22%20AND%20a:%22pathselector%22)[![jitpack](https://jitpack.io/v/molihuan/mlhfileselectorlib.svg)](https://jitpack.io/#molihuan/mlhfileselectorlib)![API: 19-33 (shields.io)](https://img.shields.io/badge/API-19--33-green)[![license: Apache-2.0 (shields.io)](https://img.shields.io/badge/license-Apache--2.0-brightgreen)](https://github.com/molihuan/mlhfileselectorlib/blob/master/LICENSE)[![Star](https://img.shields.io/github/stars/molihuan/mlhfileselectorlib.svg)](https://github.com/molihuan/mlhfileselectorlib)[![bilibili: 玲莫利 (shields.io)](https://img.shields.io/badge/bilibili-玲莫利-orange)](https://space.bilibili.com/454222981)[![CSDN: molihuan (shields.io)](https://img.shields.io/badge/CSDN-molihuan-blue)](https://blog.csdn.net/molihuan)

Andriod上提供文件或路径选择的第三方库

自动申请存储权限，支持安卓4.4 ~ 13，支持Android/data和Android/obb目录访问，

支持自定义UI，支持SD卡。

(Library that provides file or path selection on Android, automatically apply for storage permission, support Android 4.4 to 13, support Android/data and Android/obb directory access, support custom UI,support SD card.The Keyword:file selector operator android/data android 11 android 13)

## 语言(Language) #### **[中文](./README.md)** | [English](./README_EN.md) ## 为什么选择我 自动申请存储权限，支持 Android4.4 ~ 13，再也不用为了适配各种版本而苦恼了，快速集成，一句代码搞定，完善的文档，支持无root权限访问和操作Android/data和Android/obb目录(适配Android 13)，支持SD卡，高度自定义UI满足你的所有需求，使用非常灵活，支持国际化，对于Android文件选择你只需要关注你的业务代码即可其他的都交给它。 ## 特性 - [x] 自动申请存储权限(可以控制) - [x] 安卓 4.4 ~ 13 - [x] Android/data和Android/obb目录访问和操作 - [x] SD卡 - [x] 高度自定义UI - [x] 国际化 - [ ] 搜索功能 - [x] 自定义图标 - [ ] 显示隐藏文件 ## 前言 #### 在开始之前可以给项目一个Star吗？非常感谢，你的支持是我唯一的动力。欢迎Star和Issues! #### 我们需要你的Pr，注意(请提交到dev分支) #### 项目地址： ##### [Github地址](https://github.com/molihuan/mlhfileselectorlib) ##### [Gitee地址](https://gitee.com/molihuan/mlhfileselectorlib) ## demo演示： #### 系统版本：Android 13 #### 下载链接：[体验APP](https://github.com/molihuan/mlhfileselectorlib/tree/master/app/release) ![pathSelectorDemo.gif](https://s2.loli.net/2022/12/14/QSGrIvwzYKhZuMe.gif) ## 一、快速开始 #### 第1步：添加仓库: - ##### 如果你的项目 Gradle 配置是在 `7.0 以下`，需要在 `build.gradle` 文件中加入 ```java allprojects { repositories { ... mavenCentral() maven { url 'https://jitpack.io' } } } ``` - ##### 如果你的 Gradle 配置是 `7.0 及以上`，则需要在 `settings.gradle` 文件中加入 ```java dependencyResolutionManagement { repositories { ... mavenCentral() maven { url 'https://jitpack.io' } } } ``` #### 第2步：添加远程依赖: - ##### 配置完远程仓库后，在项目 app 模块下的 `build.gradle` 文件中加入远程依赖 - ##### 最新发布版:[![Maven Central](https://img.shields.io/maven-central/v/io.github.molihuan/pathselector.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22io.github.molihuan%22%20AND%20a:%22pathselector%22) ```java dependencies { ... // 建议使用最新发布版，最新发布版请看上面 // 请将"版本"替换成具体的版本号，如 1.1.16 implementation 'io.github.molihuan:pathselector:版本' } ``` #### 第3步：基本用法示范: ```java //如果没有权限会自动申请权限 PathSelector.build(this, MConstants.BUILD_DIALOG)//Dialog构建方式 .setMorePopupItemListeners( new CommonItemListener("OK") { @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { /**取消dialog弹窗 * pathSelectFragment.close(); */ StringBuilder builder = new StringBuilder(); builder.append("you selected:\n"); for (FileBean fileBean : selectedFiles) { builder.append(fileBean.getPath() + "\n"); } Mtools.toast(builder.toString()); return false; } } ) .show();//开始构建 ``` ## 二、基本设置 #### 打开调试模式 ```java //开启调试模式，生产环境请关闭 PathSelectorConfig.setDebug(true); //或者PathSelector.setDebug(true); ``` #### 1、Activity构建模式： ```java //Activity构建方式 PathSelectFragment selector = PathSelector.build(this, MConstants.BUILD_ACTIVITY) .setRequestCode(635) .setMorePopupItemListeners( new CommonItemListener("OK") { @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { StringBuilder builder = new StringBuilder(); builder.append("you selected:\n"); for (FileBean fileBean : selectedFiles) { builder.append(fileBean.getPath() + "\n"); } Mtools.toast(builder.toString()); return false; } } ) .show(); ``` #### 2、Fragment构建模式： ##### 第1步：在你需要显示的布局文件xml中使用FrameLayout占位 ```xml ``` ##### 第2步：编写代码 ```java //获取PathSelectFragment实例然后在onBackPressed中处理返回按钮点击事件 PathSelectFragment selector = PathSelector.build(this, MConstants.BUILD_FRAGMENT) .setFrameLayoutId(R.id.fragment_select_show_area)//加载位置,FrameLayout的ID .setMorePopupItemListeners( new CommonItemListener("OK") { @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { StringBuilder builder = new StringBuilder(); builder.append("you selected:\n"); for (FileBean fileBean : selectedFiles) { builder.append(fileBean.getPath() + "\n"); } Mtools.toast(builder.toString()); return false; } } ) .show();//开始构建 ``` ##### 第3步：重写onBackPressed()方法让路径选择器优先处理返回按钮点击事件
非常重要!!!
非常重要!!!
非常重要!!!
##### 重要的事情说三遍 ```java @Override public void onBackPressed() { //让PathSelectFragment先处理返回按钮点击事件 if (selector != null && selector.onBackPressed()) { return; } ...... super.onBackPressed(); } ``` #### 3、Dialog构建模式 & 常用设置： ```java //获取PathSelectFragment实例然后在onBackPressed中处理返回按钮点击事件 PathSelectFragment selector = PathSelector.build(this, MConstants.BUILD_DIALOG) //.setBuildType(MConstants.BUILD_DIALOG)//已经在build中已经设置了 //.setContext(this)//已经在build中已经设置了 .setRootPath("/storage/emulated/0/")//初始路径 .setShowSelectStorageBtn(true)//是否显示内部存储选择按钮 .setShowTitlebarFragment(true)//是否显示标题栏 .setShowTabbarFragment(true)//是否显示面包屑 .setAlwaysShowHandleFragment(true)//是否总是显示长按弹出选项 .setShowFileTypes("", "mp3", "mp4")//只显示(没有后缀)或(后缀为mp3)或(后缀为mp4)的文件 .setSelectFileTypes("", "mp3")//只能选择(没有后缀)或(后缀为mp3)的文件 .setMaxCount(3)//最多可以选择3个文件,默认是-1不限制 .setRadio()//单选(如果需要单选文件夹请使用setMaxCount(0)来替换) .setSortType(MConstants.SORT_NAME_ASC)//按名称排序 .setTitlebarMainTitle(new FontBean("My Selector"))//设置标题栏主标题,还可以设置字体大小,颜色等 .setTitlebarBG(Color.GREEN)//设置标题栏颜色 .setFileItemListener(//设置文件item点击回调(点击是文件才会回调,如果点击是文件夹则不会) new FileItemListener() { @Override public boolean onClick(View v, FileBean file, String currentPath, BasePathSelectFragment pathSelectFragment) { Mtools.toast("you clicked path:\n" + file.getPath()); return false; } } ) .setMorePopupItemListeners(//设置右上角选项回调 new CommonItemListener("SelectAll") { @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { pathSelectFragment.selectAllFile(true); return false; } }, new CommonItemListener("DeselectAll") { @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { pathSelectFragment.selectAllFile(false); return false; } } ) .setHandleItemListeners(//设置长按弹出选项回调 new CommonItemListener("OK") { @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { StringBuilder builder = new StringBuilder(); builder.append("you selected:\n"); for (FileBean fileBean : selectedFiles) { builder.append(fileBean.getPath() + "\n"); } Mtools.toast(builder.toString()); return false; } }, new CommonItemListener("cancel") { @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { pathSelectFragment.openCloseMultipleMode(false); return false; } } ) .show(); ``` ## 三、高级设置(自定义UI) #### UI布局： ![UiLayout.png](https://s2.loli.net/2022/12/14/Yw8bamgrtNC9yiW.png) #### 1、自定义选项样式(以HandleItem为例子) ##### 方式1:通过FontBean来设置样式 ```java PathSelectFragment selector = PathSelector.build(this, MConstants.BUILD_DIALOG) .setHandleItemListeners(//设置长按弹出选项回调 //FontBean可以设置文本、字的大小、字的颜色、字左边的图标 //R.drawable.ic_test_mlh是你自己的图片资源id new CommonItemListener(new FontBean("OK", 18, Color.RED, R.drawable.ic_test_mlh)) { @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { Mtools.toast("You Click"); return false; } } ) .show(); ```
什么？这种方式还不能满足你，那么试试方式2
##### 方式2:重写CommonItemListener的setViewStyle方法来自定义样式 ```java PathSelectFragment selector = PathSelector.build(this, MConstants.BUILD_DIALOG) .setHandleItemListeners( //重写CommonItemListener的setViewStyle方法来自定义样式 new CommonItemListener("OK") { @Override public boolean setViewStyle(RelativeLayout container, ImageView leftImg, TextView textView) { textView.setTextSize(18); textView.setTextColor(Color.RED); //默认是不显示图标的 leftImg.setVisibility(View.VISIBLE); leftImg.setImageResource(R.drawable.ic_test_mlh); leftImg.getLayoutParams().width = 90; leftImg.getLayoutParams().height = 90; return true; } @Override public boolean onClick(View v, TextView tv, List selectedFiles, String currentPath, BasePathSelectFragment pathSelectFragment) { Mtools.toast("You Click"); return false; } } ) .show(); ```

什么？什么？这种方式还不能满足你，那么你来写UI它来帮你添加，试试高度自定义UI

#### 2、高度自定义UI(以Titlebar为例子)： ##### 第1步：新建一个布局文件，如:fragment_custom_titlebar.xml ```xml