文件筛选库（按照某固定类型筛选）

FilePicker是一个Android版本的文件筛选库。 GitHub仓库地址

引入

gradle

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
//文件搜索公共库
implementation 'com.github.DL-ZhangTeng.FilePicker:filepicker-searchfilelibrary:1.2.0'
//UI 公共库
implementation 'com.github.DL-ZhangTeng.FilePicker:filepicker-common:1.2.0'
    //使用的三方库
    implementation 'com.github.bumptech.glide:glide:4.12.0'
    implementation 'com.github.DL-ZhangTeng:RequestPermission:1.2.0'
//压缩包UI
implementation 'com.github.DL-ZhangTeng.FilePicker:filepicker-rarpicker:1.2.0'
    //使用的三方库
    implementation 'com.github.DL-ZhangTeng:RequestPermission:1.2.0'
    implementation 'com.github.DL-ZhangTeng:Utils:2.0.1'
//文件夹UI
implementation 'com.github.DL-ZhangTeng.FilePicker:filepicker-folderpicker:1.2.0'
    //使用的三方库
    implementation 'com.github.DL-ZhangTeng:RequestPermission:1.2.0'
    implementation 'com.github.DL-ZhangTeng:Utils:2.0.1'
//图片UI
implementation 'com.github.DL-ZhangTeng.FilePicker:filepicker-imagepicker:1.2.0'
    //使用的三方库
    implementation 'com.github.DL-ZhangTeng:RequestPermission:1.2.0'
    implementation 'com.github.DL-ZhangTeng:Utils:2.0.1'
//视频UI
implementation 'com.github.DL-ZhangTeng.FilePicker:filepicker-videopicker:1.2.0'
    //使用的三方库
    implementation 'com.github.DL-ZhangTeng:RequestPermission:1.2.0'
    implementation 'com.github.DL-ZhangTeng:Utils:2.0.1'
//音频UI
implementation 'com.github.DL-ZhangTeng.FilePicker:filepicker-audiopicker:1.2.0'
    //使用的三方库
    implementation 'com.github.DL-ZhangTeng:RequestPermission:1.2.0'
    implementation 'com.github.DL-ZhangTeng:Utils:2.0.1'
//文档UI
implementation 'com.github.DL-ZhangTeng.FilePicker:filepicker-documentpicker:1.2.0'
    //使用的三方库
    implementation 'com.github.DL-ZhangTeng:RequestPermission:1.2.0'
    implementation 'com.github.DL-ZhangTeng:Utils:2.0.1'
//或直接使用
implementation 'com.github.DL-ZhangTeng:FilePicker:1.2.0'
    //使用的三方库
    implementation 'com.github.bumptech.glide:glide:4.12.0'
    implementation 'com.github.DL-ZhangTeng:RequestPermission:1.2.0'
    implementation 'com.github.DL-ZhangTeng:Utils:2.0.1'
    implementation('com.github.DL-ZhangTeng:BaseLibrary:2.0.1') {
        transitive false
    }

效果图

检索结果(只是用searchfilelibrary时)

获取检索结果提供了2种方式（具体可参照GitHub源码） 1、 public void getMediaList(int fileModel, Context context) 查找结果放于MediaStoreUtil相应的字段内； MediaStoreUtil提供了数据改变监听解决办法，通过观察者模式向所有注册了MediaStoreListener的对象发送数据改变结果，添加数据监听 public static void setListener(MediaStoreListener listener) 移除数据监听 public static void removeListener(int index) public static void removeListener(MediaStoreListener listener)

2、 public void getMediaList(int searchId, Handler handler) 查找结果交给handler处理 Message message = new Message(); message.what = GetListCallbak.SUCCESS; message.obj = list; handler.sendMessage(message);

使用方法：开启服务根据需要调用服务的相应public方法

public class FolderPickerFragment extends Fragment {
    
    //...
     
     private void searchFile() {
          FileService.getInstance().getFileList(null);
          MediaStoreUtil.setListener(new MediaStoreUtil.FolderListener() {

               @Override
               public void onFolderChange(int imageCount, List<MediaEntity> folders) {
                    imageInfos.clear();
                    imageInfos.addAll(folders);
                    if (getActivity() == null) {
                         return;
                    }
                    getActivity().runOnUiThread(() -> folderPickerAdapter.notifyDataSetChanged());
               }
          });
     }
}

UI属性

属性名	描述
multiSelect	是否单选，默认true
maxSize	配置开启多选时最大可选择的图片数量。默认：9
isShowCamera	是否在第一格显示拍照或录制，默认true（只有图片视频音频有效）
filePath	拍照以及截图后存放的位置。默认：/filePicker/FilePicker
provider	文件提供者，默认com.zhangteng.searchfilelibrary.fileprovider
pathList	已选择照片的路径
isOpenCamera	是否直接开启相机或录制默认：false（只有图片视频音频有效）
iconResources	icon资源（可设置每种类型的icon，文档类型中pdf、txt、word、excel等可单独设置）

