Features

Min SDK : 15

Price : Free

Language : Java

Download

Link : Github

Owner : wealthfront

Source Code : Download


Build Status Maven Central Javadocs

Magellan

The simplest navigation library for Android.

Main Features

  • Navigation is as simple as calling goTo(screen)
  • You get full control of the backstack
  • Transitions are automaticaly handled for you

Download

Add the dependencies you need in your build.gradle:

Core library

compile 'com.wealthfront:magellan:1.0.0'

Optional add-ons

def magellanVersion = '1.0.0'
compile 'com.wealthfront:magellan:' + magellanVersion
compile 'com.wealthfront:magellan-support:' + magellanVersion
compile 'com.wealthfront:magellan-rx:' + magellanVersion

Add-on coming soon

Getting started

Single Activity

MainActivity.java:
public class MainActivity extends SingleActivity {
@Override
protected Navigator createNavigator() {
return Navigator.withRoot(new HomeScreen()).build();
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main_activity);
}
}
main_activity.xml:
<com.wealthfront.magellan.ScreenContainer
xmlns:android=""
android:id="@id/magellan_container"
android:layout_width="match_parent"
android:layout_height="match_parent"
/>

Minimal Screen implementation

Screen example HomeScreen.java:
public class HomeScreen extends Screen<HomeView> {
@Override
protected HomeView createView(Context context) {
return new HomeView(context);
}
}
Associated View HomeView.java:
public class HomeView extends BaseScreenView<HomeScreen> {
public HomeView(Context context) {
super(context);
inflate(R.layout.home);
}
}

Samples

Basic sample basic-sample-gif Advanced sample using Dependency Injection, Retrofit, and Rx. advanced-sample-gif Kotlin sample (courtesey of @jmfayard)

Learn More

For more, see the wiki.

License

Copyright 2017 Wealthfront, Inc.
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.