Android Fragment Navigator.

License	Apache-2.0
GroupId	com.github.sophoun
ArtifactId	android-navigator
Last Version	0.0.2
Release Date	Dec 22, 2020
Type	aar
Description	Android Fragment Navigator. Android Fragment Navigator.
Project URL	https://github.com/Sophoun/android-navigator.git
Source Code Management	https://github.com/Sophoun/android-navigator

Download android-navigator

Filename	Size
android-navigator-0.0.2.pom
android-navigator-0.0.2.aar	12 KB
android-navigator-0.0.2-sources.jar	3 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.sophoun/android-navigator/ -->
<dependency>
    <groupId>com.github.sophoun</groupId>
    <artifactId>android-navigator</artifactId>
    <version>0.0.2</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.sophoun/android-navigator/
implementation 'com.github.sophoun:android-navigator:0.0.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.sophoun/android-navigator/
implementation ("com.github.sophoun:android-navigator:0.0.2")

Apache Buildr

'com.github.sophoun:android-navigator:aar:0.0.2'

Apache Ivy

<dependency org="com.github.sophoun" name="android-navigator" rev="0.0.2">
  <artifact name="android-navigator" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.sophoun', module='android-navigator', version='0.0.2')
)

Scala SBT

libraryDependencies += "com.github.sophoun" % "android-navigator" % "0.0.2"

Leiningen

[com.github.sophoun/android-navigator "0.0.2"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Android Fragment Navigator

This is a library that want to help you to navigate fragments in inside an activity. We build this library because we want to solve the single activity strategy for our use case.

How to use

Import dependency

We host this library on jcenter. Make sure you have added jcenter() repository to your build.gradle root project.

allprojects {
    repositories {
        jcenter()
    }
}

Then import library dependency inside your app module:

implementation 'com.github.sophoun:android-navigator:0.0.1'

Now you have imported the library.

Sample

Declare a public navigator property inside your MainActivity to easy call it from any place that you want. (We used FragmentTabNavigator because We want to handle tab switch between BottomNavigationView).

lateinit var fragmentTabNavigator: FragmentTabNavigator
val homeNav by lazy { FragmentStackNavigator(rootHomeFragment.childFragmentManager, R.id.root_home_container) }

Above we have declared a fragmentTabNavigator and also initialized homeNav fragment stack. Inside the FragmentStackNavigator we also pass the child fragment manager and the id of view that responsible to navigate the the fragments.

Inside your onCreate method, it's a good place to setup fragment navigation object.

fragmentTabNavigator = FragmentTabNavigator(supportFragmentManager, R.id.nav_host_fragment)

fragmentTabNavigator.setRootFragment(listOf(
    rootHomeFragment,
    firstFragment,
    secondFragment
), 1)

homeNav.setExitOn(0)
homeNav.setHideFragment(true)
fragmentTabNavigator.setExitOnHomeTab(true)
fragmentTabNavigator.setChildNavigatorStack(listOf(homeNav, null, null))

Above code is what we have setup the FragmentTableNavigator and FragmentNavigator.

• For FragmentTabNavigator you can setup the root fragments and you can set exit on home fragment or set the child fragment stack navigator to it. It has a lot more feature, please see the document references.
• For FragmentNavigator you can setup exit on fragment index or use the hide show fragments strategy, please see the document references.

when you want to push a fragment to stack or switch fragment just call:

• fragmentTabNavigator.switchTo(index) to switch fragment tab index.
• fragmentTabNavigator.pop() to pop a fragment from stack.
• homeNav.push(Fragment()) to push a fragment to stack.

Documentation

Document references

Versions

Version
0.0.2 Dec 22, 2020
0.0.1 Jun 28, 2020