原文

先上Demo 效果

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 transitionContext, NSTimeInterval duration) {
      //Push動畫邏輯
  }];

  [XXTransition addPopAnimation:demoTransitionAnimationFragment animation:^(id 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 transitionContext, NSTimeInterval duration) {
 //Present 轉場邏輯
}];  

[XXTransition addDismissAnimation:demoTransitionAnimationModalSink backGestureDirection:XXBackGesturePanDown animation:^(id transitionContext, NSTimeInterval duration) {
 //Dismiss 轉場邏輯
}];
XXTransition 在dismiss的轉場交互中，支持下面幾中選擇

typedef NS_ENUM(NSInteger,XXBackGesture){
  XXBackGestureNone, //禁用手勢
  XXBackGesturePanLeft,
  XXBackGesturePanRight,
  XXBackGesturePanUp,
  XXBackGesturePanDown,
};

最後

如果你在使用XXTransition過程中發現任何問題，或是有任何建議，歡迎勾搭我。