[CN]CYLTabBarController【一行代码实现 Lottie 动画 TabBar】iOS27+ Tested

[EN]CYLTabBarController [An animated tabBar supported by Lottie with one line of code]

---

[CN]阅读须知

[EN]Before Reading

[CN]最新版本预览

[EN]Preview of the latest version

Preview of the latest version on iOS 27+

[CN]1.100.0 新增功能

[EN]What’s new in 1.100.0

[CN]iOS 27 和 iPhone Duo 适配

[EN]iOS 27 and iPhone Duo support

CYLTabBarController 现已适配 iOS 27，新增如下功能： CYLTabBarController now supports iOS 27 with the following improvements:

现在已适配 iPhone Duo 的横向布局与竖向布局，请更新至 CYLTabBarController 1.99.66 查看。 It also supports both landscape and portrait layouts on iPhone Duo. Update to CYLTabBarController 1.99.66 to try it.

CYLTabBarController 现已适配 iOS 27 和 iPhone Duo，更新内容如下： CYLTabBarController now supports iOS 27 and iPhone Duo with the following features:

请更新 CYLTabBarController 1.99.66 查看演示： Update to CYLTabBarController 1.99.66 to see the demo:

1.99.39 版本现已支持在 iOS 26 运行期间增加或删除加号按钮。效果见下方演示，欢迎访问 Demo 进行尝试： Version 1.99.39 supports adding or removing the plus button at runtime on iOS 26. See the demo below or visit the Demo to try it:

[CN]谁在使用？已上架 App 列表

[EN]Who is using it? Published apps

[CN]导航

[EN]CONTENTS

[CN]文档索引

[EN]Documentation index

[CN]与其他自定义 TabBarController 的区别

[EN]Comparison with other libraries

学习交流群：515295083 Learning group: 515295083.

[CN]集成后的效果

[EN]Results after integration

Supports portrait and landscape orientations.

[CN]项目结构

[EN]Project structure

说明： The directory structure is organized as follows:

├── CYLTabBarController  # 核心库文件夹；不使用 CocoaPods 时可直接拖入项目 / The library; drag it into your project if you do not use CocoaPods
└── Example
   └── Classes
       ├── Module       # 模块类文件夹 / Module classes
       │   ├── Home
       │   ├── Message
       │   ├── Mine
       │   └── SameCity
       └── View         # CYLPlusButton 子类；演示自定义不规则 PlusButton / CYLPlusButton subclasses: custom irregular plus buttons

[CN]演示工程

[EN]Demo projects

[CN]版本要求

[EN]Version requirements

[CN]使用 CYLTabBarController

[EN]Using CYLTabBarController

[CN]第一步：使用 CocoaPods 导入 CYLTabBarController

[EN]Step 1: Import CYLTabBarController with CocoaPods

[CN]1. 安装 CocoaPods

[EN]1. Install CocoaPods

    sudo gem install cocoapods  

    gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/     sudo gem install cocoapods  

[CN]2. 查询 CocoaPods 源

[EN]2. Search the CocoaPods repository

    pod search CYLTabBarController  

    pod repo update  

[CN]3. 使用 CocoaPods 导入

[EN]3. Integrate with CocoaPods

    pod init  

gem install cocoapods

pod 'CYLTabBarController', '~> 1.100.0'

pod install

# 禁止升级 CocoaPods 的 spec 仓库，否则会卡在 Analyzing dependencies，非常慢
pod update --verbose --no-repo-update

[CN]CocoaPods 使用说明

[EN]CocoaPods usage notes

[CN]指定 CYLTabBarController 版本

[EN]Pinning the CYLTabBarController version

pod 'CYLTabBarController', '~> 1.100.0'

[CN]升级本地 CocoaPods 源

[EN]Update the local CocoaPods repository

pod repo update

[CN]升级工程中的 CYLTabBarController 版本

[EN]Upgrade CYLTabBarController in the project

pod update

[CN]清除 CocoaPods 本地缓存

[EN]Clear the CocoaPods cache

[CN]查看当前使用的版本

[EN]Check the installed version

[CN]使用 Carthage 导入 CYLTabBarController（可选）

[EN]Import CYLTabBarController with Carthage (optional)

github "ChenYilong/CYLTabBarController"