使用

  //使用UI(直接使用UI中的Fragment)
  public class FilePickerAdapter extends FragmentPagerAdapter {
    private String[] titles = {"image", "video", "audio", "rar", "document", "folder"};
    private ArrayList<Fragment> fragmentlist = new ArrayList<Fragment>();

    public FilePickerAdapter(FragmentManager fm) {
        super(fm);
    }

    public ArrayList<Fragment> getFragmentlist() {
        return fragmentlist;
    }

    @Override
    public Fragment getItem(int position) {
        Fragment fragment = null;
        switch (position) {
            case 0:
                fragment = new ImagePickerFragment();
                break;
            case 1:
                fragment = new VideoPickerFragment();
                break;
            case 2:
                fragment = new AudioPickerFragment();
                break;
            case 3:
                fragment = new RarPickerFragment();
                break;
            case 4:
                fragment = new DocumentPickerFragment();
                break;
            case 5:
                fragment = new FolderPickerFragment();
                break;
            default:
                break;
        }
        fragmentlist.add(fragment);
        return fragment;
    }

    @Override
    public CharSequence getPageTitle(int position) {
        return titles[position];
    }

    @Override
    public int getCount() {
        return titles.length;
    }
}

  //使用UI(直接使用UI中的Activity)
    //  startActivity(new Intent(this, ImagePickerActivity.class));
    //  startActivity(new Intent(this, VideoPickerActivity.class));
    //  startActivity(new Intent(this, AudioPickerActivity.class));
    //  startActivity(new Intent(this, RarPickerActivity.class));
    //  startActivity(new Intent(this, DocumentPickerActivity.class));
    //  startActivity(new Intent(this, FolderPickerActivity.class));
  //使用UI时-文件选择回调
    //public class HandlerCallBack implements IHandlerCallBack {
    //    private String TAG = "---ImagePicker---";
    //
    //    @Override
    //    public void onStart() {
    //        Log.i(TAG, "onStart: 开启");
    //    }
    //
    //    @Override
    //    public void onSuccess(List<MediaEntity> audioList) {
    //        Log.i(TAG, "onSuccess: 返回数据");
    //    }
    //
    //    @Override
    //    public void onCancel() {
    //        Log.i(TAG, "onCancel: 取消");
    //    }
    //
    //    @Override
    //    public void onFinish(List<MediaEntity> selectAudio) {
    //        Log.i(TAG, "onFinish: 结束");
    //    }
    //
    //    @Override
    //    public void onError() {
    //        Log.i(TAG, "onError: 出错");
    //    }
    //
    //    @Override
    //    public void onPreview(List<MediaEntity> selectAudio) {
    //        Log.i(TAG, "onPreview: 预览");
    //    }
    //}
    //
    //  FilePickerConfig.getInstance()
    //          .iHandlerCallBack(new com.zhangteng.common.callback.HandlerCallBack() {
    //              @Override
    //              public void onFinish(List<MediaEntity> mediaEntities) {
    //                  super.onFinish(mediaEntities);
    //                       
    //              }
    //          });
  //使用UI时-修改文件图标
    //  FilePickerConfig.getInstance()
    //                .iconResources(MediaEntity.MEDIA_IMAGE, R.drawable.jpg)
    //                .iconResources(MediaEntity.MEDIA_AUDIO, R.drawable.audio)
    //                .iconResources(MediaEntity.MEDIA_VIDEO, R.drawable.video)
    //                .iconResources(MediaEntity.MEDIA_DOCUMENT, R.drawable.text)
    //                .iconResources(MediaEntity.MEDIA_ZIP, R.drawable.yasuo)
    //                .iconResources(MediaEntity.MEDIA_PDF, R.drawable.pdf)
    //                .iconResources(MediaEntity.MEDIA_DOC, R.drawable.word)
    //                .iconResources(MediaEntity.MEDIA_PPT, R.drawable.ppt)
    //                .iconResources(MediaEntity.MEDIA_EXCEL, R.drawable.excel)
    //                .iconResources(MediaEntity.MEDIA_TXT, R.drawable.text)
    //                .iconResources(MediaEntity.MEDIA_APK, R.drawable.yasuo)
    //                .iconResources(MediaEntity.MEDIA_FOLDER, R.drawable.wenjian)
    //                .iconResources(MediaEntity.MEDIA_UNKNOWN, R.drawable.weizhi);
  //使用UI时-修改底部功能条
    //在自己的layout文件加下新建
    //file_picker_layout_upload.xml
    //在功能条layout中添加3个TextView样式自定义id分别为
    //file_picker_tv_preview、file_picker_tv_selected、file_picker_tv_upload

混淆

-keep public class com.zhangteng.**.*{ *; }

历史版本

版本	更新	更新时间
v1.2.0	使用独立的Utils库	2022/9/2 at 20:50
v1.1.1	使用最新版本三方库	2022/6/30 at 11:19
v1.1.0	迁移到AndroidX、使用base库utils	2022/1/26 at 14:28
v1.0.3	返回选中的MediaEntity列表，配置类使用单例模式删除建造者模式	2020/9/16 0016 at 下午 15:26
v1.0.2	添加权限请求	2020/9/16 0016 at 上午 11:38
v1.0.1	样式自定义	2020/9/8 0008 at 下午 17:58

赞赏

如果您喜欢FilePicker，或感觉FilePicker帮助到了您，可以点右上角“Star”支持一下，您的支持就是我的动力，谢谢

联系我

邮箱：763263311@qq.com/ztxiaoran@foxmail.com

License

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.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

CandyTek/FilePicker