A recording store for ReSwift. Enables hot-reloading and time travel for ReSwift apps.
ReSwiftRecorder is an extension for ReSwift that allows developers to record and replay actions. ReSwiftRecorder supports serializing these actions to disk, which allows to replay recorded sessions and to restart apps at the point you left them off.
This is especially useful during development. If you run into a crash, while recording, you now have a recorded JSON file with all the actions needed to reproduce crash. If you restart your app with this recorded session, it will crash in exactly the same way every single time - this allows you to fix the underlying issue without manually navigating through the app over and over again.
The long term goal of this extension is to implement some of the most important features from Redux Devtools.
This extension is working - you can record and replay actions, but it still in a proof-of-concept state.
- Make it easier for developers to make actions serializable, ideally cutting down on some of the boilerplate code that is currently necessary.
- Improve the implementation of this extension, the current implementation is a hack.
You can install ReSwiftRecorder via CocoaPods by adding it to your
use_frameworks! source 'https://github.com/CocoaPods/Specs.git' platform :ios, '8.0' pod 'ReSwift' pod 'ReSwiftRecorder'
You can install ReSwiftRecorder via Carthage by adding the following line to your Cartfile:
When creating your app's store you need to create an instance of
RecordingStore instead of an instance of
MainStore. You also need to provide a
typeMaps argument that is used to deserialize actions:
RecordingMainStore(reducer: CombinedReducer([CounterReducer(), NavigationReducer()]), appState: AppState(), typeMaps:[counterActionTypeMap, ReSwiftRouter.typeMap], recording: "recording.json")
typeMaps array is an array that maps type names (Strings) to action types.
The last argument
recording, can either be
nil or the path to a recording stored in the documents directory of the app. If you set the path to a specific recording, the store will load all actions upon launch and replay them, thereby restoring the state of the application.
For a practical example of how to use ReSwiftRecorder, check out the Counter App Example.