ONS C++ Windows SDK 调试方法及注意事项

此文将展示ONS C++ Windows SDK 整个调试过程，笔者直接使用sdk包中的example消息发送示例代码，开发环境为win7, 64位，Visual Studio Professional 2013（版本 12.0.21005.1 REL）。

下载最新sdk包（文中使用代码为2015年10月14号发布），并解压（本地保存目录为D:\Doc\ONS\C++\aliyun-ons-client-cpp-windows）。

在调试前请详细阅读使用文档说明ALIYUN_ONS_CLIENT_FOR_CPP_AND_NET_USER_GUIDE。

include提供了头文件，lib分别提供了32位和64位的依赖包（ONSClient4CPP.dll, ONSClient4CPP.lib, ONSClient4CPP.pdb），example提供了消息发送和消息消费的示例代码，本文使用的就是消息发送示例代码。

1. 新建项目

确定，点击下一步。

点击完成，项目已经创建好。

2. 创建源文件，并引入头文件

源文件，添加新建项，将example中ProducerExampleForEx内容复制过来。

头文件，添加现有项，将include文件夹中所有头文件添加进来。

项目右键->属性->C/C++->常规->附加包含目录，将头文件目录D:\Doc\ONS\C++\aliyun-ons-client-cpp-windows\include包含进来。

链接器->常规->附件库目录，将ONSClient4CPP.lib的目录D:\Doc\ONS\C++\aliyun-ons-client-cpp-windows\lib\32位包含进来。

以上进行的设置是针对32位的，如果用户需要调试64位，那么需要点击配置管理器，新建x64平台，且将64位ONSClient4CPP.lib所在目录包含进来，如下图。

链接器->输入->附件依赖项，将ONSClient4CPP.lib加进来。

3. 其他设置

C/C++->代码生成->基本运行时检查，置为默认值。

清单工具->输入和输出->嵌入清单，置为否。

4. 生成解决方案

这里选择的解决方案配置为Debug，可以看到相应的可执行文件ONSdemo.exe已经生成，位于目录D:\Program Files\vsProject\ONSdemo\Debug下；同时也可看到一些warn, 一是警告需要调用ONSClient4CPP.dll（见5）, 二是警告没有处理异常e（用户需要根据自己的业务，后续加上处理异常的逻辑，增强程序健壮性）。

5. 调用dll

将ONSClient4CPP.dll，ONSClient4CPP.pdb和ONSdemo.exe置于相同目录D:\Program Files\vsProject\ONSdemo\Debug下即可。

sdk包中msvcp120.dll和msvcr120.dll是vs组件，一般在本地安装vs后，可在C:\Windows\System32里找到；如果没有，也不用着急，将sdk包中的这两个dll拷贝到C:\Windows\System32或者和ONSdemo.exe位于相同目录就可以了。

6. 启动调试

启动调试前，根据用户自己的数据，修改参数producerId, topic, AccessKey, SecretKey。

factoryInfo.setFactoryProperty(ONSFactoryProperty::ProducerId, "PID_xxxxxxxx");//在ONS控制台申请的producerId
factoryInfo.setFactoryProperty(ONSFactoryProperty::PublishTopics, "xxxxxxxxx");// 在ONS 控制台申请的msg topic
factoryInfo.setFactoryProperty(ONSFactoryProperty::MsgContent, "input msg content");//消息内容
factoryInfo.setFactoryProperty(ONSFactoryProperty::AccessKey, "xxx");//ONS AccessKey
factoryInfo.setFactoryProperty(ONSFactoryProperty::SecretKey, "xxxxxxxxx");// ONS SecretKey

producerId, topic需要提前在控制台创建，公网环境的topic可在本地测试使用，否则需要部署在相应地域ECS上才能正常使用ONS服务。

启动调试后，没有异常抛出，就说明消息成功发送了。

7. 检验消息是否发送成功

建议在消息中设置key属性，方便利用key值在控制台上查询消息。

例如：msg.setKey("ONSdemotest");

这里再次提醒，32位或者64位依赖包ONSClient4CPP的引入和Win32, x64平台的选择一定要一致；另外，如果使用其他版本vs，需格外留意，与文中其他设置 中的参数值保持一致。