ONVIF协议网络摄像机(IPC)客户端程序开发使用ONVIF框架代码(C++)生成静态库04--＞Windows

一前提

先说一下，为什么不像前面Linux生成动态库那样去开发Onvif。因为Onvif的源码是没有那些＿_declspec（dlleXPort）指令，所以当你导出dll时，你会发现没有xxx.lib文件产生，在windows下你就没办法隐式调用dll了，除非你显示调用dll，即在程序中使用LoadLibrary()一个一个将要用到的函数加载进来，那么就会非常麻烦。

所以我们在windows下选择生成静态库去开发是比较好的选择。
注：生成dll有两种方法，一种是使用＿_declspec（dlleXPort）指令；另一种是使用DEF文件，可能这种方法方便，但是本人还没尝试过，有兴趣的可以试着这个思路去实现。

这里还是要提一点，为啥onvif开发要生成库比较好，因为使用gsoap生成的onvif源码是非常大的，如果不生成库，那么你每次更改自己的代码，即使onvif的源码没改变，每次编译都要4-8分钟，所以是非常浪费时间的，所以需要生成库进行开发。除非你不使用gsoap，而是自己实现onvif的客户端，那么就不需要关心是否生成库。

好了，我们确定了在windows要使用静态库开发，那么就开始撸。

二编写cmake文件

为什么要使用cmake文件进行编译onvif源码生成静态库呢，因为cmake跨平台，方便Linux和Windows，在Linux下它会直接生成.a文件，在Windows下，它会先生成VS的项目，然后再由用户打开该VS项目进行生成静态库。

1）首先创建一个CMake_Onvif根目录，用于存放相关内容。
2）然后将上一篇我们使用gsoap生成的onvif源码拷贝到这里，即ONVIFAPI里面的内容。
3）因为onvif依赖openssl库，所以我们需要下载一个openssl。
注意，openssl的版本与onvif的版本可能不一定兼容，我的openssl版本是"OpenSSL 1.1.1h 22 Sep 2020"，onvif版本是gsoap_2.8.109.zip，这两个是没问题的。
后面当我使用新版本的gsoap_2.8.122.zip，配合"OpenSSL 1.1.1h 22 Sep 2020"，发现会报X509参数错误(反正一大堆错误)，看了一下是本应传回调函数的，但是实际上传了一个void*类型的成员参数，所以需要注意版本问题，建议如果你想用最新版的onvif，那么应该去openssl官网下载最新版本的openssl。这样能减少错误。

在这里插入图片描述

查看openssl的方法：

1）若有执行文件，则执行：openssl version。
2）若找不到执行文件，则去头文件的opensslv.h中找：
4）先创建一个build目录。待会用来存放执行cmake文件产生的临时文件。
5）创建一个名字为CMakeLists.txt的文件。添加以下内容：

重点讲一下下面比较重要的内容。
set(BUILD_USE_64BITS on)是用于开启64位静态库的编译；
“/bigobj”选项是因为onvif源码很大，不加的话会导致编译报错。cmake不加这个参数，可以直接在VS的：”属性->C/C++/命令行”加上也行。

cmake_minimum_required(VERSION 2.6)

project(ONVIF)
#打印
message(STATUS "binary dir: " ${PROJECT_BINARY_DIR})
message(STATUS "source dir: " ${PROJECT_SOURCE_DIR})

if (CMAKE_HOST_WIN32)
    set(WINDOWS 1)
elseif (CMAKE_HOST_APPLE)
    set(MACOS 1)
elseif (CMAKE_HOST_UNIX)
    set(LINUX 1)
endif ()

if(WINDOWS)
    message( "WINDOWS Platform......" )
    set(BUILD_USE_64BITS on)
    add_definitions(-DWITH_OPENSSL -DWITH_NONAMESPACES)
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /bigobj")
    #在Windows下，这样添加CMake参数，会被添加到C/C++的+选项的命令行当中，导致添加动态库错误
    #set(CMAKE_CXX_FLAGS_DEBUG "$ENV{CXXFLAGS} -O0 -g -ggdb -w -Wall -std=c++11 -fPIC -lssl -lcrypto")
elseif(LINUX)
    message( "LINUX Platform......" )
    set(CMAKE_CXX_FLAGS_DEBUG "$ENV{CXXFLAGS} -O0 -g -ggdb -w -Wall -std=c++11 -fPIC -lpthread -lssl -lcrypto -DWITH_OPENSSL -DWITH_NONAMESPACES ")
else()
    message( "MACOS Platform......" )
endif()

# 查找当前目录下的所有源文件，并将名称保存到 DIR_SRCS 变量
aux_source_directory(./ONVIFAPI/ DIR_SRCS)
set(CMAKE_BUILD_TYPE Debug)