carthage update --use-xcframeworks --platform iOS

[CN]第二步：设置 CYLTabBarController 的两个数组

[EN]Step 2: Configure the view controller and tab bar item attribute arrays

//MainTabBarController

@interface MainTabBarController : CYLTabBarController
@end

- (instancetype)init {
   /**
    * 以下两行代码目的在于手动设置让TabBarItem只显示图标，不显示文字，并让图标垂直居中。
    * 等效于在 `-tabBarItemsAttributesForTabBar` 方法中不传 `CYLTabBarItemTitle` 字段。
    * 更推荐后一种做法。
    */
   UIEdgeInsets imageInsets = UIEdgeInsetsZero;//UIEdgeInsetsMake(4.5, 0, -4.5, 0);
   UIOffset titlePositionAdjustment = UIOffsetMake(0, -3.5);
   // Initialize self through super. Don't create another CYLTabBarController and return it from -init: the app would
   // then show that plain instance, so this subclass's methods (-viewDidLoad, badge blocks, delegates) never run (#404).
   // 通过 super 初始化 self。不要在 -init 中创建另一个 CYLTabBarController 并返回它：App 显示的会是那个普通实例，
   // 本子类的方法（-viewDidLoad、角标 block、代理）都不会执行（#404）。
   if (self = [super initWithViewControllers:[self viewControllersForTabBar]
                       tabBarItemsAttributes:[self tabBarItemsAttributesForTabBar]
                                 imageInsets:imageInsets
                     titlePositionAdjustment:titlePositionAdjustment
                                     context:nil]) {
       [self customizeTabBarAppearance:self];
   }
   return self;
}

// Not named -viewControllers: that would override UITabBarController's own property.
// 不要命名为 -viewControllers：那会覆盖 UITabBarController 自身的属性。
- (NSArray *)viewControllersForTabBar {
   CYLHomeViewController *firstViewController = [[CYLHomeViewController alloc] init];
   UIViewController *firstNavigationController = [[CYLBaseNavigationController alloc]
                                                  initWithRootViewController:firstViewController];
   [firstViewController cyl_setHideNavigationBarSeparator:YES];
   CYLSameCityViewController *secondViewController = [[CYLSameCityViewController alloc] init];
   UIViewController *secondNavigationController = [[CYLBaseNavigationController alloc]
                                                   initWithRootViewController:secondViewController];
   [secondViewController cyl_setHideNavigationBarSeparator:YES];
   NSArray *viewControllers = @[
                                firstNavigationController,
                                secondNavigationController,
                                ];
   return viewControllers;
}

- (NSArray *)tabBarItemsAttributesForTabBar {
   NSDictionary *firstTabBarItemsAttributes = @{
                                                CYLTabBarItemTitle : @"首页",
                                                CYLTabBarItemImage : @"home_normal",  /* NSString and UIImage are supported*/
                                                CYLTabBarItemDarkImage : @"home_normal_night",  /* optional, Dark Mode */
                                                CYLTabBarItemSelectedImage : @"home_highlight",  /* NSString and UIImage are supported*/
                                                };
   NSDictionary *secondTabBarItemsAttributes = @{
                                                 CYLTabBarItemTitle : @"同城",
                                                 CYLTabBarItemImage : @"fishpond_normal",
                                                 CYLTabBarItemSelectedImage : @"fishpond_highlight",
                                                 };

   NSArray *tabBarItemsAttributes = @[
                                      firstTabBarItemsAttributes,
                                      secondTabBarItemsAttributes,
                                      ];
   return tabBarItemsAttributes;
}

[CN]图片传名称（NSString）还是 UIImage？

[EN]Image names (NSString) or UIImage objects?

[CN]第三步：将 CYLTabBarController 设置为 window 的 RootViewController

[EN]Step 3: Set CYLTabBarController as the window’s root view controller

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
/* *省略部分：   * */
   [self.window setRootViewController:self.tabBarController];
/* *省略部分：   * */
   return YES;
}

// SceneDelegate
- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {
   if (![scene isKindOfClass:[UIWindowScene class]]) { return; }
   self.window = [[UIWindow alloc] initWithWindowScene:(UIWindowScene *)scene];
   [self.window cyl_setRootViewControllerProvider:^UIViewController *{
       return [[MainTabBarController alloc] init];
   }];
   [self.window makeKeyAndVisible];
}

