跑通iOS Demo

本小节描述如何快速编译并运行客户端SDK的iOS Demo。

环境要求

在iOS Demo的编译运行过程中请满足如下环境要求。

表1 环境要求
环境和工具名称	版本要求	说明
操作系统	Mac OSX High Sierra 10.14.4及以上	Xcode对Mac系统要求，推荐版本10.15以上
Xcode	Xcode11及以上	Demo及文档以Xcode11.3.1为例
iOS系统版本	iOS11.0及以上，64位设备	屏幕共享功能需iOS12及以上
测试资源及App ID申请	-	请参见“开发前准备”。

表2 项目配置要求
名称	要求	说明
Enable Bitcode	NO	不支持编译代码优化
Valid Architectures	arm64	支持CPU架构
Other Link Flags	-ObjC	把静态库中所有的Objective-C类和分类都加载到最后的可执行文件中

表3 第三方开源库
开源库名称	建议版本
Masonry	必须使用1.1.0及以上
SSZipArchive	2.1.3
YYModel	1.0.4
CocoaLumberjack	3.4.1
libyuv	1.0.2
AFNetworking	4.0.1

操作步骤

下载SDK和Demo源码
1. 按照“SDK下载”章节，下载SDK的ZIP包。
2. 解压ZIP包，得到如下文件及目录。
图1 SDK包的目录结构
添加依赖库
1. 把HWMUISDK.framework、HWMMRMedia.framework拷贝到Demo中。在“TARGETS->HWMSDKDemo->General->Frameworks、Libraries、and Embedded Content” 中修改为Embed & Sign。
2. 把HWMExtension.framework拷贝到ScreenShareExtension中,“TARGETS—>ScreenShareExtension—>Build Settings->Other Linker Flags” 中添加-lc++。
3. 把导入的HWMUISDK.framework设置为Embed & Sign。
  图2 HWMUISDK.framework、HWMMRMedia.framework设置
  
  图3 HWMExtension.framework设置
4. 下载masonry，拷贝源码到工程中。
工程配置
1. 修改bundle identifier、App Groups，安装对应的证书。创建和管理证书地址参见“证书地址”。
2. 编译运行。
使用Demo
以创建1个即时会议为例：
1. 点击“初始化”按钮，初始化SDK。
  
  图4 iOS Demo首界面
2. 登录
  
  账号密码登录：点击“登录”按钮进入“登录页面”，在“登录页面”输入账号密码后点击“登录”。
  
  图5 iOS Demo登录界面
  
  AppID登录
  
  App ID申请步骤请参考“App ID鉴权介绍”。申请审批完成后将获得一个App ID。
  
  方法一：直接在代码中修改默认值,
  
  将 HWMUISDKDemoConfig.plist中的AppId、AppKey替换为申请到的App ID、AppKey。
  
  方法二：配置修改AppID后，再初始化SDK
  
  步骤：打开demo->全局配置->设置AppID和key->修改保存->初始化SDK后正常登录即可
3. 点击“创建会议”按钮，进入创建会议界面，创建会议。
  图6 iOS Demo创建会议界面
  
  图7 iOS Demo会中界面