# FileSelector **Repository Path**: ReferLib/FileSelector ## Basic Information - **Project Name**: FileSelector - **Description**: Android 文件选择器，指定选择文件夹还是文件，根据后缀名过滤，支持多选 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2024-08-09 - **Last Updated**: 2025-06-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ### 介绍 --- 1. 可指定选择文件夹还是文件，选择显示文件也可指定后缀名显示获取连接 2. 可通过扫描全盘的方式，选择指定后缀名的文件 3. 支持多选。 4. 支持Activity、Fragment 5. 支持androidX 6. 自定义标题颜色 ### Example --- 图片名称

--- ### 可下载APK直接体验 [Demo.apk](https://github.com/ZLYang110/FileSelector/blob/master/app/release/app-release.apk) --- ### 用法 ``` allprojects { repositories { ... maven { url 'https://www.jitpack.io' } } } ``` ``` //AndroidX implementation 'com.github.ZLYang110:FileSelector:2.1.6' //support //implementation 'com.github.ZLYang110:FileSelector:1.0.2' ``` ##### 一、在文件浏览器中选择指定文件 ``` /** * 设置 onlyShowFolder() 只显示文件夹后再设置setFileTypes（）不生效 * 设置 onlyShowFolder() 只显示文件夹后默认设置了onlySelectFolder（） * 设置 onlySelectFolder() 只能选择文件夹后默认设置了isSingle（） * 设置 isSingle() 只能选择一个后再设置了setMaxCount（）不生效 * */ FileSelector.from(this) // .onlyShowFolder() //只显示文件夹 //.onlySelectFolder() //只能选择文件夹 // .isSingle() // 只能选择一个 .setMaxCount(5) //设置最大选择数 .setFileTypes("png", "doc","apk", "mp3", "gif", "txt", "mp4", "zip", "pdf") //设置文件类型 .setSortType(FileSelector.BY_NAME_ASC) //设置名字排序 //.setSortType(FileSelector.BY_TIME_ASC) //设置时间排序 //.setSortType(FileSelector.BY_SIZE_DESC) //设置大小排序 //.setSortType(FileSelector.BY_EXTENSION_DESC) //设置类型排序 .requestCode(1) //设置返回码 .setTargetPath("/storage/emulated/0/Android/data/") //设置默认目录 .start(); ``` ##### 二、设置只选择文件夹（文件夹默认只能选择一个） ``` FileSelector.from(this) .onlySelectFolder() //只能选择文件夹 .requestCode(1) //设置返回码 .start(); ``` ##### 三、设置只显示文件夹（只显示文件夹就只能选择文件夹） ``` FileSelector.from(this) .onlyShowFolder() //只能选择文件夹 .requestCode(1) //设置返回码 .start(); ``` ##### 四、只显示图片的文件 ``` FileSelector.from(this) .setMaxCount(5) //设置最大选择数 .setFileTypes( "png","jpg") //设置文件类型 .requestCode(1) //设置返回码 .start(); ``` ##### 五、只显示pdf文件 ``` FileSelector.from(this) .setMaxCount(1) //设置最大选择数 .setFileTypes( "pdf") //设置文件类型 .requestCode(1) //设置返回码 .start(); ``` ##### 六、自定义标题颜色 ``` FileSelector.from(this) .setTilteBg(R.color.titleBg) //不填写默认是： ?attr/colorPrimary .setTitleColor(R.color.themeRed)//不填写默认白色 .setTitleLiftColor(R.color.text_accent)//不填写默认白色 .setTitleRightColor(R.color.face_text)//不填写默认白色 .setMaxCount(5) //设置最大选择数 .setFileTypes("png","jpg", "doc","apk", "mp3", "gif", "txt", "mp4", "zip") //设置文件类型 .setSortType(FileSelector.BY_NAME_ASC) //设置名字排序 .requestCode(1) //设置返回码 .start(); ``` ##### 七、接收返回的文件数据，在 ++onActivityResult++ 方法中获取。选中文件以链表方式返回， ++EssFile++ 类为载体 ``` @Override public void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) { super.onActivityResult(requestCode, resultCode, data); if (requestCode == 1) { if(data!=null){ ArrayList essFileList = data.getStringArrayListExtra(Const.EXTRA_RESULT_SELECTION); StringBuilder builder = new StringBuilder(); for (String file : essFileList) { builder.append(file).append("\n"); } tv_backResult.setText(builder.toString()); } } } ``` ### 属性列表 --- 名称 | 描述 | 默认值 ---|---|--- FileTypes | 需要显示的文件类型 | 无 SortType | 排序类型 | 按名字排序 BY_NAME_ASC isSingle | 是否单选 |false maxCount | 最大可选中数量 | 10 request_code | 请求码 | 无 onlyShowFolder | 是否仅只显示文件夹 | false onlySelectFolder | 是否只选择文件夹 | false setTilteBg | 设置标题背景颜色 | ?attr/colorPrimary setTitleColor | 设置标题颜色 | 白色 setTitleLiftColor | 设置标题左边箭头颜色 | 白色 setTitleRightColor | 设置标题右边字体颜色 | 白色 setTargetPath | 设置默认目录 | 根目录 # 更新日志 2.1.6 ---- - 优化已知问题 2.1.5 ---- - 优化已知问题 2.1.4 ---- - 设置默认目录 2.1.3 ---- - 优化程序，root路径先显示路径，同步加载文件列表等等 2.1.2 ---- - 解决点击路径无反应 2.1.1 ---- - 添加自定义标题 2.1.0 ---- - 添加Fragment 测试 2.0.0 ---- - 适配Androidx ### THANKS --- [陈宇明大师兄 BaseRecyclerViewAdapterHelper](https://github.com/CymChad/BaseRecyclerViewAdapterHelper) [FilePicker](https://github.com/imLibo/FilePicker) ## LICENSE MIT License Copyright (c) 2018 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.