访问官网
Github
文档
论文注入
热重载工作流助手,无论您使用的是 UIKit、AppKit 还是 SwiftUI,都能让您每周节省数小时的时间。
如果您想支持我的工作并改善您的工程工作流程,请查看我的 SwiftyStack 课程
简而言之:只需一行代码就可以实现 UIKit 界面的实时编码:
重要的工作由出色的 InjectionIII 完成。这个库只是一个薄包装,旨在以最少的努力提供最佳的开发者体验。
我已经使用它多年了。
什么是热重载?
热重载是一种技术,可以让您摆脱编译整个应用程序并尽可能避免部署/重启周期,同时允许您编辑正在运行的应用程序代码,并尽可能接近实时地看到变化反映。
这可以显著提高您的工作效率,减少您等待应用程序重建、重启、重新导航到应用程序中之前的位置以及重新生成所需数据的时间。
这每天可以为您节省数小时的开发时间!
它会给我的工作流程增加手动开销吗?
一旦您最初配置了项目,它实际上是免费的。
您不需要为生产环境添加条件编译或从应用程序中删除 Inject 代码,它已经被设计成在非调试构建中会被 LLVM 剥离的无操作内联代码。
这意味着您可以为每个视图启用一次,并在未来几年内继续使用它。
集成
初始项目设置
要集成 Inject,只需将其作为 SPM 依赖项添加:
通过 Xcode
打开您的项目,点击 File → Swift Packages → Add Package Dependency…,输入仓库 url (https://github.com/krzysztofzablocki/Inject.git),并将包产品添加到您的应用目标。
通过 SPM package.swift
dependencies: [
.package(
url: "https://github.com/krzysztofzablocki/Inject.git",
from: "1.2.4"
)
]
通过 Cocoapods Podfile
pod 'InjectHotReload'
单个开发者设置(每台机器一次)
如果项目中的任何人想使用注入,他们只需要:
- 您必须在项目所有目标的 Debug 配置的"Other Linker Flags"中添加"-Xlinker -interposable"(不带双引号,单独一行)(通过模拟器 SDK 限定以避免与位码相关的复杂问题),如果遇到任何问题,请参考 InjectionForXcode 文档
- 从其 GitHub 页面下载最新版本的 Xcode Injection
- 解压并放置在
/Applications下
- 解压并放置在
- 确保您用于编译项目的 Xcode 版本在默认位置:
/Applications/Xcode.app - 运行注入应用程序
- 从其菜单中选择打开项目/打开最近,并选择您使用的正确工作区文件
在 Injection 应用中选择项目后,启动应用
- 如果一切配置正确,您应该在控制台中看到类似的日志:
💉 InjectionIII connected /Users/merowing/work/SourceryPro/App.xcworkspace
💉 Watching files under /Users/merowing/work/SourceryPro
工作流集成
您可以在项目的单个文件中添加 import Inject,或者在项目目标中使用
@_exported import Inject 使其自动在所有文件中可用。
SwiftUI
只需 2 步即可在 SwiftUI 视图中启用注入
- 在 body 定义的末尾调用
.enableInjection() - 在视图结构中添加
@ObserveInjection var inject
请记住,完成后不需要删除此代码,它在生产构建中是无操作的。
如果您想看到更改的效果,可以在 InjectConfiguration.animation 上启用可选的 Animation 变量,每当新的源代码注入到应用程序中时都会使用它。
InjectConfiguration.animation = .interactiveSpring()
Inject 的使用在这个示例应用中进行了演示
UIKit / AppKit
对于标准的命令式 UI 框架,我们需要一种方法在代码注入阶段之间清理状态。
我创建了在这种情况下效果很好的主机概念,有两种:
ViewControllerHostViewHost
我们如何集成这个?我们在父级包装我们想要迭代的类,所以我们不修改我们想要注入的类,而是修改父级调用站点。
例如,如果您有一个创建 PaneA 和 PaneB 的 SplitViewController,并且您想在 PaneA 中迭代布局/逻辑代码,您可以修改 SplitViewController 中的调用站点:
paneA = Inject.ViewHost(
PaneAView(whatever: arguments, you: want)
)
这就是您需要做的所有更改,您的应用现在允许您更改 PaneAView 中除其初始化器 API 之外的任何内容,更改几乎会立即反映在您的应用中。
确保在 Inject.ViewControllerHost(...) 或 Inject.ViewHost(...) 内调用初始化器。Inject 依赖 @autoclosure 在热重载发生时重新加载视图。示例:
// 错误
let viewController = YourViewController()
rootViewController.pushViewController(Inject.ViewControllerHost(viewController), animated: true)
// 正确
let viewController = Inject.ViewControllerHost(YourViewController())
rootViewController.pushViewController(viewController, animated: true)
请记住,完成后不需要删除此代码,它在生产构建中是无操作的。
UIKit 的注入钩子
根据您的 UIKit 应用中使用的架构,您可能希望在每次重新加载视图控制器时附加一个要执行的钩子。
例如,您可能希望在每次重新加载时将 UIViewController 绑定到 presenter,为此您可以使用 onInjectionHook
示例:
myView.onInjectionHook = { hostedViewController in
//这里的任何内容都将在每次重新加载控制器时执行
//例如,您可能想重新将控制器分配给您的 presenter
presenter.ui = hostedViewController
}
iOS 12
对于 iOS 12,您需要在 Other Linker Flags 中添加 -weak_framework SwiftUI。
可组合架构
如果像我一样喜欢 PointFree 的可组合架构,您可能想要注入 reducer 代码,这在普通的 TCA 中是不可能的,因为 reducer 代码是一个自由函数,不太容易用注入替换,但我们在 The Browser Company 的分支支持它。
