一、概述 #

#lfeng/wellplay/客户端集成/IOS

本节主要介绍如何创建一个应用，并集成 WellplaySDK。

1、支持版本 #

iOS 9.0及以上版本，建议运行时提前判定系统版本，如果系统版本过低则隐藏社区的入口。

2、下载WellplaySDK #

从官网下载WellplaySDK开发包，主要包括必选SDK、扩展SDK。

SDK包必须是一个版本成套使用，不同版本不可混用。

2.1、必选SDK #

WellplaySDK基础版

2.2、扩展SDK #

IM功能包

3、创建应用 #

3.1、创建一个新工程 #

3.2、填入工程名（如：HelloWellplay） #

3.3、集成WellplaySDK #

3.3.1、添加WellplaySDK #

直接将WellplaySDK添加到项目目录：

参考效果如下：

备注：/WPlaySDK/WPlay目录下的WPlay_phone_dev.a为真机使用的静态库，WPlay_simulator_dev.a为模拟器使用的静态库，开发时可以根据实际情况选用。

3.3.1、设置`Build Settings` #

在Linkin->Other Linker Flags中添加配置：

-ObjC
-Iresolv

3.3.2、设置`相机`、`相册`访问权限 #

由于正常使用社区中需要允许用户通过相机或者相册上传图片，因此需要在info.plist中增加设置。

以采用Open As->Source Code的方式编辑info.plist时的配置为例，在dict的节点中追加以下配置：

<key>NSPhotoLibraryUsageDescription</key>
<string>允许游戏访问您的相册以分享您的图片。</string>
<key>NSCameraUsageDescription</key>
<string>允许游戏使用您的摄像头以拍摄照片。</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>允许游戏访问您的相册以存储的图片。</string>

参考效果如下：

Property List下效果：

3.4、功能开发 #

在调用代码中根据需要引入头文件WPlay.h、WPlayConfigure.h、WPlayIM.h，并根据后续章节的指引进行开发。

3.5、IM系统扩展包 #

如果需要使用IM系统，除了下载带IM系统的版本外，需要在Build Phases->Link Binary With Libraries中增加以下依赖：

CoreTelephony.framework
SystemConfiguration.framework
libc++.dylib
libz.dylib
libsqlite3.dylib

4、自定义资源 #

Wellplay 允许配置部分客户端的资源。

4.1、定制主色调 #

打开 WPlay.bundle -> color -> wplay_color.plist 文件，开发者可自定义色值均可在这个plist文件中设置，如下图:

4.2、定制社区图标 #

打开WPlay.bundle->image文件，替换文件内的同名资源即可。

4.3、定制客户端敏感词 #

打开WPlay.bundle->sensitive_word.txt，开发者可以自定义客户端的敏感词，所有包含敏感词的公开信息都会被拒绝发出。

目前受敏感词影响的内容如下：

用户昵称，会被拒绝修改。
用户签名，会被拒绝修改。
帖子标题，会被替换成*号。
帖子正文，会被替换成*号。
帖子评论正文，会被替换成*号。

除了客户端敏感词外，服务端也会对敏感词进行处理，规则同上，用户可以在控制台配置。

Wellplay系统本身内置了一系列敏感词，这些敏感词总是会生效，默认的敏感词与sensitive_word中的记录一致，用户仅可定制额外的个性化敏感词。

如果有特殊需求请联系客服。

5、常见问题 #

5.1、编译时报错`Undefined symbols for architecture x86_64:"_res_9_setservers`？ #

已知遇到这种情况的时候，通过在Build Phases->Link Binary With Libraries中增加以下依赖：

libresolv.9.tbd

可以解决。

5.2、三方库重复？ #

Wellplay使用到的三方库放置在WellplaySDK/WPLibraries目录下。如果你的游戏工程也在使用相同的库，删除一个即可。