Initial commit.

Author: patloew

.gitignore

@@ -0,0 +1,9 @@
+*.iml
+.gradle
+/local.properties
+/.idea/workspace.xml
+/.idea/libraries
+.DS_Store
+/build
+/captures
+.idea

LICENSE

@@ -0,0 +1,13 @@
+Copyright 2016 Patrick Löwenstein
+
+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.

README.md

@@ -0,0 +1,99 @@
+# NavigationViewFragmentAdapters
+
+ [ ![Download](https://api.bintray.com/packages/patloew/maven/NavigationViewFragmentAdapters/images/download.svg) ](https://bintray.com/patloew/maven/NavigationViewFragmentAdapters/_latestVersion) [![API](https://img.shields.io/badge/API-9%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=9)
+
+A small library containing two adapters which allow for easy fragment management with a NavigationView.
+
+The library handles replacing the fragments and saving/restoring the fragment state, including showing the right fragment when opening an app again after it was killed.
+
+# Usage
+
+First, decide which adapter suits your use case better.
+
+The `NavigationViewFragmentAdapter` detaches fragments after another menu item is selected. This means that each Fragment for a menu item is kept in memory, but there is no overhead for recreating when it is attached again.
+
+The `NavigationViewStateFragmentAdapter` saves the state and removes the fragment after another menu item is selected. This means that only the fragment for the current menu item is kept in memory, but there is overhead for recreating other fragments when they are selected again.
+
+After you decided, create your adapter implementation:
+
+	private class MyNavigationViewAdapter extends NavigationViewFragmentAdapter {
+
+	    public MyDrawerAdapter(FragmentManager fragmentManager, @IdRes int containerId, @IdRes int defaultMenuItemId, Bundle savedInstanceState) {
+            super(fragmentManager, containerId, defaultMenuItemId, savedInstanceState);
+        }
+
+	    @NonNull
+	    @Override
+	    public Fragment getFragment(@IdRes int menuItemId) {
+	        switch (menuItemId) {
+	            case R.id.navitem_1:
+	                return SampleFragment.newInstance("Fragment 1");
+	            case R.id.navitem_2:
+	                return SampleFragment.newInstance("Fragment 2");
+	            case R.id.navitem_3:
+	                return SampleFragment.newInstance("Fragment 3");
+	            default:
+	                return SettingsFragment.newInstance();
+	        }
+	    }
+	}
+
+Now, create an instance and attach it to your NavigationView in your Activity `onCreate()`:
+
+	myDrawerAdapter = new MyDrawerAdapter(getSupportFragmentManager(), R.id.container, R.id.navitem_1, savedInstanceState);
+	myDrawerAdapter.attachTo(navigationView);
+
+Also, don't forget to call `myDrawerAdapter.onSaveInstanceState()` in your Activity `onSaveInstanceState()`.
+
+Now you have your navigation drawer up and running, including state saving of the fragments.
+
+# Advanced Usage
+
+## Back Stack
+
+There are cases when some menu items (e.g. settings) should not simply replace the current fragment, but also be added to the back stack. To do this, override `shouldAddToBackStack()` in your adapter:
+
+	@Override
+    public boolean shouldAddToBackStack(@IdRes int menuItemId) {
+        return menuItemId == R.id.navitem_settings;
+    }
+
+## Animations
+
+You can provide custom animations for your fragment transactions via `setCustomAnimations()`. Separate animations can be set for when you add the transaction to the back stack via `setBackStackCustomAnimations()`.
+
+## OnNavigationItemSelectedListener
+
+An additional `OnNavigationItemSelectedListener` can be provided via `setNavigationItemSelectedListener()`. This can be used to add behavior after the fragment transaction was commited. If you just want to close the drawer, the lib includes a `CloseDrawerNavigationItemSelectedListener`.
+
+# Sample
+
+A basic sample app with example Activities for both adapters is available in the `sample` project.
+
+# Setup
+
+Add the following to your `build.gradle`:
+	
+	repositories {		
+		maven { url 'https://dl.bintray.com/patloew/maven' }		
+	}
+
+	dependencies {
+	    compile 'com.patloew.navigationviewfragmentadapters:adapters:0.1.1'
+	}
+
+# License
+
+	Copyright 2016 Patrick Löwenstein
+
+	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.

build.gradle

@@ -0,0 +1,34 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+
+buildscript {
+    repositories {
+        jcenter()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:2.1.2'
+
+        classpath 'me.tatarka:gradle-retrolambda:3.3.0-beta4'
+        classpath 'me.tatarka.retrolambda.projectlombok:lombok.ast:0.2.3.a2'
+
+        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
+
+        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6'
+        classpath "com.github.dcendents:android-maven-gradle-plugin:1.3"
+
+
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle files
+    }
+
+    configurations.classpath.exclude group: 'com.android.tools.external.lombok'
+}
+
+allprojects {
+    repositories {
+        jcenter()
+    }
+}
+
+task clean(type: Delete) {
+    delete rootProject.buildDir
+}

gradle.properties

@@ -0,0 +1,19 @@
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+# Default value: -Xmx10248m -XX:MaxPermSize=256m
+# org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
+org.gradle.jvmargs=-Xmx2048M
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true

gradle/wrapper/gradle-wrapper.jar

@@ -0,0 +1,6 @@
+#Mon Dec 28 10:00:20 PST 2015
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-2.13-all.zip