[CN]第四步（可选）：创建自定义的不规则加号按钮

[EN]Step 4 (optional): Create a custom irregular plus button

// 错误示例 / Wrong: do not do this
+ (void)load {
   [super registerPlusButton];
}

+ (NSUInteger)indexOfPlusButtonInTabBar;
+ (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight;
+ (UIViewController *)plusChildViewController;
+ (BOOL)shouldSelectPlusChildViewController;

+ (NSUInteger)indexOfPlusButtonInTabBar;

+ (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight;

+ (CGFloat)constantOfPlusButtonCenterYOffsetForTabBarHeight:(CGFloat)tabBarHeight;

+ (UIViewController *)plusChildViewController;

   //去除 TabBar 自带的顶部阴影
   [[UITabBar appearance] setShadowImage:[[UIImage alloc] init]];

// iOS 10 and later: use -[CYLTabBarController hideTabBarShadowImageView]. // See the AppDelegate example.

[CN]让 PlusButton 的标题与 Tab 标题对齐

[EN]Align the PlusButton’s title with the tab titles

[CN]调整 PlusButton 与 TabBarItem 的宽度

[EN]Customize the PlusButton and TabBarItem widths

TabBarItem 宽度 ＝  ( TabBar 总宽度 －  PlusButton 宽度  ) / (TabBarItem 个数)

[button sizeToFit];

button.frame = CGRectMake(0.0, 0.0, 250, 100);
button.backgroundColor = [UIColor redColor];

[CN]补充说明

[EN]Additional notes

[CN]自定义 TabBar 样式

[EN]Customizing the TabBar appearance

/**
*  tabBarItem 的选中和不选中文字属性、背景图片
*/
- (void)customizeInterface {

   // 普通状态下的文字属性
   NSMutableDictionary *normalAttrs = [NSMutableDictionary dictionary];
   normalAttrs[NSForegroundColorAttributeName] = [UIColor grayColor];

   // 选中状态下的文字属性
   NSMutableDictionary *selectedAttrs = [NSMutableDictionary dictionary];
   selectedAttrs[NSForegroundColorAttributeName] = [UIColor darkGrayColor];

   // 设置文字属性
   UITabBarItem *tabBar = [UITabBarItem appearance];
   [tabBar setTitleTextAttributes:normalAttrs forState:UIControlStateNormal];
   [tabBar setTitleTextAttributes:selectedAttrs forState:UIControlStateSelected];

   // 设置背景图片
   UITabBar *tabBarAppearance = [UITabBar appearance];
   [tabBarAppearance setBackgroundImage:[UIImage imageNamed:@"tabbar_background"]];
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
/* *省略部分：   * */
   [self.window makeKeyAndVisible];
   [self customizeInterface];
   return YES;
}

[CN]捕获 TabBar 点击事件

[EN]Handling TabBar selection events

//CYLTabBarController.h

@protocol CYLTabBarControllerDelegate 

/*!
* @param tabBarController The tab bar controller containing viewController.
* @param control Selected UIControl in TabBar.
* @attention If PlusButton also add an action, then this delegate method will not be invoked when the PlusButton is selected.
*/
- (void)tabBarController:(UITabBarController *)tabBarController didSelectControl:(UIControl *)control;

@end

//UITabBarController.h
@protocol UITabBarControllerDelegate 
@optional
- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController NS_AVAILABLE_IOS(3_0);
@end

- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController {
   [[self cyl_tabBarController] updateSelectionStatusIfNeededForTabBarController:tabBarController shouldSelectViewController:viewController];
   return YES;
}

@interface AppDelegate ()

@end

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
   //...
       tabBarControllerConfig.tabBarController.delegate = self;
   //...
   return YES;
}

[CN]用标识区分 Tab

[EN]Telling tabs apart by identifier

NSDictionary *messageAttributes = @{
    CYLTabBarItemTitle : @"消息",
    CYLTabBarItemImage : @"message_normal",
    CYLTabBarItemIdentifier : @"message",
};

// CYLPlusButtonSubclass.m
+ (NSString *)tabBarItemIdentifier {
    return @"plus";
}

// Called for every tab button and the plus button. 点击任意 Tab 按钮和 PlusButton 都会调用。
- (void)tabBarController:(CYLTabBarController *)tabBarController didSelectControl:(UIControl *)control {
    NSString *identifier = control.cyl_tabBarItemIdentifier;
    NSLog(@"[%@] tapped %@", tabBarController.context, identifier);
    for (NSString *eachIdentifier in tabBarController.cyl_tabBarItemIdentifiers) {
        UIControl *eachControl = [tabBarController cyl_controlWithTabBarItemIdentifier:eachIdentifier];
        NSLog(@"%@: index %@, plus button %@", eachIdentifier,
              @([tabBarController cyl_indexOfTabBarItemIdentifier:eachIdentifier]), @([eachControl cyl_isPlusButton]));
    }
    if ([identifier isEqualToString:@"plus"]) {
        // the plus button
    } else if ([identifier isEqualToString:@"message"]) {
        // the message tab, wherever it is
    }
}

[tabBarController cyl_selectTabBarItemWithIdentifier:@"message"];

// From any page: pop to the root and select the message tab, wherever it is. 从任意页面 Pop 到栈底并选中“消息”，无论它在第几个。
[self cyl_popSelectTabBarChildViewControllerForTabBarItemIdentifier:@"message" completion:^(__kindof UIViewController *selected) {
    [selected.navigationController pushViewController:detailViewController animated:YES];
}];

let messageAttributes: [String: Any] = [
    CYLTabBarItemTitle: "消息",
    CYLTabBarItemImage: "message_normal",
    CYLTabBarItemIdentifier: "message",
]

// CYLPlusButtonSubclass.swift
static func tabBarItemIdentifier() -> String { "plus" }

override func tabBarController(_ tabBarController: CYLTabBarController, didSelect control: UIControl) {
    switch control.cyl_tabBarItemIdentifier {
    case "plus": break     // the plus button
    case "message": break  // the message tab, wherever it is
    default: break
    }
}

tabBarController.cyl_selectTabBarItem(withIdentifier: "message")

[CN]点击 TabBarButton 时添加动画

[EN]Adding animations when a TabBar button is tapped

//CYLTabBarController.h

@protocol CYLTabBarControllerDelegate 

/*!
* @param tabBarController The tab bar controller containing viewController.
* @param control Selected UIControl in TabBar.
*/
- (void)tabBarController:(UITabBarController *)tabBarController didSelectControl:(UIControl *)control;

@end

@interface AppDelegate ()

@end

//AppDelegate.m
- (void)tabBarController:(UITabBarController *)tabBarController didSelectControl:(UIControl *)control {
   UIView *animationView;
   // If PlusButton has its own action, this delegate is not called for it.
   if ([control cyl_isPlusButton]) {
       // The plus button of this tab bar controller's context (`CYLExternPlusButton` is the one registered last).
       UIButton *button = [CYLPlusButton plusButtonForOwner:tabBarController];
       animationView = button.imageView;
   } else if ([control isKindOfClass:NSClassFromString(@"UITabBarButton")]) {
       for (UIView *subView in control.subviews) {
           if ([subView isKindOfClass:NSClassFromString(@"UITabBarSwappableImageView")]) {
               animationView = subView;
           }
       }
   }

   if ([self cyl_tabBarController].selectedIndex % 2 == 0) {
       [self addScaleAnimationOnView:animationView];
   } else {
       [self addRotateAnimationOnView:animationView];
   }
}

// 缩放动画 / Scale animation
- (void)addScaleAnimationOnView:(UIView *)animationView {
   // Customize the keyframe animation as needed.
   CAKeyframeAnimation *animation = [CAKeyframeAnimation animation];
   animation.keyPath = @"transform.scale";
   animation.values = @[@1.0,@1.3,@0.9,@1.15,@0.95,@1.02,@1.0];
   animation.duration = 1;
   animation.calculationMode = kCAAnimationCubic;
   [animationView.layer addAnimation:animation forKey:nil];
}

// 旋转动画 / Rotation animation
- (void)addRotateAnimationOnView:(UIView *)animationView {
   [UIView animateWithDuration:0.32 delay:0 options:UIViewAnimationOptionCurveEaseIn animations:^{
       animationView.layer.transform = CATransform3DMakeRotation(M_PI, 0, 1, 0);
   } completion:nil];

   dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.2 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
       [UIView animateWithDuration:0.70 delay:0 usingSpringWithDamping:1 initialSpringVelocity:0.2 options:UIViewAnimationOptionCurveEaseOut animations:^{
           animationView.layer.transform = CATransform3DMakeRotation(2 * M_PI, 0, 1, 0);
       } completion:nil];
   });
}

