KYDrawerController安装配置教程CocoaPods、手动导入与Storyboard 3种方式全解【免费下载链接】KYDrawerControllerSide Drawer Navigation Controller similar to Android项目地址: https://gitcode.com/gh_mirrors/ky/KYDrawerControllerKYDrawerController是一款模拟 Android 体验的 iOS 侧边抽屉导航控制器Side Drawer Navigation Controller支持 Storyboard 与 AutoLayout。本篇安装配置教程将带你用最短时间掌握 3 种接入方式CocoaPods 一键安装、手动导入源码、Storyboard 可视化配置并附上核心 API 速查帮助新手快速上手。一、认识 KYDrawerController为什么选它KYDrawerController 是一个纯 Swift 编写的抽屉式导航容器控制器让 iPhone App 拥有和 Android 一样的侧滑抽屉菜单体验侧边抽屉从屏幕左/右边缘滑出带阴影与背景遮罩效果手势支持屏幕边缘 Pan 手势打开、抽屉内拖拽关闭、点击遮罩收起轻量零依赖核心代码仅 3 个 Swift 文件基于 AutoLayout 实现双工作流既可以用代码配置也支持 Storyboard 可视化搭建开源免费采用 MIT 协议当前 CocoaPods 版本为 2.1.0核心源码非常精简全部位于KYDrawerController/Classes/目录KYDrawerController/Classes/KYDrawerController.swift主控制器包含抽屉状态、方向、宽度、手势等全部逻辑KYDrawerController/Classes/KYEmbedDrawerControllerSegue.swiftStoryboard 中嵌入抽屉页的转场KYDrawerController/Classes/KYEmbedMainControllerSegue.swiftStoryboard 中嵌入主页的转场项目还内置了两个完整示例工程强烈建议边看边做Example/Code/纯代码方式Swift示例Example/Storyboard/Storyboard 方式含 Objective-C 混编示例二、方式一CocoaPods 一键安装推荐新手⚡CocoaPods 是最省心的安装方式一条依赖声明即可完成接入。1. 在 Podfile 中声明依赖打开你项目根目录的Podfile文件在target块中加入pod KYDrawerController2. 执行安装并打开工作空间在终端中进入项目目录执行pod install之后请务必用.xcworkspace文件而不是.xcodeproj打开项目否则依赖不会被链接。 提示podspec 中声明的部署目标为 iOS 8.0Swift 版本 4.2主流 Xcode 环境均可直接使用。安装完成后在任意 Swift 文件顶部即可引入import KYDrawerController三、方式二手动导入源码离线/无网方案如果你不想使用 CocoaPods或者项目要求离线依赖手动导入也非常简单——因为整个库只有 3 个 Swift 文件。最快手动导入步骤第 1 步获取项目源码。在终端中克隆仓库到本地git clone https://gitcode.com/gh_mirrors/ky/KYDrawerController第 2 步把 Classes 文件夹拖入 Xcode 工程。将KYDrawerController/KYDrawerController/Classes/目录整体拖到你的 Xcode 项目中在弹出的对话框勾选Copy items if needed和Create groups。第 3 步确认 Target 成员。在文件检查器File Inspector中确认这 3 个 Swift 文件都被勾选进了你的 App Target编译通过即可使用。这种方式的好处是完全掌控源码随时可以阅读KYDrawerController.swift修改抽屉宽度、动画时长等默认行为。四、方式三Storyboard 可视化配置4 步完成KYDrawerController 原生支持 Storyboard无需一行代码即可完成抽屉框架。官方示例工程Example/Storyboard/中有一份完整可运行的工程含 Objective-C 混编版本可供参考。Storyboard 配置四步法第 1 步设置根控制器自定义类。在 Storyboard 中选中 Initial View Controller在类检查器Identity Inspector中将 Custom Class 设置为KYDrawerController。第 2 步添加抽屉页并连线。拖入你的抽屉菜单 ViewController如Menu从KYDrawerController按住 Control 键拖出连线选择Embed in类型目标选KYEmbedDrawerControllerSegue。第 3 步添加主页并连线。同样地为你的主页 ViewController 从KYDrawerController拉出Embed in连线目标选KYEmbedMainControllerSegue。第 4 步填写 Segue 标识符。回到KYDrawerController的检查器面板在Main Segue Identifier和Drawer Segue Identifier两个字段中分别填入第 3、2 步连线对应的 Storyboard ID。控制器在viewDidLoad时会自动执行这两条转场完成主页与抽屉页的嵌入。这样一个完整的侧边抽屉导航就搭建好了接下来只需通过 API 控制开合。五、核心 API 速查打开、关闭与自定义 ️无论哪种安装方式使用 API 都是统一的。1. 初始化与挂载代码方式参考示例工程Example/Code/Code/AppDelegate.swift中的写法let drawerController KYDrawerController(drawerDirection: .left, drawerWidth: 300) drawerController.mainViewController UINavigationController(rootViewController: mainViewController) drawerController.drawerViewController drawerViewController window?.rootViewController drawerController2. 打开 / 关闭抽屉drawerController.setDrawerState(.opened, animated: true) // 打开 drawerController.setDrawerState(.closed, animated: true) // 关闭3. 常用自定义属性一览属性默认值说明drawerDirection.left抽屉方向支持.left/.rightdrawerWidth280抽屉宽度ptdrawerAnimationDuration0.25开关动画时长秒containerViewMaxAlpha0.2打开时背景遮罩最大透明度screenEdgePanGestureEnabledtrue是否允许从屏幕边缘滑开抽屉以上属性大多标注了IBInspectable在 Storyboard 检查器中也能直接调整。4. 监听抽屉状态变化实现KYDrawerControllerDelegate协议即可感知状态切换协议定义见KYDrawerController/Classes/KYDrawerController.swift顶部func drawerController(_ drawerController: KYDrawerController, willChangeState state: KYDrawerController.DrawerState) func drawerController(_ drawerController: KYDrawerController, didChangeState state: KYDrawerController.DrawerState)典型用法在willChangeState中收起键盘、暂停视频在didChangeState中刷新状态栏样式。六、常见问题与最佳实践 ✅Q1为什么从屏幕左边缘滑动打不开抽屉检查screenEdgePanGestureEnabled是否为true并确认drawerDirection与边缘方向一致.left对应左侧边缘。Q2抽屉里放 TableView 时手势冲突怎么办KYDrawerController实现了UIGestureRecognizerDelegate抽屉打开时主页的 Pan 手势会自动禁用通常无需额外处理若仍有冲突可在抽屉子视图上适当设置cancelsTouchesInView相关手势属性。Q3如何在 Objective-C 项目中使用先按方式一或方式二完成安装之后通过import生成的桥接头文件即可调用Example/Storyboard/Storyboard/MainViewControllerObjc.m提供了完整的 ObjC 调用示例KYDrawerController *drawer (KYDrawerController *)self.navigationController.parentViewController; [drawer setDrawerState:DrawerStateOpened animated:YES];最佳实践清单主页建议包一层UINavigationController抽屉菜单建议用UITableViewController生产项目优先使用 CocoaPods 安装锁定版本便于团队协作动手前先把Example/Code和Example/Storyboard两个示例跑通能避开 90% 的坑抽屉宽度建议设为屏幕宽度的 80%~85%iPhone 上 280~320pt 视觉效果最佳至此你已经掌握了KYDrawerController 安装配置教程的全部内容CocoaPods 一键接入、手动导入 3 个文件的离线方案、Storyboard 4 步可视化搭建以及开合控制、方向宽度自定义和代理监听等核心用法。动手把示例工程跑起来吧一个 Android 风格的侧边抽屉导航就在几行代码之外【免费下载链接】KYDrawerControllerSide Drawer Navigation Controller similar to Android项目地址: https://gitcode.com/gh_mirrors/ky/KYDrawerController创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考