iOS社区SDK集成向导
<p>[TOC]</p>
<h2>历史记录</h2>
<table>
<thead>
<tr>
<th>文档版本</th>
<th>时间</th>
<th>修改内容</th>
<th>责任人</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>v3.6.0</td>
<td>2020/01/09</td>
<td>首次编写</td>
<td>jinfeng.liu</td>
<td>无</td>
</tr>
</tbody>
</table>
<h3>1 概述</h3>
<ul>
<li>MSLDBBSSDK 是技术中台标准化社区SDK。</li>
<li>支持iOS 10及以上系统，支持arm64、armv7架构，支持Xcode 11及以上版本</li>
</ul>
<h2>重要信息</h2>
<p>在接入SDK之前，需要在我们后台申请账号并且创建应用参数，具体可以参考 <a href="https://www.showdoc.cc/mssdk?page_id=2692703335764519">技术中台服务接入指南</a> 文档。</p>
<p>本文档中涉及到的 <code>错误码</code> 可以参考下面链接的内容。</p>
<p>iOS SDK 错误码可以参考 <a href="https://www.showdoc.cc/mssdk?page_id=2629915269319032">iOS SDK 错误码</a> 文档</p>
<p>在开发者接入SDK过程中遇到任何问题，请 <a href="https://www.showdoc.cc/mssdk?page_id=2615409307929897">联系我们</a>。</p>
<h3>2 事项准备</h3>
<h4>2.1 申请乐逗参数</h4>
<ul>
<li>
<p>登录<a href="http://biz.cloud.idreamsky.com">微服务业务控制台</a>创建应用，<span id="msConfig">将下载的配置文件 msConfig.json 加入到xcode工程中。</span>.</p>
</li>
<li>
<p>如下图：
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/9bb32c077ddfb055c6995a3072b34bef?showdoc=.jpg" alt="" /></p>
</li>
<li>若无微服务帐号，请 <a href="https://www.showdoc.cc/mssdk?page_id=2615409307929897">联系我们</a> 开通。</li>
</ul>
<h3>3 SDK集成</h3>
<h4>3.1 获取SDK和配置文件</h4>
<ul>
<li>获取MSLDBBSSDK资源zip包，请 <a href="https://www.showdoc.cc/mssdk?page_id=2615409307929897">联系我们</a></li>
<li>配置文件msConfig.json，<a href="https://www.showdoc.cc/mssdk?page_id=2615409307929897">联系我们</a></li>
</ul>
<h4>3.2 配置开发环境</h4>
<h5>3.2.1 添加SDK文件到工程</h5>
<ul>
<li>解压MSLD资源zip包。</li>
<li>添加MSLDBSSSDK.framework、GSDSDKBundle文件到工程</li>
</ul>
<h5>3.2.2 添加framework文件路径</h5>
<p>选择 <strong>TARGETS</strong> –> <strong>Build Settings</strong> –> <strong>Framework Search Paths</strong>，在此添加MSLDBSSSDK的framework文件路径。（支持相对路径和绝对路径，不可含有空格）</p>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/da31d168005100ad6ada3ba3321c5eec?showdoc=.jpg" alt="" /></p>
<h5>3.2.3 嵌入动态库</h5>
<p>选择 <strong>TARGETS</strong> –> <strong>General</strong> –> <strong>Embedded Binaries</strong> -> <strong>+</strong>，添加MSLDBSSSDK.framework文件。</p>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/0cd04d476f2a07f60351a94743917315?showdoc=.jpg" alt="" /></p>
<h5>3.2.4 设置Build Settings</h5>
<p>选择 <strong>TARGETS</strong> –> <strong>Build Settings</strong> -> <strong>Other Linker Flags</strong>，添加 -ObjC和-lz。</p>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/ae72571bc589131aa209abce28f9fd9b?showdoc=.jpg" alt="" /></p>
<h5>3.2.5 添加配置文件到工程</h5>
<p>将MSSDK的配置文件msConfig.json添加到工程主目录。</p>
<h5>3.2.6 xcode需要在游戏工程的plist文件开通配置摄像头、麦克风、相册权限。</h5>
<pre><code class="language-objc"><key>Privacy - Camera Usage Description</key>
<string>游戏需要开启您的摄像头权限，用于拍摄照片</string>
<key>Privacy - Microphone Usage Description</key>
<string>游戏需要您开启相册权限，用于录制语音消息，聊天等</string>
<key>Privacy - Photo Library Usage Description</key>
<string>游戏戏需要您开启相册权限，浏览您的照片</string>
<key>Privacy - Photo Library Additions Usage Description</key>
<string>游戏需要您开启相册权限，用于保存图片</string></code></pre>
<h3>4 SDK功能使用</h3>
<ul>
<li>只有MSDSDK初始化成功，才能调用添加MSLDBSSSDK的各项功能。</li>
<li>需要先导入头文件 #import <MSLDSDK/MSLDSDK.h>。
功能：
1.是否可以打开社区。（ROUTE_BBS_INIT）
2.打开社区。 （ROUTE_BBS_START）
3.获取社区未读消息。 （ROUTE_BBS_GET_NOTICE_COUNT）</li>
</ul>