先上Demo 效果
XXTransition 是什么鬼？
经历过几个公司，领导换了一波波，产品换了一波波，App的转场动画也是换了一波波，于是各种 AnimatedTransitioning、 InteractiveTransition代码也写了一波波。如果项目中用到多种转场效果，那代码目录可能是像这样的。
每个效果都分别有对应的实现了AnimatedTransitioning和InteractiveTransition逻辑的文件。
能不能简单点？方便的管理项目中用到的转场动画，方便的添加转场效果，同时也能满足各种转场效果的切换，手势交互的切换？ Yes，u can ! 这正是XXTransition能帮你做到的，请为它转身。
XXTransition 为嘛来到这世上？
- 方便添加自定义转场效果，将重心放在动画效果的实现上
- 自由管理项目中多种转场动画，转场手势的切换，(妈妈再也不用担心恶心的需求啦)
- 对于原使用系统转场的工程，集成后无需修改任何原代码。
- 提供转场动画库。我会不断添加朴实无华和牛哔闪闪的转场动画在代码中，供你直接调用。这些效果，包括我自己亲手和不是亲手写的，如有雷同，别计较啦，都是分享啦，当然如果有大牛小牛给我投稿，我会很开心哒，也会在代码中注释出处哒。
XXTransition 该怎么跑起来？
安装
Github地址:https://github.com/mh4u/XXTransition/
将XXTransition目录文件拖到工程中即可
使用
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//启动XXTransition自定义转场
[XXTransition startGoodJob:GoodJobTypeAll transitionDuration:0.3];
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
[self.window makeKeyAndVisible];
RootVC *vc = [[RootVC alloc] init];
self.window.rootViewController = [[UINavigationController alloc] initWithRootViewController:vc];
return YES;
}
这样一句话调用就可以开始工作啦！
Nav转场
- 初阶
+ (void)startGoodJob:(GoodJobType)goodJobType transitionDuration:(NSTimeInterval)duration;
该方法的第一个参数是枚举值
typedef NS_OPTIONS(NSUInteger, GoodJobType) {
GoodJobTypeNavOnly = 1 << 0,
GoodJobTypeModalOnly = 1 << 1,
GoodJobTypeAll = GoodJobTypeNavOnly | GoodJobTypeModalOnly
};
可以设置只使用自定义Nav转场还是Modal转场，或者全部使用。XXTransition会在提供的转场效果中设定一个默认的Nav转场效果。如果你原先工程中使用的是系统的Nav转场效果，那恭喜你，现在不需要改其他代码就已经可以实现自定义转场了哦（使用Modal转场和Nav转场有所区别，往下看）。
如果你想换一个XXTransition提供的Nav转场，这样设置就可以啦。
//启动XXTransition自定义转场
[XXTransition startGoodJob:GoodJobTypeAll transitionDuration:0.3];
//更改全局NavTransiton效果
[XXTransition setNavTransitonKey:XXTransitionAnimationNavPage];
可是按照PM的要求，是一个全新的转场效果怎么办，得自己写啦。XXTransition可以让你专注于动画的实现，交互手势都不用care
//添加自定义NavTransiton效果
NSString *someNBTransitionAnimation = @“someNBTransitionAnimation";
[XXTransition addPushAnimation:demoTransitionAnimationFragment animation:^(id<UIViewControllerContextTransitioning> transitionContext, NSTimeInterval duration) {
//Push动画逻辑
}];
[XXTransition addPopAnimation:demoTransitionAnimationFragment animation:^(id<UIViewControllerContextTransitioning> transitionContext, NSTimeInterval duration) {
//Pop动画逻辑
}];
//更改全局NavTransiton效果
[XXTransition setNavTransitonKey:someNBTransitionAnimation];
- 进阶
一般情况下，一个App只会用一种转场效果，但有讲究有追求的话，可能需要多种转场效果配合不同交互手势在不同VC互相push,pop时进行切换，简单画个图你就明白了
你遇到过吗，遇到了麻烦给个赞或者星，表示同病相怜，没遇到也麻烦给个星或者赞，因为我遇到了，让我感受到你的温暖。碰到这种情况，不要蓝瘦，不用香菇，看看XXTransition怎么解决。
//启动XXTransition自定义转场
[XXTransition startGoodJob:GoodJobTypeAll transitionDuration:0.3];
//更改全局NavTransiton效果
[XXTransition setNavTransitonKey:XXTransitionAnimationNavPage];
//注册特殊ViewController的NavTransiton效果和返回手势
[XXTransition registerPushViewController:[SinkVC class] forTransitonKey:XXTransitionAnimationNavSink];
[XXTransition registerPushViewController:[PageVC class] forTransitonKey:XXTransitionAnimationNavPage];
[XXTransition registerPopGestureType:XXPopGestureTypeFullScreen forViewController:[SinkVC class]];
[XXTransition registerPopGestureType:XXPopGestureTypeForbidden forViewController:[PageVC class]];
就这样，OK啦。SinkVC和PageVC分别使用响应的Nav转场效果和返回手势，而其他VC则使用全局转场效果
Modal转场
Modal切换ViewController的XXTransition使用方法和Nav有所不同，要在需要Present的使用调用UIViewController+XXTransition.h定义的方法
- (void)xx_presentViewController:(UIViewController *)viewControllerToPresent makeAnimatedTransitioning:(void (^)(XXAnimatedTransitioning *transitioning))block completion:(void (^ __nullable)(void))completion
使用如下
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
[tableView deselectRowAtIndexPath:indexPath animated:YES];
if (indexPath.row == 0) {
SinkVC *vc =[[SinkVC alloc] init];
[self.navigationController pushViewController:vc animated:YES];
} else {
ModalVC *vc = [[ModalVC alloc] init];
//XXTransition Modal转场
[self xx_presentViewController:vc makeAnimatedTransitioning:^(XXAnimatedTransitioning * _Nonnull transitioning) {
transitioning.duration = 0.5;
transitioning.animationKey = XXTransitionAnimationModalSink;
} completion:NULL];
}
}
如果你需要自己敲一个新的转场动画，类似于Nav转场中的自定义，专注动画实现，在下面两个方法中实现动画逻辑
[XXTransition addPresentAnimation:demoTransitionAnimationModalSink animation:^(id<UIViewControllerContextTransitioning> transitionContext, NSTimeInterval duration) {
//Present 转场逻辑
}];
[XXTransition addDismissAnimation:demoTransitionAnimationModalSink backGestureDirection:XXBackGesturePanDown animation:^(id<UIViewControllerContextTransitioning> transitionContext, NSTimeInterval duration) {
//Dismiss 转场逻辑
}];
XXTransition 在dismiss的转场交互中，支持下面几中选择
typedef NS_ENUM(NSInteger,XXBackGesture){
XXBackGestureNone, //禁用手势
XXBackGesturePanLeft,
XXBackGesturePanRight,
XXBackGesturePanUp,
XXBackGesturePanDown,
};
最后
如果你在使用XXTransition过程中发现任何问题，或是有任何建议，欢迎勾搭我。
