由 Owain R Hunt

UAGithubEngine 是围绕 Github API 的一个包装器。查看 API 文档 以获取 API 可以做什么的详细信息。

UAGithubEngine 与 Mac OS X 10.7 及以上版本和 iOS 5.0 兼容。

注意

master 分支基于 API 第 3 版构建，并使用最先进的技术，如 blocks 和 ARC。UAGE 的第 1 版（在 v1 分支中找到）是基于 API 第 2 版构建的，如果您需要支持更早的 OS X 或 iOS 版本，则可能更适合您的使用。此分支不再处于积极开发状态。

如何使用它？

• UAGithubEngine 可在 CocoaPods 获取。只需在 Podfile 中添加以下内容

  依赖项 'UAGithubEngine'

  然后运行 pod install。

• 使用引擎最容易的方式是与框架一起使用 - 构建与链接 UAGithubEngine 框架，并在需要使用框架的地方使用 #import <UAGithubEngine/UAGithubEngine.h>。

• 如果您不想使用 CocoaPods 或框架，或者将 'UAGithubEngine' 组中所有的文件从 UAGithubEngine 项目的文件复制到您的应用程序项目中，或者将整个项目添加到您的工作区。在使用引擎的地方使用 #import "UAGithubEngine.h"。

• 使用用户名和密码实例化一个引擎。如果您想在可到达性状态改变时收到通知（UAGithubReachabilityStatusDidChangeNotification），则将 YES 作为最后一个参数传递。

• 调用一些方法。

代码比言语更有说服力。

UAGithubEngine *engine = [[UAGithubEngine alloc] initWithUsername:@"aUser" password:@"aPassword" withReachability:YES];

[engine repositoriesWithSuccess:^(id response) { 
        NSLog(@"Got an array of repos: %@", obj); 
    } failure:^(NSError *error) { 
        NSLog(@"Oops: %@", error);
    }];  

[engine user:@"this_guy" isCollaboratorForRepository:@"UAGithubEngine" success:^(BOOL collaborates) { 
        NSLog(@"%d", collaborates); 
    } failure:^(NSError *error){ 
        NSLog(@"D'oh: %@", error); 
    }];

如果您有任何问题、评论、改进等等，可以提出一个问题，在我的 Twitter 上找到我（@orhunt）或给我发送电子邮件（[email protected]）。