A drop in replacement of UINavigationController with predefined custom transition animations. Base on ADTransitionController. Support iOS6+ .
Base on ADTransitionController .
- 概述： GTNavigationViewController是ADTransitionController的一个封装。提供类似系统自带UINavigationController的接口，并提供17种预定义的转场动画模版。
- ADTransitionController通过实现一个自定义的Containner ViewControler来实现NavigationController的功能，提供17种自定义Transition动画模版。GTNavigationViewController通过继承ADTransitionController来简化ADTransitionController的使用，底层实现还是由ADTransitionController来提供的。
#####iOS7+
- 在iOS7+上，系统提供了自定义Transition动画的接口，通过由三个协议来实现，如何通过iOS7以后提供的官方API实现自定义转场动画可以参考这个系列的blog：
///协议1: UINavigationControllerDelegate
- (id <UIViewControllerInteractiveTransitioning>)navigationController:(UINavigationController *)navigationController
interactionControllerForAnimationController:(id <UIViewControllerAnimatedTransitioning>) animationController NS_AVAILABLE_IOS(7_0);
- (id <UIViewControllerAnimatedTransitioning>)navigationController:(UINavigationController *)navigationController
animationControllerForOperation:(UINavigationControllerOperation)operation
fromViewController:(UIViewController *)fromVC
toViewController:(UIViewController *)toVC NS_AVAILABLE_IOS(7_0);
************************
///协议2: UIViewControllerTransitioningDelegate
- (id <UIViewControllerAnimatedTransitioning>)animationControllerForPresentedController:(UIViewController *)presented presentingController:(UIViewController *)presenting sourceController:(UIViewController *)source;
- (id <UIViewControllerAnimatedTransitioning>)animationControllerForDismissedController:(UIViewController *)dismissed;
- (id <UIViewControllerInteractiveTransitioning>)interactionControllerForPresentation:(id <UIViewControllerAnimatedTransitioning>)animator;
- (id <UIViewControllerInteractiveTransitioning>)interactionControllerForDismissal:(id <UIViewControllerAnimatedTransitioning>)animator;
- (UIPresentationController *)presentationControllerForPresentedViewController:(UIViewController *)presented presentingViewController:(UIViewController *)presenting sourceViewController:(UIViewController *)source NS_AVAILABLE_IOS(8_0);
************************
/// 协议3: UIViewControllerAnimatedTransitioning
- (NSTimeInterval)transitionDuration:(id <UIViewControllerContextTransitioning>)transitionContext;
- (void)animateTransition:(id <UIViewControllerContextTransitioning>)transitionContext;
************************
虽然系统提供了接口，但是实现起来比较复杂，需要学习成本，ADTransitionController为我们提供了两个类：ADNavigationControllerDelegate 和 ADTransitioningDelegate, 其中ADNavigationControllerDelegate实现了UINavigationControllerDelegate，实例化一个该类的实例作为UINavigationController的代理就可以不需要再处理UINavigationControllerDelegate协议。ADTransitioningDelegate实现了 协议2: UIViewControllerTransitioningDelegate和协议3: UIViewControllerAnimatedTransitioning，同样的，实例化一个ADTransitioningDelegate的实例作为UIViewController的tansitioningDelegate即可以不需要再处理这两个协议。 而且ADTransitionController为我们提供了一个预先定义好的ADTransitioningViewController，使自己的VC继承自ADTransitioningViewController，则可以方便地处理协议2和协议3，具体参考下面的例子：
iOS7+ 中使用方式：
1. 当ViewController继承ADTransitioningViewController时
//////////////////在appDelegate的didFinishLaunchWithOptions:中///////////
// #import "ADNavigationControllerDelegate.h"
...
UINavigationController * navigationController = [[UINavigationController alloc] initWithRootViewController:viewController]; //viewController是ADTransitioningViewController子类的一个实例
ADNavigationControllerDelegate * navigationDelegate = [[ADNavigationControllerDelegate alloc] init];
navigationController.delegate = navigationDelegate;
self.window.rootViewController = navigationController;
//////////////////在需要push新的ViewController时///////////
ViewController * newViewController = [[ViewController alloc] init]; // ViewController是ADTransitioningViewController的一个子类
ADTransition * transition = [[ADCubeTransition alloc] initWithDuration:0.25f orientation:ADTransitionRightToLeft sourceRect:self.view.frame];
newViewController.transition = transition;
[self.navigationController pushViewController:newViewController animated:YES];
*********************************************************************************
2.实际工程中，我们可能并不希望我们的所有ViewContrller都继承自ADTransitioningViewController，此时，我们可以通过实例化一个ADTransitioningDelegate来作为tansitioningDelegate，具体做法如下：
//////////////////在appDelegate的didFinishLaunchWithOptions:中///////////
// #import "ADNavigationControllerDelegate.h"
...
UINavigationController * navigationController = [[UINavigationController alloc] initWithRootViewController:viewController]; //NOTE：viewController不是ADTransitioningViewController子类的一个实例，而是普通的VC类
ADNavigationControllerDelegate * navigationDelegate = [[ADNavigationControllerDelegate alloc] init];
navigationController.delegate = navigationDelegate;
self.window.rootViewController = navigationController;
//////////////////在需要push新的ViewController时///////////
UIViewController * newViewController = [[UIViewController alloc] init];
ADTransition * transition = [[ADCubeTransition alloc] initWithDuration:0.25f orientation:ADTransitionRightToLeft sourceRect:self.view.frame];
ADTransitioningDelegate * transitioningDelegate = [[ADTransitioningDelegate alloc] initWithTransition:transition];
newViewController.transitioningDelegate = transitioningDelegate;
[self.navigationController pushViewController:newViewController animated:YES];
#####iOS6+
- 在iOS6+上可以直接使用GTNavigationController,使用方式如下：
... In appDelegate ,在初始化时制定GTNavigationController使用的动画类型
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
//Setup GTNavigationViewController
GTDemoViewController *vc = [[GTDemoViewController alloc] init];
GTNavigationViewController *navi = [[GTNavigationViewController alloc] initWithRootViewController:vc transitionType:GTNavigationTransitionTypePush];
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
self.window.backgroundColor = UIColor.whiteColor;
self.window.rootViewController = navi;
[self.window makeKeyAndVisible];
return YES;
}
... In viewController ,不需要继承ADTransitioningViewController
...#import "UIViewController+ADTransitionController.h"
/// 使用GTNavigationController初始化时指定的转场动画
- (void)onPushButtonTapped:(UIButton *)sender
{
GTDemoViewController *newVC = [GTDemoViewController new];
[self.gtNavigationController pushViewController:newVC animated:YES/NO];
}
/// 使用其他动画
- (void)onPushButtonTapped:(UIButton *)sender
{
ADBackFadeTransition *customTransition = [[ADBackFadeTransition alloc] initWithDuration:0.5];
[self.gtNavigationController pushViewController:newVC withTransition:customTransition];
}
- 若工程只需要支持iOS7+，建议使用iOS7+上的使用方式
- 若使用iOS6+上的方式时，每一个ViewController都是可以自定义push时的动画的，当没有自定义时会使用初始化GTNavigationController时指定的统一动画类型。当然，同时建议一个App中的navigation的动画保持统一。
- GTNavigationController中的Demo主要演示如何使用该扩展类（支持iOS6＋），可以通过进入设置页修改不同动画效果。ADTransitionController中带的Demo演示了iOS7＋上的使用方式和iOS6＋上未扩展时的使用方式。