OctoKit is still new and moving fast, so we may make breaking changes from time-to-time, but it has partial unit test coverage and is already being used in GitHub for Mac's production code.
To add OctoKit to your application:
- Add the OctoKit repository as a submodule of your application's repository.
script/bootstrapfrom within the OctoKit folder.
- Drag and drop
Mantle.xcodeprojinto the top-level of your application's project file or workspace. The latter three projects can be found within the
- On the "Build Phases" tab of your application target, add OctoKit,
ReactiveCocoa, and Mantle to the "Link Binary With Libraries" phase.
- On iOS, add the
- On OS X, add the
.frameworkbundles. All of the frames must also be added to any "Copy Frameworks" build phase.
- On iOS, add the
$(BUILD_ROOT)/../IntermediateBuildFilesPath/UninstalledProducts/include $(inherited)to the "Header Search Paths" build setting (this is only necessary for archive builds, but it has no negative effect otherwise).
- For iOS targets, add
-ObjCto the "Other Linker Flags" build setting.
Copying the Frameworks
This is only needed on OS X.
- Go to the "Build Phases" tab of your application target.
- If you don't already have one, add a "Copy Files" build phase and target the "Frameworks" destination.
OctoKit.frameworkfrom the OctoKit project’s
ProductsXcode group into the "Copy Files" build phase you just created (or the one that you already had).
- A reference to the framework will now appear at the top of your application’s Xcode group, select it and show the "File Inspector".
- Change the "Location" to "Relative to Build Products".
- Now do the same (starting at step 2) for the frameworks within the External folder.
OctoKit is released under the MIT license. See LICENSE.md.