com.turhanoz.android:reactivedirectorychooser

A simple android library that lets user select a directory from Storage.


License
Giftware

Documentation

Android ReactiveDirectoryChooser

Build Status Release Android Arsenal Stories in Ready

A simple android library that lets user select a directory, either on primary external SD Card, or Secondary one (if you have multiple external storage).

This library has been developed using RxJava. It also integrates relevant unit tests.

Usual Fragment
Floating DialogFragment

Usage

From JitPack

Library releases are available on JitPack; you can add dependencies as follow :

Gradle

allprojects {
        repositories {
            jcenter()
            maven { url "https://jitpack.io" }
        }
    }
dependencies {
        compile 'com.github.turhanoz:reactivedirectorychooser:{latest version}'
    }

Supported Android SDK

You can use this library for apps starting from android 4.0 (icecream /API 14) to android 8 (oreo / API 26)

minSdkVersion 14
targetSdkVersion 26

##Important behaviour Starting API LEVEL 21, please use ACTION_OPEN_DOCUMENT_TREE intent instead of opening raw directories (here is a sample to guide you : https://github.com/googlesamples/android-DirectorySelection)

Manifest

You need to add the android.permission.WRITE_EXTERNAL_STORAGE permission.

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Fragment

This library integrates a Fragment called DirectoryChooserFragment; You can use it as floating dialog fragment or regular fragment. You can also pass a default root directory file which will be displayed first. To be notified which directory the user has chosen, you can implement the OnDirectoryChooserFragmentInteraction interface on your host activity (the fragment will automatically register the host activity's interface for you).

public class MainActivity extends ActionBarActivity implements OnDirectoryChooserFragmentInteraction {
    File currentRootDirectory = Environment.getExternalStorageDirectory();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    }

    void addDirectoryChooserFragment() {
        DialogFragment directoryChooserFragment = DirectoryChooserFragment.newInstance(currentRootDirectory);
        getSupportFragmentManager()
			.beginTransaction()
			.addToBackStack("RDC")
			.add(R.id.fragment_host, directoryChooserFragment, "RDC")
			.commit();
    }

    void addDirectoryChooserAsFloatingFragment() {
            DialogFragment directoryChooserFragment = DirectoryChooserFragment.newInstance(currentRootDirectory);
            FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
            directoryChooserFragment.show(transaction, "RDC");
    }

    @Override
    public void onEvent(OnDirectoryChosenEvent event) {
        File directoryChosenByUser = event.getFile();
    }

    @Override
    public void onEvent(OnDirectoryCancelEvent event) {
    }
}

Article

Follow the detailed process of this open source project in this blog post

License

Fun one

Copyright 2015 Turhan Oz

"THE VIRGIN-MOJITO-WARE LICENSE" (Revision 2048): As long as you retain this notice you can do whatever you want with this stuff. If we meet some day, and you think this stuff is worth it, you can buy me a virgin mojito in return. Turhan

Real one

    Copyright 2015 Turhan OZ

    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.