Inject
Hot reloading workflow helper that enables you to save hours of time each week, regardless if you are using UIKit, AppKit or SwiftUI.
TLDR: A single line of code change allows you to live code UIKit screen:
HotReloadingDemo.mp4
Read detailed article about this
The heavy lifting is done by the amazing InjectionForXcode. This library is just a thin wrapper to provide the best developer experience possible while requiring minimum effort.
I've been using it for years.
What is hot reloading?
Hot reloading is a technique allowing you to get rid of compiling your whole application and avoiding deploy/restart cycles as much as possible, all while allowing you to edit your running application code and see changes reflected as close as possible to real-time.
This makes you significantly more productive by reducing the time you spend waiting for apps to rebuild, restart, re-navigate to the previous location where you were in the app itself, re-produce the data you need.
This can save you literal hours off development time, each day!
Does it add manual overhead to my workflows?
Once you configured your project initially, it's practically free.
You don’t need to add conditional compilation or remove Inject code from your applications for production, it's already designed to behave as no-op inlined code that will get stripped by LLVM in non-debug builds.
Which means that you can enable it once per view and keep using it for years to come.
Integration
Initial project setup
To integrate Inject just add it as SPM dependency:
via Xcode
Open your project, click on File → Swift Packages → Add Package Dependency…, enter the repository url (https://github.com/krzysztofzablocki/Inject.git) and add the package product to your app target.
via SPM package.swift
dependencies: [
.package(
name: "Inject",
url: "https://github.com/krzysztofzablocki/Inject.git",
from: "1.0.5"
)
]
Individual Developer setup (once per machine)
If anyone in your project wants to use injection, they only need to:
- You must add "-Xlinker -interposable" (without the double quotes) to the "Other Linker Flags" of all targets in your project for the Debug configuration (qualified by the simulator SDK to avoid complications with bitcode), refer to InjectionForXcode documentation if you run into any issues
- Download newest version of Xcode Injection from it's GitHub Page
- Unpack it and place under
/Applications - Make sure that the Xcode version you are using to compile our projects is under the default location:
/Applications/Xcode.app - Run the injection application
- Select open project / open recent from it's menu and pick the right workspace file you are using
After choosing the project in Injection app, launch the app
- If everything is configured correctly you should see similar log in the console:
💉 InjectionIII connected /Users/merowing/work/SourceryPro/App.xcworkspace
💉 Watching files under /Users/merowing/work/SourceryPro
Workflow integration
You can either add import Inject in individual files in your project or use @_exported import Inject in your project target to have it automatically available in all its files.
SwiftUI
Just 2 steps to enable injection in your SwiftUI Views
- call
.enableInjection()at the end of your body definition - add
@ObserveInjection var injectto your view struct
Remember you don't need to remove this code when you are done, it's NO-OP in production builds.
If you want to see your changes in action, you can enable an optional Animation variable on Inject.animation that will be used when ever new source code is injected into your application.
Inject.animation = .interactiveSpring()
Using Inject is demoed in this example app
UIKit / AppKit
For standard imperative UI frameworks we need a way to clean-up state between code injection phases.
I create the concept of Hosts that work really well in that context, there are 2:
Inject.ViewControllerHostInject.ViewHost
How do we integrate this? We wrap the class we want to iterate on at the parent level, so we don’t modify the class we want to be injecting but we modify the parent callsite.
Eg. If you have a SplitViewController that creates PaneA and PaneB , and you want to iterate on layout/logic code in PaneA, you modify the callsite in SplitViewController:
paneA = Inject.ViewHost(
PaneAView(whatever: arguments, you: want)
)
That is all the changes you need to do, your app now allows you to change anything in PaneAView except for its initialiser API and the changes will be almost immediately reflected in your App.
Make sure to call initializer inside Inject.ViewControllerHost(...) or Inject.ViewHost(...). Inject relies on @autoclosure to reload views when hot-reload happens. Example:
// WRONG
let viewController = YourViewController()
rootViewController.pushViewController(Inject.ViewControllerHost(viewController), animated: true)
// CORRECT
let viewController = Inject.ViewControllerHost(YourViewController())
rootViewController.pushViewController(viewController, animated: true)
Remember you don't need to remove this code when you are done, it's NO-OP in production builds.
The Composable Architecture
If like myself you love PointFree Composable Architecture, you’d probably want to inject reducer code, this isn’t possible in vanilla TCA because reducer code is a free function which isn’t as straightforward to replace with injection, but our fork at The Browser Company supports it.
I have the same issue both for UIKit and swift ui views.
Any idea please?
316 Nov 17, 2022
0 Nov 19, 2021
0 Jan 24, 2022
1 Feb 5, 2022
144 Jun 29, 2022
608 Sep 15, 2022
1.7k Dec 30, 2022
4.6k Dec 26, 2022
1.3k Jan 5, 2023
7.3k Jan 4, 2023
110 Oct 18, 2022
288 Oct 9, 2022
349 Dec 20, 2022
90 Sep 1, 2022
83 Jan 29, 2022
7.6k Jan 6, 2023
19.1k Jan 2, 2023
119 Jan 29, 2022