[CN]单独使用角标组件 CYLBadgeView

[EN]Using the badge component on its own: CYLBadgeView

# 只引入角标 / badges only
pod 'CYLTabBarController/CYLBadgeView'

#import    // Swift: import CYLTabBarController

[self.avatarView cyl_showBadge];                                                     // 红点 / red dot
[self.messageButton cyl_showBadgeValue:@"99+" animationType:CYLBadgeAnimationTypeShake];
[self.navigationItem.rightBarButtonItem cyl_showBadgeValue:@"new" animationType:CYLBadgeAnimationTypeNone];
[self.tabBarItem cyl_showBadgeValue:@"3" animationType:CYLBadgeAnimationTypeBounce];  // 系统 UITabBar 也可以 / a system UITabBar too
[self.messageButton cyl_clearBadge];

// 配合 CYLTabBarController 时，PlusButton 也可以显示角标，与 Tab 角标效果一致（Demo：每次点击数字加 1）。
// With CYLTabBarController, the plus button can show a badge too, like the tabs (demo: each tap adds 1).
[[CYLPlusButton plusButtonForOwner:tabBarController] cyl_showBadgeValue:@"1" animationType:CYLBadgeAnimationTypeBounce];

[CN]全局设置角标样式

[EN]Setting the badge style globally

