Skip to content

Latest commit

 

History

History
114 lines (87 loc) · 5.18 KB

README.md

File metadata and controls

114 lines (87 loc) · 5.18 KB
Raw

FilePickerLibrary

Android Arsenal

Simple library that allows for picking of files and directories. This is a clean and simple way to allow your user to easily select a file. This library is inspired by Android L and the new Material Design guidelines adding to its sleekness and beauty.

![image] (images/main_framed.png)

Requirements

Min SDK Level is 14 or Android IceCreamSandwich

Dependency

Clone this repository or download the zip. Then extract to your computer. Simply import the library to your project but only include the FPlib module (that's where the library is). If you're using Android Studio then import a module and only include the FPlib module. See the license for usage terms.

Alternatively you can use gradle.

Add the following code to your gradle build script.

	repositories {
		...
		maven {url "https://jitpack.io"}
	}
	dependencies {
	  	compile 'com.github.DeveloperPaul123:FilePickerLibrary:2.0.0'
	}

Usage

Simply do the following. ```java Intent filePickerIntent = new Intent(this, FilePickerActivity.class); filePickerIntent.putIntExtra(FilePickerActivity.REQUEST_CODE, FilePickerActivity.REQUEST_DIRECTORY); startActivityForResult(filePickerIntent, FilePickerActivity.REQUEST_DIRECTORY); ``` Make sure to add the int extra for your request code. You can also request for a file path instead of a directory. See the javadocs for more info. To get the file path do the following. 
  @Override
  public void onActivityResult(int requestCode, int resultCode, Intent data) {

    if(requestCode == FilePickerActivity.REQUEST_DIRECTORY 
    && resultCode == RESULT_OK) {
    
        String filePath = data.
                getStringExtra(FilePickerActivity.FILE_EXTRA_DATA_PATH);
                if(filePath != null) {
                //do something with filePath...
                }
  }
    super.onActivityResult(requestCode, resultCode, data);
  }

Customization

You can change the header background in the activity by adding resorce ids to your calling intent as int extras. Below is an example. 
Intent filePickerIntent = new Intent(this, FilePickerActivity.class);
filePickerIntent.putIntExtra(FilePickerActivity.REQUEST_CODE, FilePickerActivity.REQUEST_DIRECTORY);
filePickerIntent.putIntExtra(FilePickerActivity.INTENT_EXTRA_COLOR_ID, R.color.myColor);
startActivityForResult(filePickerIntent, FilePickerActivity.REQUEST_DIRECTORY);

You can also change the theme for the activity to make it look like a dialog.

Intent filePickerDialogIntent = new Intent(getActivity(), FilePickerActivity.class);
filePickerDialogIntent.putExtra(FilePickerActivity.THEME_TYPE, ThemeType.DIALOG);
filePickerDialogIntent.putExtra(FilePickerActivity.REQUEST_CODE, FilePickerActivity.REQUEST_FILE);
startActivityForResult(filePickerDialogIntent, FilePickerActivity.REQUEST_FILE);

In addition you can set a mime type that you want the user to select. The activity will not return a result until that type of file is selected. For example:

Intent filePicker = new Intent(getActivity(), FilePickerActivity.class);
filePicker.putExtra(FilePickerActivity.SCOPE_TYPE, FileScopeType.ALL);
filePicker.putExtra(FilePickerActivity.REQUEST_CODE, FilePickerActivity.REQUEST_FILE);
filePicker.putExtra(FilePickerActivity.INTENT_EXTRA_COLOR_ID, android.R.color.holo_green_dark);
filePicker.putExtra(FilePickerActivity.MIME_TYPE, FileType.PNG);
startActivityForResult(filePicker, FilePickerActivity.REQUEST_FILE);

Finally, you can now use a builder class to simplify intent creation:

new FilePickerBuilder(getActivity()).withColor(android.R.color.holo_blue_bright)
                            .withRequestCode(FilePicker.REQUEST_FILE)
                            .withScopeType(FileScopeType.ALL)
                            .withMimeType(FileType.PNG)
                            .useMaterialActivity(true)
                            .launch();

You can also call build() instead of launch() and you will get back an activity. Note that launch() starts the activity with startActivityForResult() and uses the request code you passed into the builder as the request code for the activity result extra. So when listening for activity results be sure to use the same request code.

Demo App

* **Check out the sample on google play.** 
   [![Get it on Google Play](http://www.android.com/images/brand/get_it_on_play_logo_small.png)](https://play.google.com/store/apps/details?id=com.devpaul.filepicker)

Developed By

**Paul T**

License

Copyright 2014 Paul T

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.