#OPENSSL,尽量不要写当前路径，否则可以会报找不到动态库。
include_directories(${PROJECT_SOURCE_DIR}/openssl/include)
link_directories(${PROJECT_SOURCE_DIR}/openssl/lib)


# 生成链接库
#add_library(Onvif_Client SHARED ${DIR_SRCS})
add_library(Onvif_Client STATIC ${DIR_SRCS})

三执行cmake文件

首先因为cmake是依赖VS这个软件去编译的，所以我们需要提前下载VS，我的是VS2015。然后我们可以查看当前cmake版本支持的编译器，执行：

cmake -G

在这里插入图片描述
图中看到，支持VS2017及以下的版本，因为我的是VS2015，所以执行命令：

cd build
# ..代表CMakeLists所在目录
cmake -G "Visual Studio 14 2015 Win64" ..

注意，若不加-G选项，cmake很可恶的，因为即使你在CMakeLists文件中加上set(BUILD_USE_64BITS on)设置了64位，但是它还是给你生成32bit的VS程序，即使你在VS将Win32平台改成x64，它还是不行，它会报错：fatal error LNK1112: 模块计算机类型“x64”与目标计算机类型“X86”冲突。

所以在执行cmake时，必须加上-G选项，表示我们要生成的是Win64位的VS项目。

四运行生成的VS项目

通过上面后，在build目录下会生成一个VS项目，我们打开后缀为sln的VS项目。
在这里插入图片描述
然后右击ALL_BUILD，选择配置管理器，把生成的那一列全部勾上，不然待会会有个小报错，虽然不影响静态库的生成，但是总是不好看嘛。

在这里插入图片描述

然后执行程序即可。
我们会在Debug(你选择Release的话就是Release目录)目录下看的对应的静态库生成。
在这里插入图片描述

五使用静态库

既然静态库生成了，那么肯定就是使用它呗。测试代码，以获取IPC的能力集为例子：

1）新建Win32控制台项目，我的名字是TestOnvif，然后空项目即可。
2）添加main.cpp文件。
3）把相关库引入进来，用到的库就是上面编译生成的静态库，以及openssl库。那么将onvif静态库、openssl动态库的include、lib路径引入到VS项目中即可。openssl的dll我没放到生成的执行程序也能运行，那么这里就不管它了。

main.cpp的内容：

#include <iostream>

#include "soapH.h"
#include "soapStub.h"
#include "wsseapi.h"
#include "smdevp.h"
#include "wsaapi.h"
#include "mecevp.h"

int main() {
    
    

	printf("nihao\n");

	struct soap *soap = NULL;                                                   // soap环境变量

	
	if (NULL == (soap = soap_new())) {
    
    
		printf("nihao111\n");
		return -1;
	}
	printf("nihao222\n");

	soap_set_namespaces(soap, namespaces);                                      // 设置soap的namespaces
	soap->recv_timeout = 3;                                            			// 设置超时（超过指定时间没有数据就退出）
	soap->send_timeout = 3;
	soap->connect_timeout = 3;

#if defined(__linux__) || defined(__linux)                                      // 参考https://www.genivia.com/dev.html#client-c的修改：
	soap->socket_flags = MSG_NOSIGNAL;                                          // To prevent connection reset errors
#endif

	soap_set_mode(soap, SOAP_C_UTFSTRING);                                      // 设置为UTF-8编码，否则叠加中文OSD会乱码

	int result;

	struct _tds__GetCapabilities            req;
	struct _tds__GetCapabilitiesResponse    rep;

	result = soap_call___tds__GetCapabilities(soap, "http://192.168.1.186/onvif/device_service", NULL, &req, rep);// PRE_AUTH
	if (SOAP_OK != result) {
    
    
		const char **s = NULL;
		return -1;
	}

	if (rep.Capabilities->Media != NULL)
	{
    
    

		printf("-------------------Media-------------------\n");
		printf("XAddr:%s\n", rep.Capabilities->Media->XAddr.c_str());
		printf("-------------------streaming-------------------\n");
		printf("RTPMulticast:%s\n", (rep.Capabilities->Media->StreamingCapabilities->RTPMulticast) ? "Y" : "N");
		printf("RTP_TCP:%s\n", (rep.Capabilities->Media->StreamingCapabilities->RTP_USCORETCP) ? "Y" : "N");
		printf("RTP_RTSP_TCP:%s\n", (rep.Capabilities->Media->StreamingCapabilities->RTP_USCORERTSP_USCORETCP) ? "Y" : "N");
	}

	if (rep.Capabilities->PTZ != NULL)
	{
    
    
		printf("-------------------PTZ-------------------\n");
		printf("XAddr:%s\n", rep.Capabilities->PTZ->XAddr.c_str());
	}

	Sleep(3);
	return 0;
}

然后看到，相关能力集是能拿到的，且程序编译就10秒左右，完全没问题，可以达到开发的目的，所以windows下使用静态库开发onvif是没问题的。
在这里插入图片描述