注入

热重载工作流助手,无论您使用的是 UIKit、AppKit 还是 SwiftUI,都能让您每周节省数小时的时间。

如果您想支持我的工作并改善您的工程工作流程,请查看我的 SwiftyStack 课程

简而言之:只需一行代码就可以实现 UIKit 界面的实时编码:

https://user-images.githubusercontent.com/26660989/161756368-b150bc25-b66f-4822-86ee-2e4aed713932.mp4

阅读关于此的详细文章

重要的工作由出色的 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 框架,我们需要一种方法在代码注入阶段之间清理状态。

我创建了在这种情况下效果很好的主机概念,有两种:

• ViewControllerHost
• ViewHost

我们如何集成这个?我们在父级包装我们想要迭代的类,所以我们不修改我们想要注入的类,而是修改父级调用站点。

例如,如果您有一个创建 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 的分支支持它。