This library is deprecated and will no longer be maintained. Please use https://developer.android.com/guide/navigation/navigation-getting-started

FragmentControllerAndroid

This library wrapps around the Android's FragmentManager and provides an easy to use API. You can add fragments without bothering about the FragmentTransaction. Check the API to see what it provides.

FragmentControllerAndroid is developed and maintained by Appolica.

Download

Gradle

compile 'com.appolica:fragment-controller:1.0.2'

Maven

<dependency>
  <groupId>com.appolica</groupId>
  <artifactId>fragment-controller</artifactId>
  <version>1.0.2</version>
  <type>pom</type>
</dependency>

Example

Create the controller

Add a container for the FragmentController fragment in your layout:

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <FrameLayout
        android:id="@+id/container"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</FrameLayout>

Instantiate the controller by passing it a root FragmentProvider:

final FragmentController frController = FragmentController.instance(rootProvider);

Then add the controller fragment:

getSupportFragmentManager().beginTransaction()
                    .replace(R.id.container, frController, CONTROLLER_TAG)
                    .commit();

And basically you're ready to go. From now on you won't bother for any transactions. All your fragments will be added and managed within the controller fragment using its child fragment manager.

Use the controller

Once the controller is added to the FragmentManager, it will show the root fragment. You can add another one the following way:

frController.pushBody()
                .addToBackStack(true)
                .withAnimation(true)
                .fragment(secondFragmentProvider)
                .push();

Want to add custom animation? No problem:

frController.pushBody()
                .addToBackStack(true)
                .customAnimation()
                .enter(R.anim.slide_in_right)
                .exit(R.anim.slide_out_left)
                .popEnter(android.R.anim.slide_in_left)
                .popExit(android.R.anim.slide_out_right)
                .end()
                .fragment(secondFragmentProvider)
                .push();

If you are inside one of the controller's children and you want to obtain the controller's instance, you can do so by using this handy method:

final FragmentController frController = FragmentUtil.getFragmentController(this);

Popping a fragment is also as easy as possible:

FragmentUtil.getFragmentController(this).pop(true);

API

Go to Wiki for more information about using the library and its API.

License

Copyright 2017 Appolica Ltd.

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.