Swift & the Objective-C Runtime
Written byNate Cook—January 26th,2015
Even when written without a single line of Objective-C code,every Swift app executes inside the Objective-C runtime,opening up a world of dynamic dispatch and associated runtime manipulation. To be sure,this may not always be the case—Swift-only frameworks,whenever they come,may lead to a Swift-only runtime. But as long as the Objective-C runtime is with us,let’s use it to its fullest potential.
This week we take a new,Swift-focused look at two runtime techniques covered on NSHipster back when Objective-C was the only game in town:associated objectsandmethod swizzling.
Note:This post primarily covers the use of these techniques in Swift—for the full run-down,please refer to the original articles.
Associated Objects
Swift extensions allow for great flexibility in adding to the functionality of existing Cocoa classes,but they’re limited in the same way as their Objective-C brethren,categories. Namely,you can’t add a property to an existing class via an extension.
Happily,Objective-Cassociated objectscome to the rescue. For example,to add adescriptiveName@H_404_35@property to all the view controllers in a project,we simply add a computed property using
objc_get/setAssociatedObject()@H_404_35@in the backing
get@H_404_35@and
set@H_404_35@blocks:
extension UIViewController { private struct AssociatedKeys { static var DescriptiveName = "nsh_DescriptiveName" } descriptiveName: String? { get { return objc_getAssociatedObject(self, &AssociatedKeys.DescriptiveName) as? String } set { if let newValue = newValue { objc_setAssociatedObject( &DescriptiveName, newValue as NSString?, .OBJC_ASSOCIATION_RETAIN_NONATOMIC ) } } } }
Note the use of
static var@H_404_35@in a private nested
struct@H_404_35@—this pattern creates the static associated object key we need but doesn’t muck up the global namespace.
Method Swizzling
Sometimes for convenience,sometimes to work around a bug in a framework,or sometimes because there’s just no other way,you need to modify the behavior of an existing class’s methods. Method swizzling lets you swap the implementations of two methods,essentially overriding an existing method with your own while keeping the original around.
In this example,we swizzleUIViewController@H_404_35@’s
viewWillAppear@H_404_35@method to print a message any time a view is about to appear on screen. The swizzling happens in the special class method
initialize@H_404_35@(see note below); the replacement implementation is in the
nsh_viewWillAppear@H_404_35@method:
load vs. initialize (Swift Edition)
The Objective-C runtime typically calls two class methods automatically when loading and initializing classes in your app’s process:load@H_404_35@and
initialize@H_404_35@. In the full article onmethod swizzling,Mattt writes that swizzling shouldalwaysbe done in
load()@H_404_35@,for safety and consistency.
load@H_404_35@is called only once per class and is called on each class that is loaded. On the other hand,a single
initialize@H_404_35@method can be called on a class and all its subclasses,which are likely to exist for
UIViewController@H_404_35@,or not called at all if that particular class isn’t ever messaged.
Unfortunately,aload@H_404_35@class method implemented in Swift isnevercalled by the runtime,rendering that recommendation an impossibility. Instead,we’re left to pick among second-choice options:
-
Implement method swizzling in
initialize@H_404_35@
This can be done safely,so long as you check the type at execution time and wrap the swizzling indispatch_once@H_404_35@(which you should be doing anyway).
-
Implement method swizzling in the app delegate
Instead of adding method swizzling via a class extension,simply add a method to the app delegate to be executed whenapplication(_:didFinishLaunchingWithOptions:)@H_404_35@is called. Depending on the classes you’re modifying,this may be sufficient and should guarantee your code is executed every time.
In closing,remember that tinkering with the Objective-C runtime should be much more of a last resort than a place to start. Modifying the frameworks that your code is based upon,as well as any third-party code you run,is a quick way to destabilize the whole stack. Tread softly!