inamiy / yisplashscreen Goto Github PK

View Code? Open in Web Editor NEW

141.0 22.0 32.0 6.84 MB

Easy splash screen + animation maker for iOS5+.

Home Page: http://www.moongift.jp/2012/09/20120909-2/

Objective-C 83.47% Ruby 2.20% MATLAB 14.33%

yisplashscreen's Introduction

YISplashScreen 1.2.1

Easy splash screen + animation maker for iOS5+ (including iOS7).

YISplashScreen creates another UIWindow on top of status-bar so that transition will be nicer, compared to adding splash image directly on mainWindow.rootViewController.view.
animationBlock is used to hide splash image with two arguments:
- splashLayer: splash image layer
- rootLayer: copy of mainWindow.rootViewController.view.layer

View hierarchy before animation

mainWindow (not visible)
- mainWindow.rootViewController.view
splashWindow
- splashWindow.rootViewController.view (rotateable)
  - rootLayer (copy of mainWindow.rootViewController.view)
  - splashLayer (splash image layer)

Install via CocoaPods

pod 'YISplashScreen'

How to use

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // show splash
    [YISplashScreen show];
    
    // simple fade out
    [YISplashScreen hide];
    
    return YES;
}

Hiding Animations

// simple fade out
[YISplashScreen hide];

// cube
[YISplashScreen hideWithAnimation:[YISplashScreenAnimation cubeAnimation]];

// manually add animation
[YISplashScreen hideWithAnimationBlock:^(CALayer* splashLayer, CALayer* rootLayer) {
    
    // splashLayer moves up
    [CATransaction begin];
    [CATransaction setAnimationDuration:0.7];
    [CATransaction setAnimationTimingFunction:[CAMediaTimingFunction functionWithName:kCAMediaTimingFunctionEaseInEaseOut]];
    
    splashLayer.position = CGPointMake(splashLayer.position.x, splashLayer.position.y-splashLayer.bounds.size.height);
    
    [CATransaction commit];
    
}];

CoreData Migration

By using [YISplashScreen showAndWaitForMigration:completion:] (optional), you can easily integrate simple UIAlertView-confirmation UI.

[YISplashScreen showAndWaitForMigration:^{
    
    //
    // NOTE: add CoreData migration logic here
    //
    
    NSDictionary *options = [NSDictionary dictionaryWithObjectsAndKeys:
                             [NSNumber numberWithBool:YES], NSMigratePersistentStoresAutomaticallyOption,
                             [NSNumber numberWithBool:YES], NSInferMappingModelAutomaticallyOption, nil];
    
    [persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType
                                             configuration:nil
                                                       URL:url
                                                   options:options
                                                     error:nil];

} completion:^{
    
    [YISplashScreen hide];
    
}];

License

YISplashScreen is available under the Beerware license.

If we meet some day, and you think this stuff is worth it, you can buy me a beer in return.

yisplashscreen's People

Contributors

Stargazers

Watchers

yisplashscreen's Issues

Issues with new screen sizes

The plugin isn't working with the iPhone 6 and 6+. It seems to be loading in the normal iPhone screen.

Solution to new iPhone Screen Sizes

Thanks for the great API. The following code should work with any screen size, until Apple substantively changes this portion of the API where UILaunchImages doesn't work anymore. That said, this method could fallback to your existing code in such a case, as it does in my subclass. :

@implementation YIPSplashScreen {}
+ (UIImage*)_preferredSplashImage
{
    NSArray* imagesDict = [[[NSBundle mainBundle] infoDictionary] valueForKey:@"UILaunchImages"];
    CGSize screenSize = [[UIScreen mainScreen] bounds].size;
    NSString* viewOrientation = @"Portrait";

    if(!IS_PORTRAIT) {
        viewOrientation = @"Landscape";
        screenSize = CGSizeMake(screenSize.height,screenSize.width);
    }

    for (NSDictionary* dict in imagesDict) {
        // Can't find iPhone 6 HD using old method, however below technique seems to work well.
        // http://stackoverflow.com/questions/19107543/xcode-5-asset-catalog-how-to-reference-the-launchimage
        CGSize imageSize = CGSizeFromString(dict[@"UILaunchImageSize"]);
        if (CGSizeEqualToSize(imageSize, screenSize) &&
                [viewOrientation isEqualToString:dict[@"UILaunchImageOrientation"]]) {
            return [UIImage imageNamed:dict[@"UILaunchImageName"]];
        }
    }


   return nil; // or you can just keep former code below here, though it will unlikely ever be called.
}
@end

Not showing view from storyboard

Hi,

I call [YISplashScreen show] in didFinishLaunchingWithOptions but don't call [YISplashScreen hide] until my UIWebView has loaded - which my ViewController finds out about later.

Except that my ViewController (created via a storyboard) doesn't load. Looking at your code, it seems that your fix for the following issue:

... has caused this.

If I put the call to [YISplashScreen hide] after [YISplashScreen show] in didFinishLaunchingWithOptions then my view controller loads. But I need my hide to be under programmatic control as indicated.

Thanks,

Tim

"Application windows are expected to have a root view controller at the end of application launch"

Hiya. I've tried using your default example with a storyboard project using the code:

(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

// show splash
[YISplashScreen show];

// simple fade out
[YISplashScreen hide];

return YES;
}

.. on iOS 5.1.1 and iOS 6.0 I don't get the splash screen fade effect and the console logs out:

"Application windows are expected to have a root view controller at the end of application launch"

Any ideas?

EDIT: If I remove the two YISplashScreen lines I no longer get this message.

Splash gets move when launching app with the status bar

Hi,

The splash image gets move when launching an app with the status bar shown. Is there a quick fix for that behavior?

Thanks,
Martin

Doesn't support 4.7 and 5.5 inch screen.

Hi,

I have your YISplashScreen in my app and its awesome but it doesn't work perfectly on 4.7 and 5.5 inch screen.

Can you please update it?