热重载工作流程助手,让您每周节省数小时时间,无论是使用 UIKit
、AppKit
还是 SwiftUI
。
如果您想支持我的工作和改进您的工程流程,请查看我的SwiftyStack课程
TLDR:一行代码的更改即可允许您实时编码 UIKit
屏幕
HotReloadingDemo.mp4
这项艰巨的工作由惊人的 InjectionIII 完成。这个库只是一个薄薄的包装,旨在提供最佳的开发者体验,同时尽量减少工作量。
我已经使用它好几年了。
热重载是一种技术,允许您尽可能减少编译整个应用程序,并最大程度地避免部署/重启周期,同时允许您编辑正在运行的应用程序代码,并尽量实时地反映更改。
这通过减少您等待应用程序重建、重启、重新导航到应用中的上一个位置、重新产生所需数据的时间,使您显著提高生产效率。
这可以每天都在实际意义上为您节省开发时间!
一旦您一开始配置了项目,实际上就是免费的。
您不需要为生产在您的应用程序中添加条件编译或删除 Inject
代码,它已经设计为在非调试构建中由LLVM剥离的内联代码(no-op)行为。
这意味着您可以为每个视图启用它一次,并在未来几年继续使用。
要将 Inject 集成,只需将其作为 SPM 依赖项添加
打开您的项目,点击“文件”→“Swift 包”→“添加包依赖项...”,输入仓库网址(https://github.com/krzysztofzablocki/Inject.git
)并将包产品添加到您的应用程序目标中。
dependencies: [
.package(
url: "https://github.com/krzysztofzablocki/Inject.git",
from: "1.2.4"
)
]
pod 'InjectHotReload'
如果项目中的任何人想使用注入,他们只需要
- 您必须将“-Xlinker -interposable”(不带引号,并且单独一行)添加到项目的所有目标的“其他链接器标志”中,针对调试配置(由模拟器SDK根据位码避免复杂情况),如果遇到任何问题,请参阅InjectionForXcode文档
- 从其GitHub页面下载Xcode Injection的最新版本
- 解压并将其放置在
/Applications
- 确保您用于编译项目的Xcode版本在默认位置:
/Applications/Xcode.app
- 运行注入应用程序
- 从其菜单中选择“打开项目/打开最近”并选择您正在使用的正确工作区文件
在注射应用中选择项目后,启动应用
- 如果一切配置正确,你应该在控制台中看到类似的日志
💉 InjectionIII connected /Users/merowing/work/SourceryPro/App.xcworkspace
💉 Watching files under /Users/merowing/work/SourceryPro
您可以在项目中的单独文件中添加 import Inject
,或者在项目目标中使用 @_exported import Inject
以使其自动在任何文件中可用。
仅两步即可在您的 SwiftUI
观察器中启用注入
- 在身体定义的末尾调用
.enableInjection()
- 在您的视图结构中添加
@ObserveInjection var inject
请记住,当您完成工作时,您不需要删除此代码,在生产构建中它是无操作的。
如果您想看到您的更改生效,可以在 InjectConfiguration.animation
上启用可选的 Animation
变量,当新的源代码注入您的应用程序时将使用它。
InjectConfiguration.animation = .interactiveSpring()
使用 Inject
的示例在此示例应用中演示。
对于标准强制UI框架,我们需要一种在代码注入阶段之间清理状态的方法。
我创建了一个称为 Hosts 的概念,它在那个环境中效果很好,共有两个
ViewControllerHost
ViewHost
如何进行集成?我们在父级别包装我们想要迭代的类,这样我们就不修改我们想要注入的类,而是修改父调用点。
例如,如果您有一个创建 PaneA
和 PaneB
的 SplitViewController
,并且您想在 PaneA
中的布局/逻辑代码中进行迭代,您将修改 SplitViewController
中的调用点。
paneA = Inject.ViewHost(
PaneAView(whatever: arguments, you: want)
)
这就是您需要进行的所有更改,您的应用程序现在允许您更改 PaneAView
中的任何内容,除了其初始化器API,更改将几乎立即反映在您的应用程序中。
请确保在 Inject.ViewControllerHost(...)
或 Inject.ViewHost(...)
中调用初始化器。注入依赖于 @autoclosure
在热重载时重新加载视图。示例
// WRONG
let viewController = YourViewController()
rootViewController.pushViewController(Inject.ViewControllerHost(viewController), animated: true)
// CORRECT
let viewController = Inject.ViewControllerHost(YourViewController())
rootViewController.pushViewController(viewController, animated: true)
请记住,当您完成工作时,您不需要删除此代码,在生产构建中它是无操作的。
根据您在UIKit应用程序中使用的架构,您可能想在每个视图控制器重新加载时附加一个要执行的钩子。
例如,您可能希望每次重新加载时都将 UIViewController
绑定到主持人,为此您可以使用 onInjectionHook
示例
myView.onInjectionHook = { hostedViewController in
//any thing here will be executed each time the controller is reloaded
// for example, you might want to re-assign the controller to your presenter
presenter.ui = hostedViewController
}
为了iOS 12工作,您需要将 -weak_framework SwiftUI 添加到其他链接器标志。
如果您像我一样喜欢 PointFree 组合式架构,您可能想在组合式架构中注入reducer代码,这不可能在vanilla TCA中实现,因为reducer代码是一个自由函数,它不容易用注入替换,但 我们在 The Browser Company 的分支 支持。