Skip to content
This repository has been archived by the owner on Jan 3, 2019. It is now read-only.
Nimrodda edited this page Mar 18, 2013 · 7 revisions

WizarDroid

WizarDroid is an Android library for creating Wizard like Activities such as Windows Setup Wizard, Step by Step installation processes, etc. It is built on top of Android's Fragments which act as the Wizard's steps. WizarDroid is completely configurable and support dynamic flow. Whenever you feel like you want to add an additional step, all you have to do is add it to the flow and that's it!

Why do we need WizarDroid?

  1. Scalability - if you care about your application's scalability you should definitely use WizarDroid. Instead of hard coding your application flow, which is totally the wrong way to go in my opinion, you can use WizarDroid to dynamically control the flow of the application.

  2. Easy to maintain - the wizard's flow is configured only in one place! You don't need to go to each and every single step to hard code which step it will call next, etc.

How does it work?

WizarDroid is built using Android's Fragments and uses the Support Library to ensure compatibility with devices that use Android API 9 and above. In the core of WizarDroid, it uses FragmentManager to dynamically replace the Fragments (The "Steps") displayed in the Activity.

You start by inheriting from WizardActivity and create steps by inheriting from WizardStep. Once you have those done, you can create a WizardFlow and give it a go!

By default WizarDroid has built in support for the phone's back button to go back to previous steps. It is up to you to define how the wizard progresses from one step to the next. The most common way is to have a global Next button in the WizardActivity layout which upon click will mark the current step "DONE" and proceed to the next one until the wizard reached the last step.