跑通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. 打开Demo工程，把HWMUISDK.framework、HWMMRMedia.framework拷贝到Demo工程中。
  图2 HWMUISDK.framework、HWMMRMedia.framework添加完成效果
2. 在“TARGETS->HWMSDKDemo->General->Frameworks、Libraries、and Embedded Content” 中，把HWMUISDK.framework、HWMMRMedia.framework修改为Embed & Sign。
  图3 HWMUISDK.framework、HWMMRMedia.framework设置
3. 把HWMExtension.framework拷贝到ScreenShareExtension中。
  图4 HWMExtension.framework添加完成效果
4. “TARGETS->ScreenShareExtension->Build Settings->Other Linker Flags” 中添加-lc++。
  图5 ScreenShareExtension设置
5. 下载masonry，拷贝源码到工程中。
  图6 Masonry添加完成效果
6. HWMSDKDemo-Prefix.h修改Masonry引用方式。
  图7 修改Masonry引用方式
7. 下载AFNetworking，拷贝源码到工程中。
  图8 AFNetworking添加完成效果
8. SchemeLinkViewController.m、APPIDLoginViewController.m修改AFNetworking引用方式。
  图9 SchemeLinkViewController.m修改AFNetworking引用方式
  
  图10 APPIDLoginViewController.m修改AFNetworking引用方式
工程配置
1. HWMSDKDemo修改Bundle ID，导入描述文件。创建证书、描述文件步骤，参见“如何申请iOS证书”。
  图11 配置页面
2. 编辑HWMSDKDemo.entitlements，删除“Associated Domains”配置项，修改“App Groups”配置为HWMSDKDemo的Bundle ID对应的App Groups。
  图12 HWMSDKDemo.entitlements配置页面
3. ScreenShareExtension修改Bundle ID，导入描述文件。
  图13 配置页面
4. 编辑ScreenShareExtension.entitlements，修改“App Groups”配置为ScreenShareExtension的Bundle ID对应的App Groups。
  图14 ScreenShareExtension.entitlements配置页面
5. ScreenShareExtensionSetupUI修改Bundle ID，导入描述文件。
  图15 配置页面
6. 编辑ScreenShareExtensionSetupUI.entitlements，修改“App Groups”配置为ScreenShareExtensionSetupUI的Bundle ID对应的App Groups。
  图16 ScreenShareExtensionSetupUI.entitlements配置页面
7. 编译运行。
使用Demo

以创建1个即时会议为例：
1. 点击“初始化”按钮，初始化SDK。
  
  图17 iOS Demo首界面
2. 登录
  
  账号密码登录：点击“登录”按钮进入“登录页面”，在“登录页面”输入账号密码后点击“登录”。
  
  图18 iOS Demo登录界面
  
  AppID登录
  
  App ID申请步骤请参考“App ID鉴权介绍”。申请审批完成后将获得一个App ID。
  
  方法一：直接在代码中修改默认值,
  
  将 HWMUISDKDemoConfig.plist中的AppId、AppKey替换为申请到的App ID、AppKey。
  
  方法二：配置修改AppID后，再初始化SDK
  
  步骤：打开demo->全局配置->设置AppID和key->修改保存->初始化SDK后正常登录即可
3. 点击“创建会议”按钮，进入创建会议界面，创建会议。
  图19 iOS Demo创建会议界面
  
  图20 iOS Demo会中界面