是的,Swift、Objective-C 和 C++ 的热重载!

这个项目是 InjectionIII 应用程序,用于实时代码更新,现在作为 Swift 包提供。即:

注意:你应该只将 HotReloading 产品添加到你的目标中。

然后,你就可以注入函数实现而无需重新构建你的应用程序...

要试用一个已经设置好的示例项目,请克隆这个 SwiftUI-Kit 的分支。

要在你的项目中使用,将此仓库添加为 Swift 包,并添加"其他链接器标志": -Xlinker -interposable。你不再需要添加"运行脚本"构建阶段。如果想在设备上注入,请参阅下面关于如何配置 InjectionIII 应用程序的说明。但是,在 M1/M2 Mac 上,此项目仅适用于 iOS/tvOS 14 或更高版本的模拟器。此外,由于 Xcode 如何启用 Swift 包的 DEBUG 构建的一个怪癖,你的"配置"需要包含字符串"Debug"。

记住不要在配置了此包的情况下发布你的应用程序。

你应该看到一条消息,表明应用程序正在监视你的主目录中的源文件更改。你可以通过在环境变量 INJECTION_DIRECTORIES 中添加逗号分隔的列表来更改此范围。如果你想在使用模拟器时连接到 InjectionIII.app,请在你的方案中添加环境变量 INJECTION_DAEMON。

有关更多信息,请查阅 InjectionIII 项目的 README,特别是如何使用它通过 HotSwiftUI 协议扩展来注入 SwiftUI。

使用 VSCode 进行热重载

可以在 VSCode 编辑器内使用热重载,实现一种"VScode 预览"形式。请查阅此项目了解所需的设置。

设备注入

HotReloading 项目及其依赖项的这个版本现在支持在真实的 iOS 或 tvOS 设备上进行注入。

设备注入现在连接到 InjectionIII.app(github 发布版 4.6.0 或更高版本),并要求你在终端中输入以下命令,然后重启应用程序以选择接收来自设备的远程连接:

$ rm ~/Library/Containers/com.johnholdsworth.InjectionIII/Data/Library/Preferences/com.johnholdsworth.InjectionIII.plist
$ defaults write com.johnholdsworth.InjectionIII deviceUnlock any

注意,如果你过去使用过 App Store 版本的 InjectionIII,二进制发布版有不同的首选项文件,两者可能会混淆并阻止这个首选项生效。这就是为什么上面的第一个 rm 命令可能是必要的。如果你的设备无法连接,请检查应用程序是否正在监听 8899 端口:

% netstat -an | grep LIST | grep 88
tcp4       0      0  127.0.0.1.8898         *.*                    LISTEN
tcp4       0      0  *.8899                 *.*                    LISTEN

如果你的设备仍然无法连接,可以在你的方案中添加一个包含运行 InjectionIII.app 的主机的 WiFi IP 地址的 INJECTION_HOST 环境变量,或者克隆这个项目并将你的 Mac 的 IP 地址编码到 Package.swift 中的 hostname 变量中。然后,将克隆拖到你的项目上,让它取代配置的 Swift 包,如这些说明中所述。

注意:由于 HotReloading 包需要连接到你的 Mac 的网络套接字以接收命令和新版本的代码,所以在添加包后首次运行你的应用程序时,预计会收到一条消息,询问你是否"信任"你的应用程序应该被允许这样做。同样,在 Mac 端(因为 InjectionIII 应用程序需要打开一个网络端口来接受此连接),如果你打开了 macOS 防火墙,可能会提示你授予权限。

对于 SwiftUI,你可以通过遵循 HotSwiftUI 项目中概述的约定来强制屏幕更新,然后你就可以体验类似于"Xcode 预览"的功能,但是是在实际设备上的全功能应用程序!

Vapor 注入

要在 Vapor web 服务器中使用注入,现在可以只下载 InjectionIII.app 并在服务器配置时添加以下行(当从 Xcode 内部运行 Vapor 时):

    #if DEBUG && os(macOS)
    Bundle(path: "/Applications/InjectionIII.app/Contents/Resources/macOSInjection.bundle")?.load()
    #endif

还需要向你的目标添加以下参数:

    linkerSettings: [.unsafeFlags(["-Xlinker", "-interposable"],
            .when(platforms: [.macOS], configuration: .debug))]

作为替代方案,你可以将此 Swift 包作为依赖项添加到 Vapor 的 Package.swift 的"App"目标中。

感谢...

应用程序跟踪功能使用 OliverLetterer/imp_implementationForwardingToSelector 跳转实现,通过 SwiftTrace 项目,采用 MIT 许可证。

SwiftTrace 使用非常方便的 https://github.com/facebook/fishhook 作为 dyld_dynamic_interpose 动态加载器私有 api 的替代方案。有关许可详情,请参阅框架中包含的项目源代码和头文件。

此项目中允许你从设备捕获视频的 "Remote" 服务器包含从 acj/TimeLapseBuilder-Swift 改编的代码

此版本包含一个稍作修改的优秀 canviz 库,用于在 HTML 画布中渲染"dot"文件,该库采用 MIT 许可证。更改是将节点的 ID 传递到节点标签标记(第 212 行),反转节点和连接它们的线的渲染(第 406 行),以及存储边缘路径以便可以着色(第 66 和 303 行)在"canviz-0.1/canviz.js"中。

它还包括 CodeMirror JavaScript 编辑器,用于在 Xprobe 浏览器中评估代码,采用 MIT 许可证。

$日期: 2023/09/18 $