CYLBadgeAppearance *appearance = [CYLBadgeAppearance globalAppearance];
appearance.backgroundColor = [UIColor systemPinkColor];   // default: red
appearance.textColor = [UIColor whiteColor];              // default: white
appearance.font = [UIFont boldSystemFontOfSize:10];       // default: [UIFont boldSystemFontOfSize:9]
appearance.centerOffset = CGPointMake(-5, 3);             // default: {0, 0}, from the top-right corner

CYLBadgeAppearance.global.backgroundColor = .systemPink
CYLBadgeAppearance.global.centerOffset = CGPoint(x: -5, y: 3)

[CN]更新 Tab 角标

[EN]Updating tab badges

// In a CYLTabBarController subclass: -viewDidLoad, or whenever the badge data changes.
- (void)reloadBadge {
    [self reloadBadgesWithBlock:^(CYLTabBarController *tabBarController) {
        [tabBarController.viewControllers[0] cyl_showBadge];
        [tabBarController.viewControllers[1] cyl_showBadgeValue:@"100" animationType:CYLBadgeAnimationTypeNone];
    }];
}

[CN]适配深色模式

[EN]Supporting Dark Mode

NSDictionary *homeAttributes = @{
    CYLTabBarItemTitle : @"首页",
    CYLTabBarItemImage : @"home_normal",              // 2. also loads home_normal_dark, if it exists
    CYLTabBarItemSelectedImage : @"home_highlight",   // 1. an asset catalog image with a Dark appearance
};
NSDictionary *messageAttributes = @{
    CYLTabBarItemTitle : @"消息",
    CYLTabBarItemImage : @"message_normal",
    CYLTabBarItemDarkImage : @"message_normal_night",  // 3. a dark image under any name
};
// 3. or one UIImage object holding a light and a dark image
UIImage *messageImage = [UIImage cyl_imageWithImageInfo:@"message_normal" darkImageInfo:@"message_normal_night"];
tabBarController.tabBar.backgroundColor = [UIColor cyl_colorWithLightColor:UIColor.whiteColor darkColor:UIColor.blackColor];

[CN]使用 CYLTabBarItemDarkImage 指定深色图片

[EN]Naming dark images with CYLTabBarItemDarkImage

NSDictionary *messageAttributes = @{
    CYLTabBarItemTitle : @"消息",
    CYLTabBarItemImage : @"message_normal",
    CYLTabBarItemDarkImage : @"message_normal_night",              // any name
    CYLTabBarItemSelectedImage : @"message_highlight",
    CYLTabBarItemSelectedDarkImage : [UIImage imageNamed:@"message_highlight_night"
                                                inBundle:themeBundle
                           compatibleWithTraitCollection:nil],     // or a UIImage, e.g. from another bundle
};

