LoLAPI 是由 Riot Games 开发的一款在线游戏 "英雄联盟" (League of Legends) 的功能最强大的 Objective-C RESTful 客户端。官方英雄联盟 API 提供的所有可用的网络服务都由完全的对象映射，允许开发者专注于编写 LoL 应用程序，而无需烦恼（或知识）网络设置和 Web 服务消费。

入门

• 下载 LoLAPI

要在项目中开始使用 LoLAPI，只需按照以下示例设置您的英雄联盟 API 密钥和所需的区域

#import <LoLAPI/LoLAPI.h>
...

// Initialize the LoLAPI
[LoLAPIManager initWithAPIKey:@"<your_key>" region:LoLRegionIDNorthAmerica];

示例

获取所有英雄

[LoLAPIManager getChampionsWithFreeToPlayStatusOnly:NO success:^(LoLChampionList *championList) {
    for (LoLChampion *champion in championList.champions) {
        NSLog(@"champion id is: %ld", (long)[champion.id integerValue]);
    }
} failure:^(NSError *error) {
    UIAlertView *errorAlert = [[UIAlertView alloc] initWithTitle:@"Error" message:@"Failed to retreive champions. Please try again later." delegate:self cancelButtonTitle:@"Okay" otherButtonTitles:nil];

    [errorAlert show];
}];

要求

LoLAPI 需要 iOS 5.0 或更高版本或 Mac OS X 10.7 或更高版本。

LoLAPI 依赖于以下第三方开源库

1. RestKit - 网络支持，对象映射（与 Core Data 集成）

必须在应用程序目标中链接以下 Cocoa 框架才能正确编译

1. CFNetwork.framework 在 iOS 上
2. CoreData.framework
3. Security.framework
4. MobileCoreServices.framework 在 iOS 上或在 OS X 上 CoreServices.framework

此外，还必须设置以下链接器标志

1. -ObjC
2. -all_load

ARC

LoLAPI 代码库完全使用 ARC 编写。

如果您正在将 LoLAPI 源代码直接包含在不使用 ARC 的项目中，您需要将所有 LoLAPI 源文件的编译器标志设置为 -fobjc-arc。要在 Xcode 中这样做，请转到您的活动目标并选择“构建设置”选项卡。现在选择所有 LoLAPI 源文件，按 Enter 键，插入 -fobjc-arc 并然后“完成”以启用 LoLAPI 的 ARC。

安装

推荐通过CocoaPods软件包管理器来安装LoLAPI，因为它提供了灵活的依赖管理，安装过程简单直接。为了获得最佳效果，建议使用CocoaPods >= 0.19.1，并通过Homebrew安装Git >= 1.8.0。

从发布包或作为Git子模块

如果您有使用这种方法的安装指南，请与我分享，这样我可以开始建立一个供他人查看的维基。

许可证

LoLAPI遵循Apache License，版本2.0的条款。有关完整详情，请参阅LICENSE文件。

致谢

LoLAPI是由Troy Stump提供的。特别感谢Blake Watters和RestKit团队提供的出色框架（以及README文件格式的整理）。