tencent cloud

文档反馈

最后更新时间:2024-01-02 16:11:16
    本文主要介绍如何快速将腾讯云即时通信 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 功能,请您联系我们

    手动集成

    1. 下载 SDK

    Github 下载最新版本 SDK。
    ImSDK_Plus.framework 是 IM SDK 的核心动态库文件。
    包名
    介绍
    ImSDK_Plus.framework
    增强版 IM 功能包

    2. 创建工程

    创建一个新工程
    
    
    填入工程名(例如 IMDemo):
    
    

    3. 集成 IM SDK

    添加依赖库:选中 IMDemo 的Target,在General面板中的 Embedded BinariesLinked 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>
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持