关于iOS GangSDK的使用 为App快速集成社群公会模块

手上有一个自己开发的小游戏，想加一个家族系统活跃下游戏的氛围，想到这块儿可能会有大量的工作需要自己做，就偷了个懒去网上搜罗了一波，结果惊奇的发现居然真的有类似的服务，并且还是免费的，所以决定入坑尝试一下。这里就我使用的第三方家族系统（GangSDK）做一个简单的记录，方便以后查看。

一、GangSDK介绍

GangSDK是为开发者提供的一套快速接入社群系统的开发框架，主要为了帮助开发者在自己的应用里快速构建社群系统。社群系统包含两大功能:1、为用户们提供自己的社交圈，使他们交流更方便;2、社群建设，使社群更具影响力，同时吸引更多的用户加入。

GangSDK包括三个部分：

GangCore：数据管理(所有网络请求接口管理)

GangUI：界面展示(提供的UI布局)

GangUIResource：皮肤资源(为UI提供了多套资源,可选择替换使界面显示多样化)

二、集成前准备

1、注册及创建应用，网址：http://www.gangsdk.com/statichtml/html/gangsdkmanage/myapp.html

2、下载GangSDK.zip，网址：http://www.gangsdk.com/statichtml/resource/sdk/ios/GangSDK.zip

三、开始集成

1、导入GangSDK

2>通过在工程目录上的右键[Add Files to…]来添加上面拷贝进去的文件夹，如图：

2、添加依赖库

3、添加 -ObjC 链接符号
点击项目文件->选择项目target->选中Build Setting ->在搜索框中输入other link ,找到Other Linker Flags ->添加-ObjC，如下图：

4、添加权限

1>选中info.plist->右键选择Open as -> Source Code，如下图：

2>将下面的配置信息粘贴进去，如下图：

<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
<key>NSPhotoLibraryUsageDescription</key>
<string>能够查看相册图片</string>
<key>NSCameraUsageDescription</key>
<string>拍摄照片</string>
<key>NSMicrophoneUsageDescription</key>
<string>发送语音消息</string>

5、初始化GangSDK

1>导入头文件：
#import <GangSDK/GangSDK.h>

2>调用方法：
//初始化，一般在应用一打开就进行
[[GangSDK instance] init:申请的key  showDebug:是否打印日志];

如果想在不进入GangSDK界面前先登录GangSDK,从而收取一些即时消息等，那么在初始化后调用GangSDK的登录方法。

6、进入GangSDK界面

1>导入头文件：
#import “GangSDK+UI.h”

2>调用方法：
如果上面已经调用了登录方法，则直接调用跳转进入界面方法。
否则调用下面的登录并跳转界面方法：

[[GangSDK instance] startUI:用来跳转的controller userId:用户的唯一标识符  nickname:用户的昵称  headIconUrl:用户的头像  gameLevel:应用中用户的等级  gameRole:应用中用户的角色  extParams:额外的用户信息   success:成功回调  failure:失败回调];

如果没有自己的用户系统，可以选择下面的重载方法，GangSDK会给用户自动生成一个唯一标识符，用户会使用默认的头像，而且在用户进入GangSDK界面的时候会弹出对话框让用户自己设置一个昵称：

[[GangSDK instance] startUI:用来跳转的controller success:成功回调 failure:失败回调];

更多重载方法：

[[GangSDK instance] startUI:用来跳转的controller userId:用户的唯一标识符 nickname:用户的昵称 success:成功回调 failure:失败回调];

[[GangSDK instance] startUI:用来跳转的controller userId:用户的唯一标识符 nickname:用户的昵称 headIconUrl: 用户的头像 success:成功回调 failure:失败回调];

如果不想用默认的界面风格，可以下载其他GangUIResource来替换旧的GangUIResource文件夹，

详细集成文档下载地址：http://www.gangsdk.com/statichtml/html/gateway/other/ios.html?downloadType=detailed