let messageAttributes: [String: Any] = [
    CYLTabBarItemTitle: "消息",
    CYLTabBarItemImage: "message_normal",
    CYLTabBarItemDarkImage: "message_normal_night",
    CYLTabBarItemSelectedImage: "message_highlight",
]

[CN]Lottie 图标的深色模式

[EN]Lottie icons in Dark Mode

NSDictionary *homeAttributes = @{
    CYLTabBarItemTitle : @"首页",
    CYLTabBarItemImage : @"home_normal",
    CYLTabBarItemSelectedImage : @"home_highlight",
    CYLTabBarLottieFilePath : [[NSBundle mainBundle] pathForResource:@"tab_home" ofType:@"json"],
    CYLTabBarLottieDarkFilePath : [[NSBundle mainBundle] pathForResource:@"tab_home_dark" ofType:@"json"],
};

let homeAttributes: [String: Any] = [
    CYLTabBarItemTitle: "首页",
    CYLTabBarItemImage: "home_normal",
    CYLTabBarItemSelectedImage: "home_highlight",
    CYLTabBarLottieURL: Bundle.main.url(forResource: "tab_home", withExtension: "json")!,
    CYLTabBarLottieDarkURL: Bundle.main.url(forResource: "tab_home_dark", withExtension: "json")!,
]

// green_lottie_tab_home.json + green_lottie_tab_home_dark.json, ...
NSArray *attributes = CYLTabBarItemsAttributesAddingLottieFiles(tabBarItemsAttributes,
    @[@"green_lottie_tab_home", @"green_lottie_tab_discover", @"green_lottie_tab_news", @"green_lottie_tab_mine"], nil);

let attributes = CYLTabBarItemsAttributesAddingLottieFiles(tabBarItemsAttributes,
    ["green_lottie_tab_home", "green_lottie_tab_discover", "green_lottie_tab_news", "green_lottie_tab_mine"], nil)

// Lottie 4.x: one file, dark colors by keypath. Lottie 4.x：一份文件，按 keypath 指定深色颜色。
NSDictionary *homeAttributes = @{
    CYLTabBarItemTitle : @"首页",
    CYLTabBarLottieFilePath : [[NSBundle mainBundle] pathForResource:@"green_lottie_tab_home" ofType:@"json"],
    CYLTabBarLottieDarkColors : @{
        @"Icon_Shop_Normal.**.Color" : [UIColor colorWithWhite:0.78 alpha:1],                          // gray outline → light gray
        @"Icon_Shop_Active_Main.**.Color" : [UIColor colorWithRed:0.15 green:0.39 blue:0.16 alpha:1], // pale fill → dark green
    },
};

CYLTabBarLottieDarkColors: [
    "Icon_Shop_Normal.**.Color": UIColor(white: 0.78, alpha: 1),
    "Icon_Shop_Active_Main.**.Color": UIColor(red: 0.15, green: 0.39, blue: 0.16, alpha: 1),
],

[CN]多语言（本地化）

[EN]Localization

// 1. 用一个 C 函数包住字面量，key 即原文（Wrap the literal; the key is the original text）
self.navigationItem.title = CYLLocalizedString(@"首页");
cell.textLabel.text = [NSString stringWithFormat:CYLLocalizedString(@"首页(%@)"), @(count)];

// 2. 可选：App 内切换语言（Optional: in-app language setting; nil follows the app again）
CYLSetLocalizationLanguage(@"ja");
NSString *language = CYLLocalizationLanguage(); // @"ja"

navigationItem.title = CYLLocalizedString("首页")
cell.textLabel?.text = String(format: CYLLocalizedString("我是第%ld行"), indexPath.row)

[CN]横竖屏适配

[EN]Supporting portrait and landscape orientations

- (void)updateTabBarCustomizationWhenTabBarItemWidthDidUpdate {
   void (^deviceOrientationDidChangeBlock)(NSNotification *) = ^(NSNotification *notification) {
       [self tabBarItemWidthDidUpdate];
};
   [[NSNotificationCenter defaultCenter] addObserverForName:CYLTabBarItemWidthDidChangeNotification
                                                     object:nil
                                                      queue:[NSOperationQueue mainQueue]
                                                 usingBlock:deviceOrientationDidChangeBlock];
}

