/GoogleProgressBar

Android library to display progress like google does in some of his services.

Primary LanguageJavaApache License 2.0Apache-2.0

GoogleProgressBar

Android library to display different kind of google related animations for the progressBar.

The demo app can be found in the play store.

playstore

These animations have been finished so far:

FoldingCirclesProgressBar GoogleMusicDicesDrawable NexusRotationCross.gif

TODO

  • Different colors for the already existing `GoogleMusicDicesDrawable'. Either the whole dice or his faces.

I also would love to receive your pull requests to create any of the following animations or others that you think fit on this library:

  • NEXUS_CIRCLES:

    Nexus 5 circles boot progress animation (Just the circles bouncing)

  • NEXUS_CROSS:

    Galaxy nexus shinny cross boot animation

Usage

######Dynamically Add a ProgressBar to the xml layout:

     <ProgressBar
            android:id="@+id/google_progress"
            android:layout_width="50dp"
            android:layout_height="50dp"
            android:layout_gravity="center"/>

Choose from the list of Drawables the one you want to use and place it in your code:

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ButterKnife.inject(this);
        mProgressBar.setIndeterminateDrawable(new your_list_option.Builder(this)
                    .build());
        //...
    }

your_list_option can be replace for:

  • FoldingCirclesDrawable
  • GoogleMusicDicesDrawable
  • NexusRotationCrossDrawable

The more custom Drawables finished, the more options in this list.

Attributes depending on the drawable:

######Color

    mProgressBar.setIndeterminateDrawable(new you_list_option.Builder(this)
                                                             .colors(getResources().getIntArray(R.array.colors) //Array of 4 colors
                                                             .build());
  • FoldingCirclesDrawable
  • NexusRotationCrossDrawable

So far GoogleMusicDicesDrawable doesn't have color options. The animation speed can be modified easily with android:indeterminateDuration in the xml.

If not colors are define the 4 default google colors (red,blue, yellow and green) will be used.

######From XML

When you want to use the GoogleProgresBar from XML you need to add the following view to your layout:

    <com.jpardogo.android.googleprogressbar.library.GoogleProgressBar
            android:id="@+id/google_progress"
            android:layout_width="50dp"
            android:layout_height="50dp"
            android:layout_gravity="center"
            gpb:type="your_list_option"/>

The require attribute gpb:type will specify the type of ProgressBar to display

your_list_option can be replace for:

  • folding_circles
  • nexus_rotation_cross
  • google_music_dices

The more custom Drawables finished, the more options in this list.

Each type of GoogleProgressBar have different attributes:

Attributes depending on type: ######Color

  • folding_circles
  • nexus_rotation_cross
    • gpb:colors="@array/colors"
      • Optional, If not colors are define the 4 default google colors (red,blue, yellow and green) will be used.
      • It needs to be an array of 4 colors

So far google_music_dices doesn't have color options. The animation speed can be modified easily with android:indeterminateDuration in the xml.

Including in your project

You can either add the library to your application as a library project or add the following dependency to your build.gradle:

Maven Central

dependencies {
    compile 'com.jpardogo.googleprogressbar:library:(latest version)'
}

Proguard

In order to use this library with proguard you need to add this line to your proguard.cfg:

-keep class com.jpardogo.android.googleprogressbar.** { *; }

Acknowledgements

Developed By

Javier Pardo de Santayana Gómez - jpardogo@gmail.com

Follow me on Twitter Follow me on Google+ Follow me on LinkedIn
Copyright 2013 Javier Pardo de Santayana Gómez

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.