Natalie命令行完全指南一条命令批量生成整个项目的类型安全Storyboard代码【免费下载链接】NatalieNatalie - Storyboard Code Generator (for Swift)项目地址: https://gitcode.com/gh_mirrors/na/NatalieNatalie 是一款用 Swift 编写的Storyboard 代码生成器它只需一条命令就能把整个项目里的所有 Storyboard 批量转换成类型安全的 Swift 代码从此告别手写字符串标识符。这篇文章面向 Swift 新手和普通 iOS 开发者带你 10 分钟上手 Natalie让 Segue、Storyboard 跳转和 Cell 复用全部变得安全又省心。为什么要用 Natalie先看看字符串地狱有多痛 在传统 iOS 开发中用 Storyboard 做页面跳转是这样的let vc UIStoryboard(name: Main, bundle: nil) .instantiateViewController(withIdentifier: ScreenOneViewController) performSegue(withIdentifier: ScreenOneSegue, sender: nil)这三个字符串Main、ScreenOneViewController、ScreenOneSegue全靠手写。一旦在 Storyboard 里改了 ID 或名字编译器不会报任何错误只有 App 运行到那一刻才会崩溃。这就是典型的字符串地狱。Natalie 的解法非常优雅它解析 Storyboard 的 XML 文件自动生成一个Storyboards.swift文件把上面所有字符串都变成带类型的枚举和静态方法。写错了编译器直接报错想错都难。✅一条命令生成类型安全Storyboard代码安装与首次运行第一步安装 Natalie 的两种最快方法方法一Homebrew 一键安装推荐给 macOS 用户$ brew install natalie方法二源码编译Swift Package Manager$ git clone https://gitcode.com/gh_mirrors/na/Natalie.git $ cd Natalie $ ./scripts/build.sh编译完成后可执行文件会出现在Natalie/natalie。为了方便全局使用可以把它复制到系统目录$ cp natalie /usr/local/bin顺便一提你也可以把natalie可执行文件放进项目根目录并纳入版本控制这样团队成员和 CI 都能用同一个版本生成代码。安装脚本本身很简单就藏在 scripts/build.sh 里。第二步一条命令批量生成整个项目的 Storyboard 代码 ✨Natalie 的命令行用法极其简单只接受两种参数参数类型说明示例单个.storyboard文件只处理这一个文件natalie Main.storyboard一个文件夹路径递归找出里面所有 Storyboard 并批量生成natalie NatalieExample/实际使用效果是这样$ natalie NatalieExample/NatalieExample/Base.lproj/Main.storyboard \ NatalieExample/NatalieExample/Storyboards.swift如果你传的是文件夹路径Natalie 会遍历整个目录包括子目录把找到的每一个 Storyboard 都处理掉最后一次性输出到标准输出。这正是一条命令批量生成整个项目 Storyboard 代码的魔力所在。命令行入口逻辑在 main.swift 中核心生成器在 Natalie.swift。生成的 Storyboards.swift 里到底有什么运行命令后你会得到一个包含所有类型安全代码的Storyboards.swift。示例项目里就有一份真实生成结果可以参考 NatalieExample/NatalieExample/Storyboards.swift。下面按功能拆解。1. Storyboards 枚举类型安全的页面跳转每个 Storyboard 会变成一个嵌套结构体并自动生成强类型的实例化方法struct Storyboards { struct Main: Storyboard { static let identifier Main static func instantiateInitialViewController() - UINavigationController { return self.storyboard.instantiateInitialViewController() as! UINavigationController } static func instantiateScreenOneViewController() - ScreenOneViewController { return self.storyboard.instantiateViewController( withIdentifier: Screen One ViewController) as! ScreenOneViewController } } }于是你的跳转代码从抄字符串变成调用方法let vc Storyboards.Main.instantiateScreenOneViewController()方法名和 Storyboard 里的 ID 一一对应返回类型也是确定的写错一个字母立刻编译报错。2. Segue 枚举performSegue 不再靠手写字符串每个自定义 ViewController 都会被自动扩展一个Segue枚举列出它所有可用的 Segueextension MainViewController { enum Segue: String, SegueProtocol { case screenOneSegue ScreenOneSegue case screenTwoSegue ScreenTwoSegue } }执行跳转时可以这样写示例见 MainViewController.swiftIBAction func screen1ButtonPressed(_ button: UIButton) { self.perform(segue: MainViewController.Segue.screenOneSegue) }在prepare(for:sender:)里做判断也同样安全直接用比较枚举override func prepare(for segue: UIStoryboardSegue, sender: Any?) { if segue MainViewController.Segue.screenOneSegue { // 类型安全的分发逻辑 } }3. Reusable 枚举Cell 复用标识符也安全了如果你的 Storyboard 里给 Cell 设置了reuseIdentifierNatalie 会为对应控制器生成Reusable枚举并给UITableView/UICollectionView扩展出安全的注册与复用方法override func viewDidLoad() { tableView.registerReusableCell(MainViewController.Reusable.myCell) } func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) - UITableViewCell { let cell tableView.dequeueReusableCell(MainViewController.Reusable.myCell, for: indexPath) ?? UITableViewCell() return cell }这套 Reusable 协议体系定义在生成文件的ReusableViewProtocol部分源码模板见 Natalie.swift。4. 附加福利颜色名也变成静态属性 如果 Storyboard 里使用了 Asset Catalog 的颜色iOS 11 / macOS 10.13Natalie 还会自动生成颜色扩展extension UIColor { static let Screen1 UIColor(named: Screen1) static let Screen2 UIColor(named: Screen2) }Xcode 集成每次 Build 自动重新生成 手动跑命令毕竟麻烦Natalie 官方推荐用Run Script Phase把它挂进 Xcode 构建流程实现每次编译自动更新 Storyboards.swift打开 Xcode选中项目 Target进入Build Phases点击左上角选择New Run Script Phase把脚本粘贴进去记得放在Compile Sources 之前保证生成文件先于编译就绪把Storyboards.swift加入工程脚本核心逻辑是只有当某个.storyboard文件比Storyboards.swift更新时才重新生成避免每次构建都做无用功NATALIE_PATH/usr/local/bin/natalie BASE_PATH$PROJECT_DIR/$PROJECT_NAME OUTPUT_PATH$BASE_PATH/Storyboards.swift if [ ! -e $OUTPUT_PATH ] || [ -n $(find $BASE_PATH -type f -name *.storyboard -newer $OUTPUT_PATH -print -quit) ]; then $NATALIE_PATH $BASE_PATH $OUTPUT_PATH fi配置完成后以后拖个新 Segue、改个 Storyboard ID编译一次就自动同步团队协作时大家拿到的永远是最新代码。一套工具iOS / macOS / tvOS 通吃Natalie 的贴心之处在于平台适配它会自动识别 Storyboard 的目标平台生成对应的代码——iOS/tvOS 用UIStoryboardUIKitmacOS 用NSStoryboardCocoa。不同平台混在一个目录里也没问题生成器会自动用#if os(...)包裹对应代码段。这套平台差异逻辑集中在 OS.swift 中非常值得想写跨平台生成器的同学参考。源码结构快速导览 ️文件作用Sources/natalie/main.swift命令行入口解析参数、递归找 StoryboardSources/natalie/Natalie.swift核心生成器拼接全部输出代码Sources/natalie/OS.swiftiOS / macOS / tvOS 平台差异Sources/natalie/Storyboard.swiftStoryboard 模型与各元素处理Sources/natalie/StoryboardFile.swift读取并解析单个 Storyboard 文件Sources/natalie/SWXMLHash/XML 解析依赖SWXMLHashNatalieExample/NatalieExample/Storyboards.swift真实的生成代码示例总结现在就让 Storyboard 代码变得类型安全吧 ✅回顾一下Natalie 给 Swift 开发者带来的核心价值就三条一条命令批量生成传文件夹路径全项目 Storyboard 一次搞定彻底消灭字符串Storyboard ID、Segue 名称、Cell 复用标识全部枚举化编译期兜底零成本接入Homebrew 一键安装加上 Run Script Phase 就能自动更新如果你正被 Storyboard 字符串标识符的崩溃问题困扰不妨 clone 下 Natalie 亲自体验一把$ git clone https://gitcode.com/gh_mirrors/na/Natalie.git从今天起把跳转、Segue 和 Cell 复用的正确性交给编译器来守护把精力留给真正的业务逻辑。【免费下载链接】NatalieNatalie - Storyboard Code Generator (for Swift)项目地址: https://gitcode.com/gh_mirrors/na/Natalie创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考