Created for a presentation at CocoaHeads Dresden on 09 July 2014. The Deckset presentation (rendered as PDF and the Markdown source) is included in the repository. Feel free to open a GitHub Issue for questions regarding this project.
Last verified with Xcode 14.3 and iOS 16.2. The app is written in Swift 5.7.
Please consult the official documentation for a comparison of the two approaches and official demo material.
Tags outline the various steps to enable state restoration in iOS apps:
NO_STATE_RESTORATION: The app without state restorationSTATE_RESTORATION_OPT_IN: The app generally enables state restoration, but does not implement it yetRESTORATION_IDENTIFIERS: The app sets restoration identifiers on view controllers, but the controllers are not restored successfully yetBASIC_STATE_RESTORATION: Initially created view controllers are restored successfullyRESTORATION_CLASS: Non-initial view controllers are restored, tooSTATE_ENCODING: View controllers restore their views' stateSIZE_CLASSES: The window's size classes are preserved
Note: Both to improve the project and to support the current version of
Swift, there have been major updates that are not reflected by the tagged
commits. The tags are still helpful to follow the various steps, but you
should use the latest commit on main for a working version.
By default, state restoration happens synchronously at launch on the main queue. While you can move work off the main queue, it will still kick in right after app launch and should finish as quickly as possible, which means it cannot easily be adopted by apps that need to log in or fetch a new session on every launch.
Apple Sample Code: State Restoration of Child View Controllers
