Skip to content

Latest commit

 

History

History
150 lines (121 loc) · 6.39 KB

README.md

File metadata and controls

150 lines (121 loc) · 6.39 KB
Raw

Android-FilePicker

Android Arsenal Latest Version

A filepicker which allows to select images and videos with flexibility. It also supports selection of files by specifying its file type. Check out app module for example.

demo demo demo

Installation

  • As of now, It is only available in jCenter(), So just put this in your app dependencies:
    compile 'com.droidninja:filepicker:2.0.6'

Usage

Just include this in your onclick function:

  • For photopicker:
FilePickerBuilder.getInstance().setMaxCount(5)
               .setSelectedFiles(filePaths)
               .setActivityTheme(R.style.AppTheme)
               .pickPhoto(this);
  • For document picker:
 FilePickerBuilder.getInstance().setMaxCount(10)
               .setSelectedFiles(filePaths)
               .setActivityTheme(R.style.AppTheme)
               .pickFile(this);

After this, you will get list of file paths in activity result:

@Override
    public void onActivityResult(int requestCode, int resultCode, Intent data) {
           switch (requestCode)
           {
               case FilePickerConst.REQUEST_CODE_PHOTO:
                   if(resultCode== Activity.RESULT_OK && data!=null)
                   {
                       photoPaths = new ArrayList<>();
                       photoPaths.addAll(data.getStringArrayListExtra(FilePickerConst.KEY_SELECTED_MEDIA));
                   }
                   break;
               case FilePickerConst.REQUEST_CODE_DOC:
                   if(resultCode== Activity.RESULT_OK && data!=null)
                   {
                       docPaths = new ArrayList<>();
                       docPaths.addAll(data.getStringArrayListExtra(FilePickerConst.KEY_SELECTED_DOCS));
                   }
                   break;
           }
           addThemToView(photoPaths,docPaths);
       }

Builder Methods

Android FilePicker now has more flexibility. Supported builder methods are:

Method Use
setMaxCount(int maxCount) used to specify maximum count of media picks
setActivityTheme(int theme) used to set theme for toolbar (must be an actionbar theme)
setSelectedFiles(ArrayList selectedPhotos) to show already selected items
enableVideoPicker(boolean status) added video picker alongside images
enableOrientation(boolean status) In case, if you want to disable orientation (disabled by default)
showGifs(boolean status) to show gifs images in the picker
showFolderView(boolean status) if you want to show folder type pick view, enable this. (Enabled by default)
enableDocSupport(boolean status) If you want to enable/disable default document picker, use this method. (Enabled by default)
enableCameraSupport(boolean status) to show camera in the picker (Enabled by default)
addFileSupport(String title, String[] extensions, @DrawableRes int drawable) If you want to specify custom file type, use this method. (example below)

If you want to add custom file type picker, use addFileSupport() method like this ( for zip support):

String zipTypes = {".zip",".rar"};
   addFileSupport("ZIP",zipTypes, R.drawable.ic_zip_icon);

Proguard

# Glide
-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
    **[] $VALUES;
    public *;
}
# support-v7-appcompat
-keep public class android.support.v7.widget.** { *; }
-keep public class android.support.v7.internal.widget.** { *; }
-keep public class android.support.v7.internal.view.menu.** { *; }
-keep public class * extends android.support.v4.view.ActionProvider {
    public <init>(android.content.Context);
}
# support-design
-dontwarn android.support.design.**
-keep class android.support.design.** { *; }
-keep interface android.support.design.** { *; }
-keep public class android.support.design.R$* { *; }

Donate

You guys are doing great job by filing bugs and sending pull requests. I am doing everything to maintain this project. If you want to support, your donation is highly appreciated (and I love food, coffee and beer). Thank you!

PayPal

  • Donate $5: Thank's for creating this project, here's a coffee (or some beer) for you!
  • Donate $10: Wow, I am stunned. Let me take you to the movies!
  • Donate $15: I really appreciate your work, let's grab some lunch!
  • Donate $25: That's some awesome stuff you did right there, dinner is on me!
  • Donate $50: I really really want to support this project, great job!
  • Donate $100: You are the man! This project saved me hours (if not days) of struggle and hard work, simply awesome!
  • Donate $2799: Go buddy, buy Macbook Pro for yourself! Of course, you can also choose what you want to donate, all donations are awesome!

Credits

Inspired by PhotoPicker

SmoothCheckbox

Youtube Demo

Demo

License

Copyright 2016 Arun Sharma

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.