simudream / sksplashview

Create custom animated splash views similar to the ones in the Twitter, Uber and Ping iOS app.

SKSplashView

SKSplashView is a simple class to create beautiful animated splash views for transitioning between views. Perfect as a launch screen while your app loads.

The splash view allows you to create an animated background view with preset animations with the option of adding a splash icon that will animate as long as the splash view is animating.

Installation

Cocoapods

SKSplashView is available through Cocoapods. To install it, simply add the following to your Podfile. ``` pod 'SKSplashView' ```

Alternative

If installation through Cocoapods doesn't work or if you aren't comfortable using it, you can always just drag and drop the folder 'SKSplashView' into your project and ``#import "SKSplashView.h"`` and you're ready to go.

Implementation

SKSplashView

Simply create an instance of SKSplashView with the desired customizability option. ``` SKSplashView *splashView = [[SKSplashView alloc] initWithBackgroundColor:[UIColor blueColor] animationType:SKSplashAnimationTypeZoom]; //The SplashView can be initialized with a variety of animation types and backgrounds. See customizability for more. splashView.animationDuration = 3.0f; //Set the animation duration (Default: 1s) [self.view addSubview:splashView]; //Add the splash view to your current view [splashView startAnimation]; //Call this method to start the splash animation ``` The SplashView can also be initialized with the following methods: ``` - (instancetype)initWithAnimationType: (SKSplashAnimationType) animationType; - (instancetype)initWithBackgroundColor: (UIColor *) backgroundColor animationType: (SKSplashAnimationType) animationType; - (instancetype)initWithBackgroundImage: (UIImage *) backgroundImage animationType: (SKSplashAnimationType) animationType; - (instancetype)initWithSplashIcon: (SKSplashIcon *)icon animationType: (SKSplashAnimationType) animationType; - (instancetype) initWithSplashIcon:(SKSplashIcon *)icon backgroundColor: (UIColor *) backgroundColor animationType:(SKSplashAnimationType) animationType; - (instancetype) initWithSplashIcon:(SKSplashIcon *)icon backgroundImage:(UIImage *) backgroundImage animationType:(SKSplashAnimationType) animationType; ```

Customizability

The appearance of the splash view can be customized with the following properties: ``` @property (strong, nonatomic) UIColor *backgroundViewColor; //Sets the background color of the splash view (Default: white) @property (strong, nonatomic) UIImage *backgroundImage; //Sets a background image to the splash view @property (nonatomic, assign) CGFloat animationDuration; //Sets the duration of the splash view ``` The Splash view also allows you to customize the animation transition of the splash view with the following types: ``` SKSplashAnimationTypeFade, SKSplashAnimationTypeBounce, SKSplashAnimationTypeShrink, SKSplashAnimationTypeZoom, SKSplashAnimationTypeNone, SKSplashAnimationTypeCustom ```

SKSplashIcon

In addition to adding an animated splash view, you can also add an icon on your splash view with its own customizability options that will animate as long as the splash view is running. To add a splash icon to your splash view:

1. #import "SKSplashIcon.h" in the view you are presenting the splash view

2. Initialize the splash view as follows:

SKSplashIcon *splashIcon = [[SKSplashIcon alloc] initWithImage:[UIImage imageNamed:@"test.png"] animationType:SKIconAnimationTypeNone]; 
//Initialize with the customizability option of your choice. See Customizability for more.

3. Add the splash icon when you are initializing your splash view

SKSplashView *splashView = [SKSplashView alloc] initWithSplashIcon:splashIcon backgroundColor:splashColor animationType:SKSplashAnimationTypeFade];

You can also add the splash icon when initializing the splash view with the following methods:

- (instancetype)initWithSplashIcon: (SKSplashIcon *)icon animationType: (SKSplashAnimationType) animationType;
- (instancetype) initWithSplashIcon:(SKSplashIcon *)icon backgroundColor: (UIColor *) backgroundColor animationType:(SKSplashAnimationType) animationType;
- (instancetype) initWithSplashIcon:(SKSplashIcon *)icon backgroundImage:(UIImage *) backgroundImage animationType:(SKSplashAnimationType) animationType;

Customizability

The appearance of the splash icon can be customized with the following properties:

@property (strong, nonatomic) UIColor *iconColor; //Sets the icon color of the icon (Default: white)
@property (nonatomic, assign) CGSize iconSize; //Sets the size of the icon (Default: 60x60)

The animation of the splash icon can also be customized with the following animation types:

    SKIconAnimationTypeBounce,
    SKIconAnimationTypeGrow,
    SKIconAnimationTypeShrink,
    SKIconAnimationTypeFade,
    SKIconAnimationTypePing,
    SKIconAnimationTypeBlink,
    SKIconAnimationTypeNone,
    SKIconAnimationTypeCustom

Delegate

You can optionally add the SplashView delegate to your view controller to listen to when the splash view begins and ends animating. To do this: - Add `` to your interface - Set the delegate to your splash view `splashView.delegate = self;` - Add the following methods to listen to updates ``` - (void) splashView:(SKSplashView *)splashView didBeginAnimatingWithDuration:(float)duration { NSLog(@"Splash view started animating with duration %f", duration); }

• (void) splashViewDidEndAnimating:(SKSplashView *)splashView { NSLog(@"Splash view stopped animating"); }

<h1> Special Feature </h1>
SKSplashView also allows you to run a splash animation while executing a network request. This is ideal in situations where your app takes time during launch to download necessary data.
By simply calling:

[splashView startAnimationWhileExecuting:request withCompletion:^(NSData *data, NSURLResponse *response, NSError *error) {}];

with an initialized splash view, the splash animation will repeat until you've downloaded everything you need to get started!

<img src = "https://github.com/sachinkesiraju/SKSplashView/raw/master/SKSplashViewDemo/Example%20GIFs/uber.gif" width = "320px" height = "568"/>

<i> Note: This feature currently does not allow animation of the splash view itself but allows for certain splash icon animations. </i>

<h1> Example </h1> 

Some examples of splash views created using SKSplashView (Twitter iOS app and Ping iOS app). All code to the examples is available in the <a href = https://github.com/sachinkesiraju/SKSplashView/tree/master/SKSplashViewDemo> Demo. </a>
If you found a way to mimic another popular iOS app's splash view using SKSplashView, let <a href = "https://twitter.com/_sachink"> me </a> know so I can add it here.

<img src = "https://github.com/sachinkesiraju/SKSplashView/raw/master/SKSplashViewDemo/Example%20GIFs/twitter.gif" width = "320px" height = "568"/> <img src="https://github.com/sachinkesiraju/SKSplashView/blob/master/SKSplashViewDemo/Example%20GIFs/ping.gif" width = "320px" height = "568"/> 

For more help getting started with SKSplashView, check out the <a href = https://github.com/sachinkesiraju/SKSplashView/tree/master/SKSplashViewDemo> Demo </a>

<h1> Community </h1>
If you feel you can improve or add more customizability to SKSplashView, feel free to raise an issue/submit a PR.

For any questions, reach out to me on Twitter <a href = "https://twitter.com/_sachink"> @sachinkesiraju </a>

<h1> License </h1>
SKSplashView is available under the MIT License. See the <a href= https://github.com/sachinkesiraju/SKSplashView/blob/master/LICENSE> LICENSE </a> for more info.