ObjectiveGit provides Cocoa bindings to the libgit2 library.

Not all libgit2 features are available yet. If you run across something missing, please consider contributing a pull request!

To start building the framework, you must install the required dependencies, xctool and cmake. We recommend using Homebrew to install these two tools.

Once you have the dependencies you should clone this repository and then run script/bootstrap. This will automatically pull down and install any other dependencies.

Note that the bootstrap script automatically installs some libraries that ObjectiveGit relies upon, using Homebrew. If you want this behavior, please make sure you have Homebrew installed.

It is simple enough to add the ObjectiveGit framework to a desktop application project. An example of this is the CommitViewer example on GitHub. In summary:

1. Drag the ObjectiveGitFramework.xcodeproj file into the project navigator.
2. Add the ObjectiveGit framework as a target dependency of your application.
3. Link your application with ObjectiveGit.framework.
4. Add a new "Copy Files" build phase, set the destination to "Frameworks" and add ObjectiveGit.framework to that. This will package the framework with your application as an embedded private framework.
5. Don't forget to #import <ObjectiveGit/ObjectiveGit.h> as you would with any other framework.

Getting started is slightly more difficult on iOS because third-party frameworks are not officially supported. ObjectiveGit offers a static library instead. An example of this is the ObjectiveGit iOS Example on GitHub. In summary:

1. Drag ObjectiveGitFramework.xcodeproj into the Project Navigator.
2. Add ObjectiveGit-iOS as a target dependency of your application.
3. Link your application to libObjectiveGit-iOS.a, libz.dylib, and libiconv.dylib.
4. In your target's build settings:
   1. Set "Always Search User Paths" to YES
   2. Add $(BUILT_PRODUCTS_DIR)/usr/local/include and PATH/TO/OBJECTIVE-GIT/External/libgit2/include to the "User Header Search Paths"
   3. Add -all_load to the "Other Linker Flags"

Fork the repository on GitHub, make it awesomer (preferably in a branch named for the topic), send a pull request.

All contributions should match GitHub's Objective-C coding conventions.

You can see all the amazing people that have contributed to this project here.

ObjectiveGit is released under the MIT license. See LICENSE.md.