Tencent Cloud

Recent Pages

iOS

最后更新时间：2024-04-02 16:25:57

本文主要介绍如何快速将腾讯云即时通信 IM SDK 集成到您的 iOS 项目中。
开发环境要求
Xcode 9.0+。
iOS 8.0 以上的 iPhone 或者 iPad 真机。
项目已配置有效的开发者签名。
集成 IM SDK
您可以选择使用 CocoaPods 自动加载的方式，或者先 下载 SDK，再将其导入到您当前的工程项目中。
CocoaPods 自动加载
1. 安装 CocoaPods
在终端窗口中输入如下命令（需要提前在 Mac 中安装 Ruby 环境）：
sudo gem install cocoapods
2. 创建 Podfile 文件
进入项目所在路径输入以下命令行，之后项目路径下会出现一个 Podfile 文件。
pod init
3. 编辑 Podfile 文件
请您按照如下方式设置 Podfile 文件：
platform :ios, '8.0'
source 'https://github.com/CocoaPods/Specs.git'
﻿
target 'App' do
    # 添加 IM SDK
    pod 'TXIMSDK_Plus_iOS'
    # pod 'TXIMSDK_Plus_iOS_XCFramework'
    # pod 'TXIMSDK_Plus_Swift_iOS_XCFramework'
﻿
﻿
    # 如果您需要添加 Quic 插件，请取消下一行的注释
    # 注意：这个插件必须搭配 Objective-C 版本或 XCFramework 版本的 IMSDK 使用，并且插件版本号必须和 IM SDK 版本号相同
    # pod 'TXIMSDK_Plus_QuicPlugin'
end
4. 更新并安装 SDK
在终端窗口中输入如下命令以更新本地库文件，并安装 TXIMSDK：
pod install
或使用以下命令更新本地库版本：
pod update
pod 命令执行完后，会生成集成了 SDK 的 .xcworkspace 后缀的工程文件，双击打开即可。
说明
若 pod 搜索失败，建议尝试更新 pod 的本地 repo 缓存。更新命令如下：
pod setup
pod repo update
rm ~/Library/Caches/CocoaPods/search_index.json
Quic 插件，提供 axp-quic 多路传输协议，弱网抗性更优，网络丢包率达到 70% 的条件下，仍然可以提供服务。仅对旗舰版用户开放，对于非旗舰版，请购买旗舰版套餐包 后可使用，详见 价格说明。为确保功能正常使用，请将终端 SDK 更新至 7.7.5282 及其以上的版本。 
如果您需要在 Swift 版本的 IMSDK 中使用 Quic 功能，请您联系我们。
注意：
若您进行上述操作后仍遇到问题，欢迎查阅 Xcode 15 常见问题。
手动集成
1. 下载 SDK
从 Github 下载最新版本 SDK。
ImSDK_Plus.framework 是 IM SDK 的核心动态库文件。
包名
介绍
ImSDK_Plus.framework
增强版 IM 功能包
2. 创建工程
创建一个新工程：
﻿
﻿
填入工程名（例如 IMDemo）：
﻿
﻿
3. 集成 IM SDK
添加依赖库：选中 IMDemo 的Target，在General面板中的 Embedded Binaries和Linked Frameworks and Libraries添加依赖库 ImSDK_Plus.framework。
﻿
﻿
设置链接参数：在Build Setting>Other Linker Flags添加 -ObjC。
说明
手动集成需要在TARGET>General>Frameworks> Libraries and Embedded Content，将 ImSDK_Plus.framework 修改为 Embed&Sing。
如果您需要添加 Quic 插件，请参考前面的步骤，手动下载集成 Quic 插件。
引用 IM SDK
项目代码中使用 SDK 有两种方式：
方式一
在 Xcode > Build Setting > Header Search Paths 设置 SDK 头文件的路径，然后在项目需要使用 SDK API 的文件里，引入具体的头文件。
#import "ImSDK_Plus.h"
方式二
在项目需要使用 SDK API 的文件里，引入具体的头文件。
#import <ImSDK_Plus/ImSDK_Plus.h>
﻿
Xcode15 集成时常出现的问题：
1.  [Xcodeproj] Unknown object version (60). (RuntimeError)
﻿
﻿
﻿
      使用Xcode15创建新工程来集成 SDK 时，输入pod install 后，可能会遇到此问题，原因是使用了较旧版本的CocoaPods ，此时有两种解决办法：
解决方式一： 修改 Xcode 工程的 Project Format 版本。
﻿
﻿
﻿
解决方式二： 升级本地的 CocoaPods 版本，升级方式本文不再赘述。
您可以在终端输入 pod --version 查看当前的Pods版本。
2. Xcode 15 开发者沙盒选项问题
Sandbox: bash(xxx) deny(1) file-write-create
﻿
﻿
﻿
当您使用 Xcode 15 创建一个新工程时， 可能会因为此选项导致编译运行失败，建议您关闭此选项。
﻿
﻿
﻿
﻿