InjectHotReload 1.5.0

InjectHotReload 1.5.0

Krzysztof Zabłocki维护。



  • 作者
  • Krzysztof Zablocki

Inject

热重载工作流程助手,让您每周节省数小时时间,无论是使用 UIKitAppKit 还是 SwiftUI

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

TLDR:一行代码的更改即可允许您实时编码 UIKit 屏幕

HotReloadingDemo.mp4

阅读有关此内容的详细文章

这项艰巨的工作由惊人的 InjectionIII 完成。这个库只是一个薄薄的包装,旨在提供最佳的开发者体验,同时尽量减少工作量。

我已经使用它好几年了。

什么是热重载?

热重载是一种技术,允许您尽可能减少编译整个应用程序,并最大程度地避免部署/重启周期,同时允许您编辑正在运行的应用程序代码,并尽量实时地反映更改。

这通过减少您等待应用程序重建、重启、重新导航到应用中的上一个位置、重新产生所需数据的时间,使您显著提高生产效率。

这可以每天都在实际意义上为您节省开发时间!

它会给我的工作流程增加人工负载吗?

一旦您一开始配置了项目,实际上就是免费的。

您不需要为生产在您的应用程序中添加条件编译或删除 Inject 代码,它已经设计为在非调试构建中由LLVM剥离的内联代码(no-op)行为。

这意味着您可以为每个视图启用它一次,并在未来几年继续使用。

集成

初始项目设置

要将 Inject 集成,只需将其作为 SPM 依赖项添加

通过 Xcode

打开您的项目,点击“文件”→“Swift 包”→“添加包依赖项...”,输入仓库网址(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'

单个开发者设置(每台机器一次)

如果项目中的任何人想使用注入,他们只需要

  • 您必须将“-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

仅两步即可在您的 SwiftUI 观察器中启用注入

  • 在身体定义的末尾调用 .enableInjection()
  • 在您的视图结构中添加 @ObserveInjection var inject

请记住,当您完成工作时,您不需要删除此代码,在生产构建中它是无操作的。

如果您想看到您的更改生效,可以在 InjectConfiguration.animation 上启用可选的 Animation 变量,当新的源代码注入您的应用程序时将使用它。

InjectConfiguration.animation = .interactiveSpring()

使用 Inject 的示例在此示例应用中演示。

UIKit / AppKit

对于标准强制UI框架,我们需要一种在代码注入阶段之间清理状态的方法。

我创建了一个称为 Hosts 的概念,它在那个环境中效果很好,共有两个

  • ViewControllerHost
  • ViewHost

如何进行集成?我们在父级别包装我们想要迭代的类,这样我们就不修改我们想要注入的类,而是修改父调用点。

例如,如果您有一个创建 PaneAPaneBSplitViewController,并且您想在 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 注入钩子

根据您在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

为了iOS 12工作,您需要将 -weak_framework SwiftUI 添加到其他链接器标志。

组合式架构

如果您像我一样喜欢 PointFree 组合式架构,您可能想在组合式架构中注入reducer代码,这不可能在vanilla TCA中实现,因为reducer代码是一个自由函数,它不容易用注入替换,但 我们在 The Browser Company 的分支 支持。