Showcaseview
ShowcaseView by Espian(dev)
ShowcaseView is a library which helps give your app that extra flair. It is designed to easily insert reliable, Holo-designed guides into your app, to point out features that users might not notice, such as gestures.
Usage
Version 2 of the API (available now) was designed to be super simple to use, and now requires a single call
(one of the insertShowcaseView(...) methods) to place a ShowcaseView into your app hierarchy.
Whilst there are additional options, the single method above - which comes in many different flavours - will
produce a quick yet professional output.
Version 2 also added support for showcasing action bar items. This currently doesn't work for split ActionBars, but that should hopefully be coming soon.
Customisation & options
ShowcaseView can be customised by providing a set of ShowcaseView.ConfigOptions with
initialisation. The customisations available include:
- Whether a touch outside the highlighted area is blocked, allowed, or hides the ShowcaseView (SCV)
- Have SCV show up every time an activity starts or only a single time with
ConfigOptions.shotType(TYPE_NO_LIMITorTYPE_ONE_SHOTrespectively) - Have the SCV overlay the ActionBar as well as the Activity's content (
ConfigOptions.insertwithINSERT_TO_DECORorINSERT_TO_CONTENTrespectively) - You can change the text colour as well, using
ShowcaseView.setTextColors(..)
More detailed theming can be achieved using the showcaseViewStyle theme attribute,
allowing customisation of the background color and text colours via a theme. There are also pre-defined
normal (ShowcaseView) and light (ShowcaseView.Light) themes for use
in Holo Dark/Light situations. Check out the sample project for theme examples!
Compatibility
The library is compatible all the way down to Android 2.1, which is API level 7.
Maven
There have been multiple requests for hosting this project on Maven. I don't have much experience with Maven, but plan to have a go at hosting it there too - I will report back once finished.
Support or Contact
My Google+ page is the easiest way to contact me directly. Please use the official issue tracker to raise problems/report bugs.