Saved searches

Use saved searches to filter your results more quickly

Cancel Create saved search Sign up Reseting focus

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.

Photopicker and document picker for android

Notifications You must be signed in to change notification settings

DroidNinja/Android-FilePicker

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Go to file

Folders and files

Last commit message Last commit date

Latest commit

History

View all files

Repository files navigation

Android-FilePicker (Androidx based)

A filepicker which allows to select images and videos with flexibility. It also supports selection of files by specifying its file type. For using this library, you have to migrate your project to androidx or you can use older version(2.1.5). Check out app module for example. For Android 10 devices using document picker, you will need to enable android:requestLegacyExternalStorage="true" option in your manifest file. This document picker will get deprecated soon over scoped storage and also, this flag will not work in when you target Android 11. :/ If your app

Installation

implementation 'com.droidninja:filepicker:2.2.5'

There is a method getFilePath in ContentUriUtils class through you can get the file path from Uri. e.g.

ContentUriUtils.INSTANCE.getFilePath(getContext(), uri);
ContentUriUtils.getFilePath(context, uri);

Note

This Filepicker is based on the MediaStore api provided by android. It checks MediaStore database for a file entry. If your file is not showing in the picker, it means that it is not inserted into MediaStore database yet.

Usage

Just include this in your onclick function:

FilePickerBuilder.getInstance() .setMaxCount(5) //optional .setSelectedFiles(filePaths) //optional .setActivityTheme(R.style.LibAppTheme) //optional .pickPhoto(this);

If you want to use custom request code, you just have to like this:

FilePickerBuilder.getInstance() .setMaxCount(5) //optional .setSelectedFiles(filePaths) //optional .setActivityTheme(R.style.LibAppTheme) //optional .pickPhoto(this, CUSTOM_REQUEST_CODE);
FilePickerBuilder.getInstance() .setMaxCount(10) //optional .setSelectedFiles(filePaths) //optional .setActivityTheme(R.style.LibAppTheme) //optional .pickFile(this);

If you want to use custom request code, you just have to like this:

FilePickerBuilder.getInstance() .setMaxCount(5) //optional .setSelectedFiles(filePaths) //optional .setActivityTheme(R.style.LibAppTheme) //optional .pickFile(this, CUSTOM_REQUEST_CODE);

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.getParcelableArrayListExtraUri>(FilePickerConst.KEY_SELECTED_MEDIA)); > break; case FilePickerConst.REQUEST_CODE_DOC: if(resultCode== Activity.RESULT_OK && data!=null) < docPaths = new ArrayList<>(); docPaths.addAll(data.getParcelableArrayListExtraUri>(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 (dont use if you want no limit)
setActivityTheme(int theme) used to set theme for toolbar (must be an non-actionbar theme or use LibAppTheme)
setActivityTitle(String title) used to set title for toolbar
setSelectedFiles(ArrayList selectedPhotos) to show already selected items (optional)
enableVideoPicker(boolean status) added video picker alongside images
enableImagePicker(boolean status) added option to disable image picker
enableSelectAll(boolean status) added option to enable/disable select all feature(it will only work with no limit option)
setCameraPlaceholder(int drawable) set custom camera drawable
withOrientation(Orientation type) In case, if you want to set orientation, use ActivityInfo for constants (default=ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED)
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)
setSpan(spanType: FilePickerConst.SPAN_TYPE, count: Int) Set Span count for folder and detail screen ( [FilePickerConst.SPAN_TYPE.FOLDER_SPAN] or [FilePickerConst.SPAN_TYPE.DETAIL_SPAN]])

If you want to add custom file type picker(do not use . in extension types), use addFileSupport() method like this ( for zip support):

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

Styling

Just override these styles in your main module to change colors and themes.

style name="LibAppTheme" parent="Theme.MaterialComponents.NoActionBar">  Customize your theme here. --> item name="colorPrimary">@color/colorPrimaryitem> item name="colorPrimaryDark">@color/colorPrimaryDarkitem> item name="colorAccent">@android:color/blackitem> item name="android:colorBackground">@android:color/background_lightitem> item name="android:windowBackground">@android:color/whiteitem> item name="toolbarStyle">@style/ToolbarThemeitem> item name="tabStyle">@style/PickerTabLayoutitem> style> style name="LibAppTheme.Dark" parent="LibAppTheme">  Customize your theme here. --> item name="colorAccent">@android:color/whiteitem> item name="toolbarStyle">@style/ToolbarTheme.Darkitem> item name="tabStyle">@style/PickerTabLayout.Darkitem> style> style name="PickerTabLayout" parent="Widget.MaterialComponents.TabLayout">  tab background--> item name="tabBackground">@color/colorPrimaryitem>  tab text color selector : set selector accordingly to dark or light theme--> item name="tabTextColor">@color/selector_tab_text_coloritem>  tab indicator color: set indicator color accordingly--> item name="tabIndicatorColor">@android:color/blackitem> item name="tabGravity">fillitem> item name="tabMaxWidth">0dpitem> style> style name="ToolbarTheme" parent="Widget.MaterialComponents.Toolbar.Primary"> item name="materialThemeOverlay">@style/ThemeOverlay.App.Toolbar.Lightitem> item name="android:theme">@style/ThemeOverlay.App.Toolbar.Lightitem> style> style name="SmoothCheckBoxStyle"> item name="color_checked">@color/colorAccentitem> item name="color_unchecked">@android:color/whiteitem> item name="color_unchecked_stroke">@color/checkbox_unchecked_coloritem> item name="color_tick">@android:color/whiteitem> style>

Proguard

# Glide -keep public class * implements com.bumptech.glide.module.GlideModule -keep class * extends com.bumptech.glide.module.AppGlideModule < (. ); > -keep public enum com.bumptech.glide.load.ImageHeaderParser$** < **[] $VALUES; public *; >-keep class com.bumptech.glide.load.data.ParcelFileDescriptorRewinder$InternalRewinder < *** rewind(); ># Uncomment for DexGuard only #-keepresourcexmlelements manifest/application/meta-data@value=GlideModule 

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