集成 SDK（Windows）

最近更新时间：2021-08-30 15:39:25

前往 GitHub 编辑 我的收藏

本页目录：

本文介绍如何快速地将腾讯云的 IM SDK 集成到项目中，只要按照如下步骤进行操作，可以轻松完成 IM SDK 的集成工作。

开发环境要求

操作系统：最低要求是 Windows 7。
开发环境：最低版本要求是 Visual Studio 2010，推荐使用 Visual Studio 2015。

集成 IM SDK

下面通过创建一个简单的 MFC 项目，介绍如何在 Visual Studio 2015 工程中集成 SDK。

步骤1. 下载 IM SDK

在 Github 下载 Windows IM SDK，Windows IM SDK 的下载方式如下：

下载并解压打开 IM SDK 文件夹，包含以下几个部分：

目录名	说明
includes	接口头文件
lib\Win32\Debug	32位 Debug 模式，采用 /MTd 选项链接库文件
lib\Win32\Release	32位 Release 模式，采用 /MT 选项链接库文件
lib\Win64\Debug	64位 Debug 模式，采用 /MTd 选项链接库文件
lib\Win64\Release	64位 Release 模式，采用 /MT 选项链接库文件

步骤2. 新建工程

打开 Visual Studio，新建一个名为 IMDemo 的 MFC 应用程序，如下图所示：

为了便于快速集成，在向导的应用程序类型页面，请选择比较简单的基于对话框类型，其他的向导配置，请选择默认的配置即可。如下图所示：

步骤3. 拷贝文件

将解压后的 IM SDK 文件夹拷贝到 IMDemo.vcxproj 所在目录下，如下图所示：

步骤4. 修改工程配置

IM SDK 提供了 Debug 和 Release 两种编译生成的静态库，针对这两种有些地方要专门配置。打开 IMDemo 属性页，在解决方案资源管理器>IMDemo工程的右键菜单>属性。

以32位 Debug 模式为例，请按照以下步骤进行配置：

添加包含目录
在 C/C++>常规>附件包含目录，添加 IM SDK 头文件目录 $(ProjectDir)ImSDK\includes，如下图所示：
添加库目录
在 链接器>常规>附加库目录，添加 IM SDK 库目录 $(ProjectDir)ImSDK\lib\Win32\Debug
添加库文件
在 链接器>输入>附加依赖项，添加 IM SDK 库文件 imsdk.lib ，如下图所示：
拷贝 DLL 到执行目录
在生成事件>预先生成事件>命令行，输入 xcopy /E /Y "$(ProjectDir)ImSDK\lib\Win32\Debug" "$(OutDir)"，拷贝 imsdk.dll 动态库文件到程序生成目录，如下图所示：
指定源文件的编码格式
由于 IM SDK 的头文件采用 UTF-8 编码格式，部分编译器按默认系统编码格式编译源文件，可能导致编译无法通过，设置此参数可指定编译器按照 UTF-8 的编码格式编译源文件。
在 C/C++>命令行>其他选项，输入/source-charset:.65001，如下图所示：

Release 模式具体设置如下：

添加库目录
在 链接器>常规>附加库目录，添加 IM SDK 库目录 $(ProjectDir)ImSDK\lib\Win32\Release，如下图所示：
拷贝 DLL 到执行目录
在生成事件 >预先生成事件>命令行，输入 xcopy /E /Y "$(ProjectDir)ImSDK\lib\Win32\Release" "$(OutDir)"，拷贝 imsdk.dll 动态库文件到程序生成目录，如下图所示：

64位 Debug/Release 与 32位 的设置也大部分相同，不同在于 IM SDK 的库目录。具体如下

添加库目录
- Debug 模式 在 链接器>常规>附加库目录，添加 IM SDK 库目录 $(ProjectDir)ImSDK\lib\Win64\Debug，如下图所示：
- Release 模式 在 链接器>常规>附加库目录，添加 IM SDK 库目录 $(ProjectDir)ImSDK\lib\Win64\Release，如下图所示：
拷贝 DLL 到执行目录
- Debug 模式 在生成事件 >预先生成事件>命令行，输入 xcopy /E /Y "$(ProjectDir)ImSDK\lib\Win64\Debug" "$(OutDir)"，拷贝 imsdk.dll 动态库文件到程序生成目录，如下图所示：
- Release 模式 在生成事件 >预先生成事件>命令行，输入 xcopy /E /Y "$(ProjectDir)ImSDK\lib\Win64\Release" "$(OutDir)"，拷贝 imsdk.dll 动态库文件到程序生成目录，如下图所示：

步骤5. 打印 IM SDK 版本号

在 IMDemo.cpp 文件中，添加头文件包含：
```
#include "TIMCloud.h"
```

在 CIMDemoDlg::OnInitDialog 函数中，添加下面的测试代码：

std::string version = TIMGetSDKVersion();
CString szText;
szText.Format(L"SDK version: %hs", version.c_str());
CWnd* pStatic = GetDlgItem(IDC_STATIC);
pStatic->SetWindowTextW(szText);

按键盘 F5 键运行，打印 IM SDK 的版本号，如下图所示：

常见问题

出现以下错误，请按照前面的工程配置，检查 IM SDK 头文件的目录是否正确添加：
```
fatal error C1083: 无法打开包括文件: “TIMCloud.h”: No such file or directory
```

出现以下错误，请按照前面的工程配置，检查 IM SDK 库目录和库文件是否正确添加：

LINK : fatal error LNK1104: 无法打开文件“imsdk.lib”

error LNK2019: 无法解析的外部符号 __imp__TIMGetSDKVersion，该符号在函数 "protected: virtual int __thiscall CIMDemoDlg::OnInitDialog(void)" (?OnInitDialog@CIMDemoDlg@@MAEHXZ) 中被引用

出现以下错误，请按照前面的工程配置，检查 IM SDK 的 DLL 是否拷贝到执行目录：

下一篇: 产品动态