+2
Daily
5,547
stars
1,258
forks
1
watchers
137
prs
325
issues
13
releases
README
ShowcaseView
---
The ShowcaseView (SCV) library is designed to highlight and showcase specific parts of apps to the user with a distinctive and attractive overlay. This library is great for pointing out points of interest for users, gestures, or obscure but useful items.
| Holo | "New style" | Material |
| --- | --- | --- |
| !Holo style showcaseview | !new style showcaseview | !Material style showcaseview |
The library is based on the "Cling" view found in the Launcher on Ice-Cream Sandwich and Jelly Bean.
Project set-up
====
ShowcaseView currently supports API LEVEL 11+
If you're using a Gradle-based project, then you can add SCV as a dependency directly:
~~~
compile 'com.github.amlcurran.showcaseview:library:5.4.3'
~~~
If you're using Maven (but not Gradle), you can add the APKlib as a dependency:
xml
com.github.amlcurran.showcaseview
library
5.4.3
apklib
If you're using a standard project without either Maven or Gradle, you'll have to download the project, and the add the library manually to your project.
Usage
====
To use ShowcaseView, use the Builder pattern.
As an example:
java
new ShowcaseView.Builder(this)
.setTarget(new ActionViewTarget(this, ActionViewTarget.Type.HOME))
.setContentTitle("ShowcaseView")
.setContentText("This is highlighting the Home button")
.hideOnTouchOutside()
.build();
You can use styles to customise how a ShowcaseView looks. I'll write more documentation soon, but for now, check out the sample project's styles.
Sample Project
----
There's a sample project available which you can find in the project, or as an app on the Google Play Store.
What's the legacy branch?
----
The legacy branch is still available for people to use. This has more features than the master branch, but it more unwieldy to use and less stable. I don't support it at all - you'll have to build and compile it yourself. It isn't available on Maven Central either.
Is it worth using?
----
Perhaps. Why not ask
Google, iPlayer Radio,
or AllCast, which each use the library?
Previous users include The Guardian and HaxSync
What's missing in v5
---
- ShowcaseViews: the class which queues up ShowcaseViews in a tutorial-type method. I never
really liked this class (generally, you should use SCV sparingly); I'll add it back in based on
the Builder class when I can.
- Ghostly hand: this has gone for now until I can test-drive it back in.
- Scale multiplier: this has gone for simplicity - if people really loved it I'll add in back in
FAQs
---
Where has X feature gone?
Look one paragraph up!
Waaaah, but I really liked feature X!!!
Switch to the legacy branch and use that one then! All legacy features are in there.
What happened to all the other constructors?
Gone. You should be using the new Target API.
What if I want to add feature X?
At the moment, I'm not taking any feature requests. It's unlikely I'll take many anyway,
unless I feel they are both useful and well tested. If you have some cosmetic tTop issues
#353Crazy amounts of crashes .updateBitmap IllegalArgumentException14 comments · 2016-01-04#361Setting TextPaint has no effect13 comments · 2016-01-29#347Add API for showing multiple Showcases9 comments · 2015-12-26#366Can we add extra label like "skip" on the Showcase7 comments · 2016-02-10#335Changing the text position 7 comments · 2015-12-13#323NavigationView menu item targeting7 comments · 2015-11-16#392OutOfMemory5 comments · 2016-05-12#374How to add margin between the TITLE and DETAIL?5 comments · 2016-02-28
Latest release
v5.4.3 v5.4.3 2016-04-06Fixes 373, where setContentText would not update the showcaseview