https://help.aliyun.com/document_detail/106216.html?spm=a2c4g.11186623.6.985.66d325d1rtNFB0
编译环境: 本文编译环境为 VS2019 + window10 64位系统
二、编译SDK 1、X64版本的编译 1.1 cmake配置 查看aliyun-oss-cpp-sdk-master/CMakeLists.txt ,已经做了编译工具链跟操作系统选择的自动适配。
windows X64上使用cmake直接编译,对应生成 x64位的SDK:alibabacloud-oss-cpp-sdk.lib
#
# Copyright 2009-2017 Alibaba Cloud All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR ConDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
cmake_minimum_required(VERSION 3.1)
cmake_policy(SET CMP0048 NEW)
set_property(GLOBAL PROPERTY USE_FOLDERS ON)
#Project setting
file(STRINGS "VERSION" version)
project(alibabacloud-oss-cpp-sdk VERSION ${version})
message(STATUS "Project version: ${PROJECT_VERSION}")
set(SDK_ROOT "${CMAKE_CURRENT_SOURCE_DIR}")
set(TARGET_OUTPUT_NAME_PREFIX "alibabacloud-oss-" CACHE STRING "The target's output name prefix")
#Options
option(BUILD_SHARED_LIBS "Enable shared library" OFF)
option(BUILD_SAMPLE "Build sample" ON)
option(BUILD_TESTS "Build unit and perfermence tests" OFF)
option(ENABLE_COVERAGE "Flag to enable/disable building code with -fprofile-arcs and -ftest-coverage. Gcc only" OFF)
option(ENABLE_RTTI "Flag to enable/disable building code with RTTI information" ON)
#Platform
if (CMAKE_CROSSCOMPILING)
if (${CMAKE_SYSTEM_NAME} STREQUAL "Android")
set(PLATFORM_ANDROID 1)
set(TARGET_OS "ANDROID")
else()
message(FATAL_ERROR "Do not support target platform")
endif()
else()
if(CMAKE_HOST_APPLE)
set(PLATFORM_APPLE 1)
set(TARGET_OS "APPLE")
elseif(CMAKE_HOST_UNIX)
set(PLATFORM_LINUX 1)
set(TARGET_OS "LINUX")
elseif(CMAKE_HOST_WIN32)
set(PLATFORM_WINDOWS 1)
set(TARGET_OS "WINDOWS")
else()
message(FATAL_ERROR "Do not support unknown host OS")
endif()
endif()
message(STATUS "TARGET_OS: ${TARGET_OS}")
add_definitions(-DPLATFORM_${TARGET_OS})
# ------------------------------------------------------------------------------------------
# 从此处逻辑可以看出,CMake自动选择编译工具链。在windows上如果操作系统为x64,则VS默认选择cl64的工具
# 如果要编译OSS SDK的目标版本为64位,则不用对CMakeLists.txt 文件做任何的修改。直接按照编译步骤进行编译即可
# ------------------------------------------------------------------------------------------
#Find dependency Library, curl, openssl
if (${TARGET_OS} STREQUAL "WINDOWS")
set(WLIB_TARGET "Win32")
if (CMAKE_CL_64)
set(WLIB_TARGET "x64")
endif()
set(CRYPTO_LIBS
${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/ssleay32.lib
${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/libeay32.lib)
set(CRYPTO_INCLUDE_DIRS
${CMAKE_SOURCE_DIR}/third_party/include)
set(CLIENT_LIBS
${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/libcurl.lib)
set(CLIENT_INCLUDE_DIRS
${CMAKE_SOURCE_DIR}/third_party/include)
else()
include(FindCURL)
include(FindOpenSSL)
if(NOT CURL_FOUND)
message(FATAL_ERROR "Could not find curl")
endif()
if(NOT OPENSSL_FOUND)
message(FATAL_ERROR "Could not find openssl")
endif()
set(CRYPTO_LIBS ${OPENSSL_LIBRARIES})
set(CRYPTO_INCLUDE_DIRS ${OPENSSL_INCLUDE_DIRS})
set(CRYPTO_LIBS_ABSTRACT_NAME crypto ssl)
set(CLIENT_LIBS ${CURL_LIBRARIES})
set(CLIENT_INCLUDE_DIRS ${CURL_INCLUDE_DIRS})
set(CLIENT_LIBS_ABSTRACT_NAME curl)
endif()
#Compiler flags
list(APPEND SDK_COMPILER_FLAGS "-std=c++11")
if(CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
list(APPEND SDK_COMPILER_FLAGS "/MP")
if (NOT ENABLE_RTTI)
list(APPEND SDK_COMPILER_FLAGS "/GR-")
endif()
elseif (CMAKE_CXX_COMPILER_ID MATCHES "Clang")
list(APPEND SDK_COMPILER_FLAGS "-fno-exceptions" "-fPIC" "-fno-rtti")
if (NOT ENABLE_RTTI)
list(APPEND SDK_COMPILER_FLAGS "-fno-rtti")
endif()
list(APPEND SDK_COMPILER_FLAGS "-Wall" "-Werror" "-pedantic" "-Wextra")
else()
list(APPEND SDK_COMPILER_FLAGS "-fno-exceptions" "-fPIC")
if (NOT ENABLE_RTTI)
list(APPEND SDK_COMPILER_FLAGS "-fno-rtti")
endif()
list(APPEND SDK_COMPILER_FLAGS "-Wall" "-Werror" "-pedantic" "-Wextra")
if (ENABLE_COVERAGE)
SET(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -fprofile-arcs -ftest-coverage")
SET(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -fprofile-arcs -ftest-coverage")
SET(CMAKE_EXE_linkER_FLAGS_DEBUG "${CMAKE_EXE_linkER_FLAGS_DEBUG} -fprofile-arcs -ftest-coverage")
endif()
endif()
if (BUILD_SHARED_LIBS)
set(STATIC_LIB_SUFFIX "-static")
else()
set(STATIC_LIB_SUFFIX "")
endif()
include(ExternalProject)
include(GNUInstallDirs)
add_subdirectory(sdk)
if(BUILD_SAMPLE)
add_subdirectory(sample)
endif()
if(BUILD_TESTS)
add_subdirectory(test)
add_subdirectory(ptest)
endif()
1.2 编译
``
cd2、x86 版本编译mkdir build cd build cmake ..
在windows10 X64版本上编译 x86的插件库,需要指定CMake的编译工具链为 x86的cl.exe工具, 如
[]: C:/Program Files (x86)/Microsoft Visual Studio/2019/Enterprise/VC/Tools/MSVC/14.27.29110/bin/Hostx86/x86
有两种方法,一种是在命令行中指定编译工具链,另一种方式就是通过Cmake的GUI工具配置。
2.1 cmake配置做如下修改。本文是直接默认使用win32(x86)的库文件~
#
# Copyright 2009-2017 Alibaba Cloud All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR ConDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
cmake_minimum_required(VERSION 3.1)
cmake_policy(SET CMP0048 NEW)
set_property(GLOBAL PROPERTY USE_FOLDERS ON)
#Project setting
file(STRINGS "VERSION" version)
project(alibabacloud-oss-cpp-sdk VERSION ${version})
message(STATUS "Project version: ${PROJECT_VERSION}")
set(SDK_ROOT "${CMAKE_CURRENT_SOURCE_DIR}")
set(TARGET_OUTPUT_NAME_PREFIX "alibabacloud-oss-" CACHE STRING "The target's output name prefix")
#Options
option(BUILD_SHARED_LIBS "Enable shared library" OFF)
option(BUILD_SAMPLE "Build sample" ON)
option(BUILD_TESTS "Build unit and perfermence tests" OFF)
option(ENABLE_COVERAGE "Flag to enable/disable building code with -fprofile-arcs and -ftest-coverage. Gcc only" OFF)
option(ENABLE_RTTI "Flag to enable/disable building code with RTTI information" ON)
#Platform
if (CMAKE_CROSSCOMPILING)
if (${CMAKE_SYSTEM_NAME} STREQUAL "Android")
set(PLATFORM_ANDROID 1)
set(TARGET_OS "ANDROID")
else()
message(FATAL_ERROR "Do not support target platform")
endif()
else()
if(CMAKE_HOST_APPLE)
set(PLATFORM_APPLE 1)
set(TARGET_OS "APPLE")
elseif(CMAKE_HOST_UNIX)
set(PLATFORM_LINUX 1)
set(TARGET_OS "LINUX")
elseif(CMAKE_HOST_WIN32)
set(PLATFORM_WINDOWS 1)
set(TARGET_OS "WINDOWS")
else()
message(FATAL_ERROR "Do not support unknown host OS")
endif()
endif()
message(STATUS "TARGET_OS: ${TARGET_OS}")
add_definitions(-DPLATFORM_${TARGET_OS})
#Find dependency Library, curl, openssl
# if (${TARGET_OS} STREQUAL "WINDOWS")
# set(WLIB_TARGET "Win32")
# if (CMAKE_CL_64)
# set(WLIB_TARGET "x64")
# endif()
# set(CRYPTO_LIBS
# ${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/ssleay32.lib
# ${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/libeay32.lib)
# set(CRYPTO_INCLUDE_DIRS
# ${CMAKE_SOURCE_DIR}/third_party/include)
#
# set(CLIENT_LIBS
# ${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/libcurl.lib)
# set(CLIENT_INCLUDE_DIRS
# ${CMAKE_SOURCE_DIR}/third_party/include)
# else()
# include(FindCURL)
# include(FindOpenSSL)
#
# if(NOT CURL_FOUND)
# message(FATAL_ERROR "Could not find curl")
# endif()
#
# if(NOT OPENSSL_FOUND)
# message(FATAL_ERROR "Could not find openssl")
# endif()
#
# set(CRYPTO_LIBS ${OPENSSL_LIBRARIES})
# set(CRYPTO_INCLUDE_DIRS ${OPENSSL_INCLUDE_DIRS})
# set(CRYPTO_LIBS_ABSTRACT_NAME crypto ssl)
#
# set(CLIENT_LIBS ${CURL_LIBRARIES})
# set(CLIENT_INCLUDE_DIRS ${CURL_INCLUDE_DIRS})
# set(CLIENT_LIBS_ABSTRACT_NAME curl)
# endif()
# 默认使用win32编译
if (${TARGET_OS} STREQUAL "WINDOWS")
set(WLIB_TARGET "Win32")
set(CRYPTO_LIBS
${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/ssleay32.lib
${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/libeay32.lib)
set(CRYPTO_INCLUDE_DIRS
${CMAKE_SOURCE_DIR}/third_party/include)
set(CLIENT_LIBS
${CMAKE_SOURCE_DIR}/third_party/lib/${WLIB_TARGET}/libcurl.lib)
set(CLIENT_INCLUDE_DIRS
${CMAKE_SOURCE_DIR}/third_party/include)
else()
include(FindCURL)
include(FindOpenSSL)
if(NOT CURL_FOUND)
message(FATAL_ERROR "Could not find curl")
endif()
if(NOT OPENSSL_FOUND)
message(FATAL_ERROR "Could not find openssl")
endif()
set(CRYPTO_LIBS ${OPENSSL_LIBRARIES})
set(CRYPTO_INCLUDE_DIRS ${OPENSSL_INCLUDE_DIRS})
set(CRYPTO_LIBS_ABSTRACT_NAME crypto ssl)
set(CLIENT_LIBS ${CURL_LIBRARIES})
set(CLIENT_INCLUDE_DIRS ${CURL_INCLUDE_DIRS})
set(CLIENT_LIBS_ABSTRACT_NAME curl)
endif()
#Compiler flags
list(APPEND SDK_COMPILER_FLAGS "-std=c++11")
if(CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
list(APPEND SDK_COMPILER_FLAGS "/MP")
if (NOT ENABLE_RTTI)
list(APPEND SDK_COMPILER_FLAGS "/GR-")
endif()
elseif (CMAKE_CXX_COMPILER_ID MATCHES "Clang")
list(APPEND SDK_COMPILER_FLAGS "-fno-exceptions" "-fPIC" "-fno-rtti")
if (NOT ENABLE_RTTI)
list(APPEND SDK_COMPILER_FLAGS "-fno-rtti")
endif()
list(APPEND SDK_COMPILER_FLAGS "-Wall" "-Werror" "-pedantic" "-Wextra")
else()
list(APPEND SDK_COMPILER_FLAGS "-fno-exceptions" "-fPIC")
if (NOT ENABLE_RTTI)
list(APPEND SDK_COMPILER_FLAGS "-fno-rtti")
endif()
list(APPEND SDK_COMPILER_FLAGS "-Wall" "-Werror" "-pedantic" "-Wextra")
if (ENABLE_COVERAGE)
SET(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -fprofile-arcs -ftest-coverage")
SET(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -fprofile-arcs -ftest-coverage")
SET(CMAKE_EXE_linkER_FLAGS_DEBUG "${CMAKE_EXE_linkER_FLAGS_DEBUG} -fprofile-arcs -ftest-coverage")
endif()
endif()
if (BUILD_SHARED_LIBS)
set(STATIC_LIB_SUFFIX "-static")
else()
set(STATIC_LIB_SUFFIX "")
endif()
include(ExternalProject)
include(GNUInstallDirs)
add_subdirectory(sdk)
if(BUILD_SAMPLE)
add_subdirectory(sample)
endif()
if(BUILD_TESTS)
add_subdirectory(test)
add_subdirectory(ptest)
endif()
2.2 Cmake Gui 配置编译选项
2.3 通过VS打开.sln进行编译
经过上一步cmake 生成 .sln 的项目文件后,打开VS,笔者为VS2019。打开项目后做两次修改,编译版本为 Release Win32版本;其次【属性】->【代码生成】->【运行库】,笔者根据项目需求改为MT模式 (不需要的可以不做修改,看实际需求)
构建和编译项目,我们可以看到 aliyun-oss-cpp-sdk-master/x86build/lib/Release目录下成功生成 alibabacloud-oss-cpp-sdk.lib 插件
三、 编译选项补充说明您可以根据具体的业务场景,设置不同的编译选项,编译选项格式为cmake -D${OptionName}=ON|OFF …。
可选的编译选项请参见下表。
| 选项名称 | 描述 |
|---|---|
| BUILD_SHARED_LIBS | 构建动态库,默认值为OFF。打开此选项时,会同时构建静态库和动态库, 且静态库名字增加-static后缀。结合编译选项格式,如果要构建动态库,则使用cmake -DBUILD_SHARED_LIBS=ON …。 |
| ENABLE_RTTI | 支持的实时类型信息,默认值为ON。 |
| OSS_DISABLE_BUCKET | 不构建Bucket相关设置接口,默认值为OFF。如果需要裁剪代码大小,可将其置为ON。 |
| OSS_DISABLE_LIVECHANNEL | 不构建LiveChannel接口,默认值为OFF。如果需要裁剪代码大小,可将其置为ON。 |
| OSS_DISABLE_RESUAMABLE | 不构建断点续传接口,默认值为OFF。如果需要裁剪代码大小,可将其置为ON。 |
| OSS_DISABLE_ENCRYPTION | 不构建客户端加密接口,默认值为OFF。如果需要裁剪代码大小,可将其置为ON。 |
至此,OSS C++ SDK 的 x86/x64 MT版本编译完成。使用部分另开一篇再说明~



