apparentsoft / bsmanageddocument

Brings UIManagedDocument's design to OS X

BSManagedDocument

A document class that mimics UIManagedDocument to support Core Data in all its modern glory, and more:

• Saves to a file package

• Asynchronous saving is supported. We set up a parent/child pair of contexts; the parent saves on its own thread

• Full support for concurrent document opening

• Subclasses can hook in to manage additional content inside the package

• A hook is also provided at the best time to set metadata for the store

• New docs have the bundle bit set on them. It means that if the doc gets transferred to a Mac without your app installed, with the bundle bit still intact, it will still appear in the Finder as a file package rather than a folder

• If the document moves on disk, Core Data is kept informed of the new location

• If multiple validation errors occur during saving, the presented error is adjusted to make debugging a little easier

• Subclasses may specify a custom undo manager class instead of NSUndoManager, or nil undo manager.

• Full support for Autosave-In-Place, Versions, and Sharing (Share menu requires macOS 10.13 or later)

macOS System Requirements

The main branch requires macOS 10.12 or later. If you require support for earlier versions, use the branch named MacOS10.11AndEarlier.

License (BSD)

Standard BSD licence.

Please see the header file for the full text.

Documentation

Documentation is automatically generated from BSManagedDocument.h and published at http://cocoadocs.org/docsets/BSManagedDocument/

Usage

Add BSManagedDocument .m and .h to your Xcode project and carry on your merry way. Or if it's more your style of thing, we're on CocoaPods too.