IQKeyboardManager 5.0 迁移指南：从4.0到5.0的重要变更解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01050/article/details/148375644

IQKeyboardManager 5.0 迁移指南：从4.0到5.0的重要变更解析

IQKeyboardManager hackiftekhar/IQKeyboardManager: 是一个用于解决 iOS 键盘遮挡问题的库。适合对 iOS 开发和使用 Swift 语言有兴趣的人，特别是想解决键盘遮挡输入框问题的人。特点是提供了一个简单的解决方案，可以自动调整输入框在键盘弹出时的位置，同时支持自定义规则和动画效果，具有很高的易用性和扩展性。项目地址: https://gitcode.com/gh_mirrors/iq/IQKeyboardManager

前言

IQKeyboardManager作为iOS开发中处理键盘交互的利器，在5.0版本中进行了多项架构优化和API改进。本文将详细解析从4.0升级到5.0版本的关键变更点，帮助开发者顺利完成迁移工作。

一、移除的API特性

1. UIView类别中被移除的特性

public var isAskingCanBecomeFirstResponder: Bool

这个属性在5.0版本中已不再需要，框架内部已经优化了相关逻辑。

2. IQKeyboardManager中被移除的特性

public var shouldFixTextViewClip = true
public var canAdjustTextView = false  
public var shouldAdoptDefaultKeyboardAnimation = true

这些属性在5.0版本中被移除，因为它们涉及的功能现在都由框架内部自动处理，开发者无需再手动配置。

二、API重构：从方法到属性的转变

5.0版本对许多功能进行了重新设计，将原先的方法调用改为更直观的属性设置方式。

旧版方法（4.0）

// 距离处理相关
public func disableDistanceHandlingInViewControllerClass(disabledClass: AnyClass)
public func removeDisableDistanceHandlingInViewControllerClass(disabledClass: AnyClass)

// 工具栏相关
public func disableToolbarInViewControllerClass(toolbarDisabledClass: AnyClass)
public func removeDisableToolbarInViewControllerClass(toolbarDisabledClass: AnyClass)

// 工具栏前后按钮相关
public func considerToolbarPreviousNextInViewClass(toolbarPreviousNextConsideredClass: AnyClass)
public func removeConsiderToolbarPreviousNextInViewClass(toolbarPreviousNextConsideredClass: AnyClass)

新版属性（5.0）

// 距离处理控制
open var disabledDistanceHandlingClasses = [UIViewController.Type]()
open var enabledDistanceHandlingClasses = [UIViewController.Type]()

// 工具栏控制
open var disabledToolbarClasses = [UIViewController.Type]()
open var enabledToolbarClasses = [UIViewController.Type]()

// 工具栏前后按钮控制
open var toolbarPreviousNextAllowedClasses = [UIView.Type]()

这种改变使得代码更加简洁直观，开发者可以直接通过数组来管理需要启用或禁用特定功能的视图控制器类。

三、UIView类别的API变化

旧版API（4.0）

public var shouldHideTitle: Bool?
public var drawingPlaceholderText: String?
public func setCustomPreviousTarget(target: AnyObject?, selector: Selector?)
public func setCustomNextTarget(target: AnyObject?, selector: Selector?)

新版API（5.0）

public var shouldHidePlaceholderText: Bool
public var keyboardToolbar: IQToolbar
public var shouldHideToolbarPlaceholder: Bool
public var drawingToolbarPlaceholder: String?
open func setTarget(_ target: AnyObject?, action: Selector?) // 在IQBarButtonItem中

主要变化包括：

属性命名更加清晰明确
提供了直接访问键盘工具栏的能力
自定义目标设置方式更加统一

四、5.0版本新增的重要特性

1. 新增的全局配置属性

// 工具栏外观
open var toolbarBarTintColor: UIColor?

// 键盘状态
open var keyboardShowing: Bool
open var movedDistance: CGFloat

// 调试与手势处理
open var enableDebugging = false
open var shouldFixInteractivePopGestureRecognizer = true

// 前后按钮显示模式
open var previousNextDisplayMode = IQPreviousNextDisplayMode.Default

2. 新增的管理方法

// 重新加载输入视图
open func reloadInputViews()

// 重新布局
open func reloadLayoutIfNeeded()

// 通知注册相关
open func registerAllNotifications()
open func registerTextFieldViewClass(_ aClass: UIView.Type, 
                                   didBeginEditingNotificationName: String, 
                                   didEndEditingNotificationName: String)
open func unregisterTextFieldViewClass(_ aClass: UIView.Type, 
                                     didBeginEditingNotificationName: String, 
                                     didEndEditingNotificationName: String)

3. UIScrollView类别新增属性

public var shouldIgnoreScrollingAdjustment: Bool

这个属性允许开发者针对特定滚动视图禁用自动调整功能。

五、迁移建议

逐步替换：建议先替换已废弃的API，再考虑使用新特性
测试验证：特别注意自定义目标设置和工具栏行为的变化
利用调试工具：新版本提供了enableDebugging属性帮助排查问题
交互手势处理：检查shouldFixInteractivePopGestureRecognizer是否适合你的应用场景

结语

IQKeyboardManager 5.0通过简化API设计、增强内部自动处理能力，为开发者提供了更加稳定和易用的键盘管理方案。理解这些变更将帮助你更高效地升级应用，并充分利用新版本提供的改进功能。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考