TestsTested | ✗ |
LangLanguage | Obj-CObjective C |
License | BSD 3.0 |
ReleasedLast Release | Dec 2014 |
Maintained by Michael Sedlaczek.
Animates the transition from the launch image to the app's initial view controller on iOS. Includes customized animation delay and duration, triggering the transition via notification and display of an activity indicator.
If you're using this pod or found it somehow useful, I'd be happy if you'd let me know.
To see this pod in action before using it in your project you should download the repository and have a look at the example project that's included.
Download repository as ZIP archive
The easiest way is to add the following code to your app delegate (e. g. AppDelegate.m):
#import <GCOLaunchImageTransition/GCOLaunchImageTransition.h>
- (void)applicationDidBecomeActive:(UIApplication *)application
{
[...]
// Add transition from the launch image to the root view controller's view
[GCOLaunchImageTransition transitionWithDuration:0.5 style:GCOLaunchImageTransitionAnimationStyleZoomIn];
}
Don't worry, although this code is being added to -applicationDidBecomeActive
the code for creating the transition is only executed once — Grand Central Dispatch sees to that with its dispatch_once()
method.
You can also create a transition with a (near-)infinite delay that can be dismissed at a specific point by posting a notification:
#import <GCOLaunchImageTransition/GCOLaunchImageTransition.h>
- (void)applicationDidBecomeActive:(UIApplication *)application
{
[...]
// Create transition with an near-infinite delay that requires manual dismissal via notification
[GCOLaunchImageTransition transitionWithInfiniteDelayAndDuration:0.5 style:GCOLaunchImageTransitionAnimationStyleFade];
}
// At some point within your app's startup code dismiss the transition by posting a notification
- (void)someStartupProcedureDidFinish
{
[[NSNotificationCenter defaultCenter] postNotificationName:GCOLaunchImageTransitionHideNotification object:self];
}
Finally you can add an activity indicator to the launch image transition using the fully customizable transition creation:
#import <GCOLaunchImageTransition/GCOLaunchImageTransition.h>
- (void)applicationDidBecomeActive:(UIApplication *)application
{
[...]
// Create fully customizable transition including an optional activity indicator
// The 'activityIndicatorPosition' is a percentage value ('CGPointMake( 0.5, 0.5 )' being the center)
[GCOLaunchImageTransition transitionWithDelay:5.0 duration:0.5 style:GCOLaunchImageTransitionAnimationStyleZoomOut activityIndicatorPosition:CGPointMake( 0.5, 0.9 ) activityIndicatorStyle:UIActivityIndicatorViewStyleWhiteLarge];
}
Note: You can always use GCOLaunchImageTransitionNearInfiniteDelay
for the delay parameter if you prefer to dismiss the transition manually.
This pod is compatible with ARC enabled projects by default. CocoaPods will handle the ARC settings for you.
I absolutely appreciate any suggestions or improvements you may have in mind for this pod. That being said the most welcomed form of contribution would be a pull request from your own fork of this repository on GitHub. If you only have a minor problem or suggestion consider opening an issue.
I'm Michael Sedlaczek, Gone Coding. I'm also using Twitter: @gonecoding
GCOLaunchImageTransition is released under the New BSD License. For details see LICENSE.
This license requires attribution when redistributing the component as source code or in binary form.