FilePickerLibrary

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)

A Quick Overview What's In

Compatible down to API Level 16

Include to Project

Provide the Gradle Dependency

Step 1

Add the JitPack in your root build.gradle at the end of repositories:

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

Step 2

Add the dependency

dependencies {
    compile 'com.github.alirezaaa:FilePickerLibrary:3.5.1'
}

Clone or Download `.zip` file

Clone this repository or download the compressed file, then extract to your computer. Simply import the library module to your project.

Usages

Use one of the following samples or simply compile and test the sample app provided:

Material Theme Used (with Modern Builder)

new FilePickerBuilder(this)
    .withColor(android.R.color.holo_blue_bright)
    .withRequest(Request.FILE)
    .withScope(Scope.ALL)
    .withMimeType(MimeType.JPEG)
    .useMaterialActivity(true)
    .launch(REQUEST_FILE);

`image/png` Mime Type

Intent filePicker = new Intent(this, FilePickerActivity.class);
filePicker.putExtra(FilePickerActivity.SCOPE, Scope.ALL);
filePicker.putExtra(FilePickerActivity.REQUEST, Request.FILE);
filePicker.putExtra(FilePickerActivity.INTENT_EXTRA_COLOR_ID, android.R.color.holo_green_dark);
filePicker.putExtra(FilePickerActivity.MIME_TYPE, MimeType.PNG);
startActivityForResult(filePicker, REQUEST_FILE);

Show as a Dialog

Intent filePickerDialogIntent = new Intent(this, FilePickerActivity.class);
filePickerDialogIntent.putExtra(FilePickerActivity.THEME_TYPE, ThemeType.DIALOG);
filePickerDialogIntent.putExtra(FilePickerActivity.REQUEST, Request.FILE);
startActivityForResult(filePickerDialogIntent, REQUEST_FILE);

Select a Directory

Intent filePickerActivity = new Intent(this, FilePickerActivity.class);
filePickerActivity.putExtra(FilePickerActivity.SCOPE, Scope.ALL);
filePickerActivity.putExtra(FilePickerActivity.REQUEST, Request.DIRECTORY);
filePickerActivity.putExtra(FilePickerActivity.INTENT_EXTRA_FAB_COLOR_ID, android.R.color.holo_green_dark);
startActivityForResult(filePickerActivity, REQUEST_DIRECTORY);

To have the result, you must override onActivityResult(int, int, Intent) method as I did below:

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if ((requestCode == REQUEST_DIRECTORY) && (resultCode == RESULT_OK)) {
        Toast.makeText(this, "Directory Selected: " + data.getStringExtra(FilePickerActivity.FILE_EXTRA_DATA_PATH), Toast.LENGTH_LONG).show();
    } else if ((requestCode == REQUEST_FILE) && (resultCode == RESULT_OK)) {
        Toast.makeText(this, "File Selected: " + data.getStringExtra(FilePickerActivity.FILE_EXTRA_DATA_PATH), Toast.LENGTH_LONG).show();
    }
}

Contributors

Paul T (developer)
Alireza Eskandarpour Shoferi (contributor)

License

Copyright 2016 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.

andrort / filepickerlibrary Goto Github PK