Objective Git - libgit2 wrapper for Objective-C
Objective Git provides Objective-C bindings to the libgit2 linkable C Git library. It has been implemented as a framework right now. This is a good reference for setting up frameworks in xcode This library follows the rugged API as close as possible while trying to maintain a native objective-c feel.
Unit testing in being done using GHUnit. We are using both the mac and iOS unit testing frameworks. The one minor inconvenience to be aware of is that xcode doesn't like switching between the mac test target and the iOS test target. You generally have to close and reopen the project to move from iOS testing back to mac testing.
$ git submodule init $ git submodule update
Inclusion in Mac OS X projects
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:
- Drag the ObjectiveGit.xcodeproj file into the project navigator
- Add the ObjectiveGit framework as a target dependency of your application
- Link your application with the ObjectiveGit framework.
- Add a new Copy Files build phase, set the destination to Frameworks and and the ObjectiveGit framework to that - this will package the framework with your application as an embedded private framework.
- Don't forget to
#import <ObjectiveGit/ObjectiveGit.h>as you would with any other framework.
Inclusion in iOS projects
Inclusion of Objective Git in iOS projects is somewhat cumbersome on account of iOS not allowing third-party dynamic frameworks. A work-around for this is as follows:
- Drag the ObjectiveGitFramework.xcodeproj file into the Project Navigator.
- Add ObjectiveGit-iOS as a target dependency of your application.
- Link your application to
- Build Settings - Always Search User Paths - set to YES
- Build Settings - User Header Search Paths 5.1. Add $(BUILT_PRODUCTS_DIR)/usr/local/include 5.2. Add $(SRCROOT)../Libs/objective-git/libgit2/include
Fork libgit2/objective-git 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 contributing to this project here.
MIT. See LICENSE file.