- (void)tabBarItemWidthDidUpdate {
   UIDeviceOrientation orientation = [[UIDevice currentDevice] orientation];
   if ((orientation == UIDeviceOrientationLandscapeLeft) || (orientation == UIDeviceOrientationLandscapeRight)) {
       NSLog(@"Landscape Left or Right !");
   } else if (orientation == UIDeviceOrientationPortrait){
       NSLog(@"Landscape portrait!");
   }
   CGSize selectionIndicatorImageSize = CGSizeMake([self cyl_tabBar].cyl_tabBarItemWidth, [self cyl_tabBarController].tabBar.bounds.size.height);
   [[self cyl_tabBarController].tabBar setSelectionIndicatorImage:[[self class]
                                                                   imageFromColor:[UIColor yellowColor]
                                                                   forSize:selectionIndicatorImageSize
                                                                   withCornerRadius:0]];
}

[CN]访问初始化好的 CYLTabBarController 对象

[EN]Accessing the initialized CYLTabBarController instance

// CYLTabBarController.h

@interface NSObject (CYLTabBarController)

/**
* If `self` is kind of `UIViewController`, this method will return the nearest ancestor in the view controller hierarchy that is a tab bar controller. If `self` is not kind of `UIViewController`, it will return the `rootViewController` of the `rootWindow` as long as you have set the `CYLTabBarController` as the  `rootViewController`. Otherwise return nil. (read-only)
*/
@property (nonatomic, readonly) CYLTabBarController *cyl_tabBarController;

@end

//导入 CYLTabBarController.h
#import "CYLTabBarController.h"

- (void)viewDidLoad {
   [super viewDidLoad];
   CYLTabBarController *tabbarController = [self cyl_tabBarController];
   /*...*/
}

[CN]点击 PlusButton 跳转到指定 UIViewController

[EN]Navigating to a UIViewController by tapping the PlusButton

#pragma mark - CYLPlusButtonSubclassing

+ (UIViewController *)plusChildViewController {
   UIViewController *plusChildViewController = [[UIViewController alloc] init];
   plusChildViewController.view.backgroundColor = [UIColor redColor];
   plusChildViewController.navigationItem.title = @"PlusChildViewController";
   UIViewController *plusChildNavigationController = [[UINavigationController alloc]
                                                  initWithRootViewController:plusChildViewController];
   return plusChildNavigationController;
}

+ (NSUInteger)indexOfPlusButtonInTabBar {
   return 2;
}

+ (BOOL)shouldSelectPlusChildViewController {
   BOOL isSelected = [CYLPlusButton plusButtonForTabBarContext:[self matchedTabBarContext]].selected;
   return YES;
}

+ (CGFloat)multiplierOfTabBarHeight:(CGFloat)tabBarHeight {
   return  0.3;
}

+ (CGFloat)constantOfPlusButtonCenterYOffsetForTabBarHeight:(CGFloat)tabBarHeight {
   return (CYL_IS_IPHONE_X ? - 6 : 4);
}

//+ (NSString *)tabBarContext {
//    return NSStringFromClass([self class]);
//}

+ (BOOL)shouldSelectPlusChildViewController;

+ (BOOL)shouldSelectPlusChildViewController {
    BOOL isSelected = [CYLPlusButton plusButtonForTabBarContext:[self matchedTabBarContext]].selected;
    if (isSelected) {
        NSLog(@"🔴类名与方法名：%@（在第%@行），描述：%@", @(__PRETTY_FUNCTION__), @(__LINE__), @"PlusButton is selected");
    } else {
        NSLog(@"🔴类名与方法名：%@（在第%@行），描述：%@", @(__PRETTY_FUNCTION__), @(__LINE__), @"PlusButton is not selected");
    }
    return YES;
}

[CN]让 TabBarItem 仅显示图标并使图标垂直居中

[EN]Display only icons in TabBarItems and center them vertically

[CN]多 TabBar 嵌套并指定 PlusButton 位置

[EN]Nesting multiple TabBars and specifying the PlusButton position

//CYLPlusButtonSubclassing
+ (NSString *)tabBarContext;

