android-square-progressbar

An android library to display a progressbar that goes around an image.

Code Quality Rank: L2

Programming language: Java

Tags: Progressbar/Progress View Widget    

Latest version: v1.6.0

README

android-square-progressbar

First things first

This library is setup to work with the Android Studio and Gradle. If you're using the Eclipse environment then check out the legacy repository here: android-square-progressbar-legacy.

You can find my blog post about the newest version here: halcyon.ch - android-square-progressbar v.1.6.0, also check out the post about the previous major 1.5.0 version here.

The example application is available at the play store:

General idea

Sometimes you don't have enough space in your layout to display a wide progressbar. So this library gives you a complete new possibility to display a progress. You can simply show a progressbar around an image. And this progressbar can be configured in a lot of different ways, like colour, outline, display of the percentage and so on.

Examples

Here are some examples of how these progressbars could look like:

normal / default	rounded corners	show percent	indeterminate
		setRoundedCorners(true)	showProgress(true)
		setOpacity(true)	setIndeterminate(true)

There are some further examples available here (with code) : Examples

How to use it? / How to install? / How to contribute?

Check the wiki for more information about how to use, how to install or how to contribute.

If you have questions about the code or if you need some help, you can try the Gitter-Group.

Usage

Gradle

This library now works with gradle and will soon be available on the central maven repository. For the moment its on jCenter at Bintray. Just add the following repository to your root build.gradle:

allprojects {
    repositories {
        jcenter()
        maven { url "https://jcenter.bintray.com" }
    }
}

Then in your app build.gradle:

dependencies {
    // other repos ...
    implementation 'ch.halcyon:squareprogressbar:1.6.4'
}

Code

After adding the gradle depedency from above you can go to your xml layout and add the following code for a squareprogressbar:

<ch.halcyon.squareprogressbar.SquareProgressBar
    android:id="@+id/sprogressbar"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_alignParentTop="true"
    android:layout_centerHorizontal="true"
    android:paddingTop="20dp" >
</ch.halcyon.squareprogressbar.SquareProgressBar>

To set some basic settings use the following java-code:

SquareProgressBar squareProgressBar = findViewById(R.id.sprogressbar);
squareProgressBar.setImage(R.drawable.example);
squareProgressBar.setProgress(50.0);

Now you can make the squareprogressbar as fancy as you like. Check the usage page for all the different possiblities.