Windows下编译使用Aliyun OSS C SDK

Visual Studio(VS)是win平台下，编译运行C/C++程序的首选。微软发布的VS主要版本如下表：

本文以 VS2008、VS2010、VS2012、VS2013、VS2015 为例说明编译OSS C SDK、运行示例程序的方法。

编译Aliyun OSS C SDK

VS2008

1. 打开工程
选择oss_c_sdk_2008.sln右键打开方式中选择Microsoft Visual Studio 2008打开。
如果右键打开方式中没有Microsoft Visual Studio 2008，先打开Visual Studio 2008，在VS2008中打开工程，方法是 File-> Open -> Project/Solution 选择oss_c_sdk_2008.sln打开。

2. 设置启动工程
把工程oss_c_sdk_test设置为启动工程，方法在在oss_c_sdk_test右键选择Set as StartUp Project

3. 编译
在Solution Explorer中选择oss_c_sdk_test，右键选择Rebuild。编译出的OSS C SDK库，在工程目录下的

4. 可能出现的问题

• 错误： error LNK2019: unresolved external symbol _oss_create_live_channel referenced in function _create_test_live_channel
  原因： 新加的文件oss_live.c等没有加入工程

解法： oss_c_sdk右键选择Add -> Existing Item...，选择oss_c_sdk目录下的所有.h、.c文件，加入工程oss_c_sdk

• 错误： error LNK2019: unresolved external symbol __imp__inet_addr@4 referenced in function _is_valid_ip
  原因： oss_c_sdk_test中缺少库ws2_32.lib

解法： oss_c_sdk_test右键选择Properties -> Configuration Properties -> Linker -> Input -> Additional Dependencies中加入ws2_32.lib

• 错误： fatal error C1083: Cannot open include file: 'stdint.h': No such file or directory
  原因： 缺少头文件stdint.h

解法： third_party/include里的stdint.h.bak修改成stdint.h

5. 库位置
编译出来的OSS C SDK库，在工程目录的Debug/Release里，即oss_c_sdk.lib。

VS2010

1. 打开工程
选择oss_c_sdk.sln右键打开方式中选择Microsoft Visual Studio 2010打开。

2. 设置启动工程
把工程oss_c_sdk_test设置为启动工程，方法在在oss_c_sdk_test右键选择Set as StartUp Project

3. 编译
在Solution Explorer中选择oss_c_sdk_test，右键选择Rebuild。编译出的OSS C SDK库，在工程目录下的

4. 可能出现的问题

• 错误： error MSB8008: Specified platform toolset (v140) is not installed or invalid. Please make sure that a supported PlatformToolset value is selected.
  原因： PlatformToolset值与当前VS版本不符

解法： 按照如下路径 Solution Explorer -> oss_c_sdk -> Properties -> Configuration Properties -> Platform Toolset，修改V140为V100

5. 库位置
编译出来的OSS C SDK库，在工程目录的Debug/Release里，即oss_c_sdk.lib。

VS2012

1. 打开工程
选择oss_c_sdk.sln右键打开方式中选择Microsoft Visual Studio 2012打开。

2. 设置启动工程
把工程oss_c_sdk_test设置为启动工程，方法在在oss_c_sdk_test右键选择Set as StartUp Project

3. 编译
在Solution Explorer中选择oss_c_sdk_test，右键选择Rebuild。编译出的OSS C SDK库，在工程目录下的

4. 可能出现的问题

• 错误： error MSB8020: The builds tools for v140 (Platform Toolset = 'v140') cannot be found. To build using the v140 build tools, either click the Project menu or right-click the solution, and then select "Update VC++ Projects...". Install v140 to build using the v140 build tools.
  原因： PlatformToolset值与当前VS版本不符

解法： 按照如下路径 Solution Explorer -> oss_c_sdk -> Properties -> Configuration Properties -> Platform Toolset，修改V140为Visual Studio 2012 (v110)

