NEW: My new book Pro SwiftUI is out now – level up your SwiftUI skills today! >>

How to store NSCoding data using Codable

Swift version: 5.6

Paul Hudson    @twostraws   

Broadly speaking, NSCoding is the Objective-C way of archiving data and Codable is the Swift way. However, that doesn’t mean the two can’t work together – with a little work you can save any NSCoding data right inside Codable, which is helpful because many Apple types such as UIColor and UIImage conform to NSCoding but not Codable.

Here’s a simple struct as an example:

struct Person {
    var name: String
    var favoriteColor: UIColor

That stores one Codable type (the string) and one NSCoding type (the color), and we’re going to make them all work through Codable using JSONEncoder.

This takes four steps:

  1. Creating an extension on Person where we’ll put our Codable functionality.
  2. Creating custom coding keys to describe what data is saved.
  3. Creating an init(from:) method that converts raw data back into a UIColor.
  4. Creating an encode(to:) method that converts a UIColor into raw data, which Codable can then base-64 encode.

Start by adding the extension to Person:

extension Person: Codable {


That will stop your code from compiling because Swift knows UIColor isn’t compatible with Codable. So, let’s move on to step two: adding custom coding keys. Put this inside the extension:

enum CodingKeys: String, CodingKey {
    case name
    case favoriteColor

Those are just the same coding keys we’d get by default, but because we’re going to be encoding and decoding things by hand we need to declare them explicitly.

Step three is to create an init(from:) method that can read raw data and convert it to a UIColor. This will used NSKeyedUnarchiver just like regular NSCoding code. Add this to the extension:

init(from decoder: Decoder) throws {
    let container = try decoder.container(keyedBy: CodingKeys.self)

    name = try container.decode(String.self, forKey: .name)

    let colorData = try container.decode(Data.self, forKey: .favoriteColor)
    favoriteColor = try NSKeyedUnarchiver.unarchiveTopLevelObjectWithData(colorData) as? UIColor ??

The last step is to create an encode(to:) method that does the opposite – it takes a UIColor and converts it to data using NSKeyedArchiver. Put this inside the extension:

func encode(to encoder: Encoder) throws {
    var container = encoder.container(keyedBy: CodingKeys.self)
    try container.encode(name, forKey: .name)

    let colorData = try NSKeyedArchiver.archivedData(withRootObject: favoriteColor, requiringSecureCoding: false)
    try container.encode(colorData, forKey: .favoriteColor)

That’s all the work done – by converting our UIColor into a Data, Codable can take care of the rest.

If you want to try it out, here’s some sample code:

let taylor = Person(name: "Taylor Swift", favoriteColor: .blue)
let encoder = JSONEncoder()

do {
    let encoded = try encoder.encode(taylor)
    let str = String(decoding: encoded, as: UTF8.self)
} catch {
Hacking with Swift is sponsored by Judo

SPONSORED Let’s face it, SwiftUI previews are limited, slow, and painful. Judo takes a different approach to building visually—think Interface Builder for SwiftUI. Build your interface in a completely visual canvas, then drag and drop into your Xcode project and wire up button clicks to custom code. Download the Mac App and start your free trial today!

Try now

Sponsor Hacking with Swift and reach the world's largest Swift community!

Available from iOS 8.0 – learn more in my book Swift Design Patterns

Similar solutions…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

Buy Pro Swift Buy Pro SwiftUI Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Beyond Code

Was this page useful? Let us know!

Average rating: 4.4/5

Unknown user

You are not logged in

Log in or create account

Link copied to your pasteboard.