Android SplashScreen

Android library for getting a nice and simple splash screen into your Android app.

Installation

Up to now, the library is only available on JitPack. Please add this code to your build.gradle file on project level:

allprojects {
  repositories {
    ...
    maven { url 'https://jitpack.io' }
  }
}

To load the library into your project, use this code in the build.gradle file within the app module:

  implementation 'com.github.ChilliBits:splash-screen:1.1.7'

Usage

To use the splash screen, paste this code to the beginning of the onCreate method of the launcher activity of your app. For better performance, we recommend to do this before setContentView().

SplashScreenBuilder.getInstance(this)
    .setVideo(R.raw.splash_animation)
    .setVideoDark(R.raw.splash_animation_dark)
    .setImage(R.drawable.app_icon)
    .show()

Tip: If you want to have a custom activity transition, you can call overridePendingTransition(R.anim.customEnterAnim, R.anim.customExitAnim) after dispatching .show() of the splash screen.

If you want to receive a result from the splash screen, you can override onActivityResult as following:

Kotlin

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == SplashScreenBuilder.SPLASH_SCREEN_FINISHED) {
        if (resultCode == Activity.RESULT_OK) {
            //SplashScreen finished without manual canceling
        } else if (resultCode == Activity.RESULT_CANCELED) {
            //SplashScreen finished through manual canceling
        }
    }
}

If you want to have a look onto a implemented example in Kotlin, look at the MainActivity.kt file.

Java

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == SplashScreenBuilder.SPLASH_SCREEN_FINISHED) {
        if (resultCode == RESULT_OK) {
            //SplashScreen finished without manual canceling
        } else if(resultCode == RESULT_CANCELED) {
            //SplashScreen finished through manual canceling
        }
    }
}

If you want to have a look onto a implemented example in Java, look at the MainActivity.java file.

You can customize the appearance of the SplashScreen using following arguments when building the Activity with SplashScreenBuilder:

Thank you for using the SplashScreen library!

© ChilliBits 2018-2021 (Designed and developed by Marc Auberer)