[CN]在 Swift 项目中使用 CYLTabBarController

[EN]Using CYLTabBarController in a Swift project

platform :ios, '15.0'
# Uncomment the next line when you want all Pods as static framework
# use_modular_headers!
pod 'CYLTabBarController', '~> 1.100.0', :modular_headers => true

platform :ios, '15.0'
use_frameworks!

[CN]搭配 Storyboard 使用 CYLTabBarController

[EN]Using CYLTabBarController with Storyboard

[CN]源码实现原理

[EN]Implementation details

[CN]常见问题

[EN]FAQ

[CN]为什么放置 6 个 TabBarItem 会显示异常？

[EN]Why does placing six TabBarItems behave unexpectedly?

[CN]按钮响应区域发生偏移

[EN]The button hit area is offset

[CN]如何添加选中背景色？

[EN]How can I add a selected background color?

/**
*  更多TabBar自定义设置：比如：tabBarItem 的选中和不选中文字和背景图片属性、tabbar 背景图片属性
*/
- (void)customizeTabBarAppearance:(CYLTabBarController *)tabBarController;

[CN]ViewController 标题与 TabBar 标题不一致

[EN]The ViewController title does not match the TabBar title

   self.navigationItem.title = @"同城";    //✅sets navigation bar title.The right way to set the title of the navigation
   self.tabBarItem.title = @"同城";   //❌sets tab bar title. Even the `tabBarItem.title` changed, this will be ignored in  tabbar.
   self.title = @"同城1";                  //❌sets both of these. Do not do this‼️‼️ This may cause something strange like this : http://i68.tinypic.com/282l3x4.jpg

[CN]调用 cyl_popSelectTabBarChildViewControllerAtIndex: 时出现黑边

[EN]Black borders appear when calling cyl_popSelectTabBarChildViewControllerAtIndex:

//#import "CYLTabBarController.h"
   [[self cyl_tabBarController] rootWindow].backgroundColor = [UIColor whiteColor];

[CN]iPhone Duo 展开横屏时左右出现黑边

[EN]Black bars on the left and right of the unfolded iPhone Duo in landscape

// AppDelegate.m
- (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window {
   return self.supportsLandscapeOnFoldableDevice ? UIInterfaceOrientationMaskAllButUpsideDown : UIInterfaceOrientationMaskPortrait;
}

// Root view controller, -viewDidLoad
if (@available(iOS 27.1, *)) {
   __weak __typeof(self) weakSelf = self;
   UIHingeInteraction *hingeInteraction = [[UIHingeInteraction alloc] initWithUpdateHandler:^(UIHingeInteraction *interaction, UIHingeInteractionUpdate *update) {
       AppDelegate *appDelegate = (AppDelegate *)UIApplication.sharedApplication.delegate;
       if (!update.hinge || appDelegate.supportsLandscapeOnFoldableDevice) { return; }
       appDelegate.supportsLandscapeOnFoldableDevice = YES;
       [weakSelf setNeedsUpdateOfSupportedInterfaceOrientations];
   }];
   [self.view addInteraction:hingeInteraction];
}

[CN]凸起的图标超出 49pt 后无法响应

[EN]A raised icon does not respond above 49pt

[CN]为什么 iOS 10 会崩溃而 iOS 9 不会？

[EN]Why does it crash on iOS 10 but not iOS 9?

+ (void)load {
   [super registerPlusButton];
}

[CN]PlusButton 选中后无法恢复为 normal

[EN]PlusButton remains selected after selecting another tab

- (BOOL)tabBarController:(UITabBarController *)tabBarController shouldSelectViewController:(UIViewController *)viewController {
   [[self cyl_tabBarController] updateSelectionStatusIfNeededForTabBarController:tabBarController shouldSelectViewController:viewController];
   return YES;
}

[CN]PlusButton 与其他 TabBarItem 的间距不均匀

[EN]The PlusButton is not evenly spaced

[button sizeToFit];

button.frame = CGRectMake(0.0, 0.0, w, h);

[UIScreen mainScreen].bounds.size.width / [CYLTabBarController allItemsInTabBarCount]

[CN]如何兼容 Lottie 动画？

[EN]How do I integrate Lottie animations?

[CN]Star 历史

[EN]Star history

---