使用vcpkg自动链接tinyxml2时莫名链接其他库（例如boost）

news/2024/12/2 9:56:38/

cle class="baidu_pl">

cle_content" class="article_content clearfix">

content_views" class="markdown_views prism-atom-one-light">

cpkgtinyxml2boost_0">使用vcpkg自动链接tinyxml2时莫名链接其他库（例如boost）

<code>vcpkgcode>的自动链接功能非常方便࿰c;但在某些情况下会出现过度链接的问题。

链接错误症状

以<code>tinyxml2code>为例࿰c;程序中调用<code>tinyxml2code>的函数后࿰c;若vcpkg中同时存在<code>opencvcode>和<code>boostcode>库࿰c;自动链接会把本不需要的这两个库的lib也链接上࿰c;导致最后生成的可执行程序exe也依赖<code>opencvcode>和<code>boostcode>的动态库dll。

主程序：

<code class="prism language-cpp">class="token macro property">class="token directive-hash">#class="token directive keyword">include class="token string"><iostream>
class="token macro property">class="token directive-hash">#class="token directive keyword">include class="token string"><tinyxml2.h>class="token keyword">int class="token function">mainclass="token punctuation">(class="token punctuation">)
class="token punctuation">{tinyxml2class="token double-colon punctuation">::XMLDocument docclass="token punctuation">;stdclass="token double-colon punctuation">::cout class="token operator"><< class="token string">"Hello World!\n"class="token punctuation">; class="token keyword">return class="token number">0class="token punctuation">;
class="token punctuation">}
code>

错误链接boost后࿰c;由于boost某些头文件还包含了BOOST_DLLEXPORT（也就是__declspec(dllexport)）字段࿰c;会导致生成.exe的同时还生成.lib和.exp文件࿰c;非常烦人：

c="https://i-blog.csdnimg.cn/direct/e5bf6ed3f35943f0836180a728c58866.png#pic_center" alt="在这里插入图片描述" />

链接错误原理

<code>vcpkgcode>的自动链接功能是通过遍历所有的<code>.libcode>文件实现的࿰c;为程序引用的符号找到对应依赖库。
上述错误是由于<code>tinyxml2code>引用的某些函数所引用的函数在其他<code>.libcode>中首先被找到——即tinyxml2引用的某些函数同时在opencv和boost库中也有定义࿰c;遍历时后者的.lib先于tinyxml2.lib被找到࿰c;从而导致链接了opencv和boost的.lib文件而未链接tinyxml2.lib࿰c;进而仅拷贝了opencv和boost的动态库。

解决方法

对症下药࿰c;提供两种方法避免链接错误。

方法一：不关闭自动链接功能࿰c;在<code>链接器-输入code>中指定<code>tinyxml2.libcode>。<code>链接器-输入code>指定的库链接优先级高于vcpkg的自动链接࿰c;因此链接器首先从tinyxml2.lib中找到了所需函数后࿰c;就终止遍历、不再搜索boost或opencv等vcpkg环境中其他lib里的函数表࿰c;最后只链接tinyxml2.lib。

方法二：关闭自动链接功能࿰c;在<code>链接器-输入code>中指定所依赖库的.lib文件。推荐在方法一不奏效时使用。

cpkg_34">vcpkg自动链接功能

<code>vcpkgcode>是一个跨平台的c++库工具链࿰c;提供了c++库的编译、安装和配置等功能࿰c;可以与MSBuild（VS）、CMake等工具集成使用࿰c;非常方便。
以VS为例࿰c;vcpkg在项目属性中提供了一系列的功能开关࿰c;以使用户更方便地使用库：
c="https://i-blog.csdnimg.cn/direct/f9a13710f4da4d5a90ff6929fb0f699b.png#pic_center" alt="在这里插入图片描述" />
其中的开关顾名思义࿰c;例如“Use Vcpkg”即控制是否在当前项目中使用Vcpkg；“Use AutoLink”控制是否自动链接项目所需.lib库而不需要手动在<code>链接器-输入code>中指定。这两个开关默认都是开启状态。

自动链接功能在项目需要依赖包含多个.lib的库时特别有用࿰c;例如点云处理算法库pcl。
<code>pclcode>在编译时就需要依赖Boost、Eigen、Vtk等库࿰c;编译完成后生成一大堆.lib和.dll。
c="https://i-blog.csdnimg.cn/direct/3899b92aeede41b0a9e87ff5fbf5ba06.png#pic_center" alt="在这里插入图片描述" />