5. 库位置
编译出来的OSS C SDK库，在工程目录的Debug/Release里，即oss_c_sdk.lib。

VS2013/VS2015

VS2013/VS2015编译Aliyun OSS C SDK的方法完全相同，下面以VS2015为例说明。

1. 打开工程
选择oss_c_sdk.sln右键打开方式中选择Microsoft Visual Studio 2015/打开。

2. 设置启动工程
把工程oss_c_sdk_test设置为启动工程，方法在在oss_c_sdk_test右键选择Set as StartUp Project

3. 编译
在Solution Explorer中选择oss_c_sdk_test，右键选择Rebuild。编译出的OSS C SDK库，在工程目录下的

4. 库位置
编译出来的OSS C SDK库，在工程目录的Debug/Release里，即oss_c_sdk.lib。

运行示例程序

下载

有一下两种方式下载OSS C SDK示例程序aliyun-oss-c-sdk-sample：

• OSS官网下载：OSS C SDK安装 ;
• GitHub下载：GitHub 。

运行

aliyun-oss-c-sdk-sample版本里，提供了VS2008、VS2010、VS2012、VS2013、VS2015的示例。

• 替换oss_c_sdk.lib。在oss-c-sdk-sampleoss-c-sdklibRelease是OSS C SDK包oss_c_sdk.lib。该包是上一个发布版本的release包，您可以继续使用，也可以用您编译出来的版本替换。
• 打开工程。根据您的Visual Studio版本，选择对应的工程。选择oss-c-sdk-sample.sln右键打开方式中选择对应VS打开工程。
• 修改参数。修改main.c 中的OSS_ENDPOINT、ACCESS_KEY_ID、ACCESS_KEY_SECRET、BUCKET_NAME为您的实际参数。
• 编译。在Solution Explorer中选择oss-c-sdk-sample，右键选择Rebuild。
• 配置Environment。按照如下路径配置 Solution Explorer -> oss-c-sdk-sample -> Property -> Configuration Properties -> Debugging -> Environment 修改为 PATH=..\oss-c-sdk\lib\Release\;%PATH%。
• 运行。用Ctrl+F5执行示例程序。

揭秘Sample工程

OSS C SDK Sample工程是怎么做出来的呢？VS2008、VS2010、VS2012、VS2013、VS2015的做法基本相同，下面以VS2012为例说明。

• 准备库和头文件。准备SDK库/头文件，第三方库/头文件。合并SDK库/头文件、第三方库/头文件，结果为oss-c-sdk-sampleoss-c-sdk目录。oss-c-sdk目录直接放在工程目录下。
• 配置头文件路径。在路径 Solution Explorer -> oss-c-sdk-sample -> Property -> Configuration Properties -> VC++ Directories -> Include Directories，添加如下配置：

..\oss-c-sdk\include
..\oss-c-sdk\include\apr
..\oss-c-sdk\include\aprutil
..\oss-c-sdk\include\curl
..\oss-c-sdk\include\mxml
..\oss-c-sdk\include\sdk

• 配置库路径。在路径 oss-c-sdk-sample -> Property -> Configuration Properties -> Linker -> General -> Additional Library Directories，添加 ..\oss-c-sdk\lib\Release
• 配置库。在路径 oss-c-sdk-sample -> Property -> Configuration Properties -> Linker -> Input -> Additional Dependencies，添加如下配置：

libapr-1.lib
libaprutil-1.lib
curl.lib
mxml1.lib
oss_c_sdk.lib
ws2_32.lib

如果您想从一个空工程开始编写自己的程序，或者在已有的工程中使用OSS C SDK，请参考Sample工程的配置方法。

提示：

• 目前OSS C SDK支持WIN32(x86)，暂不支持x64；VS2015编译、运行的时候请选择x86，勿选择x64。
• 您想更多了解OSS C SDK，请参看 帮助与文档 。