调试和步进依赖项

有时,在开发和调试自己的代码时,能够步进到依赖项的源代码中可能会很有用。有几点需要考虑:

  • 来自 ConanCenter 的配方和包并非总是打包所有必要的调试工件。例如在 Windows 中,*.pdb 文件不被打包,因为它们非常大,并且在实践中很少使用。如果您愿意,可以制作自己的包来打包 PDB 文件,但这仍然不能解决下一个问题。

  • 调试工件通常不可重定位,这意味着此类工件只能在其源构建位置使用。但上传到服务器并下载到不同机器的包可以将这些工件放在不同的文件夹中。这样,调试工件可能无法正确地定位源代码、符号等。

从源代码构建

调试依赖项的推荐方法是在本地缓存中从源代码构建它们。这种方法对于大多数配方,包括 ConanCenter 配方,都应该开箱即用。

我们可以重用教程中第一个示例的代码来实现此用例。请首先克隆源代码以重新创建此项目。您可以在 GitHub 的 examples2 仓库中找到它们。

$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/tutorial/consuming_packages/simple_cmake_project

然后,我们确保依赖项是从源代码构建的

$ conan install . -s build_type=Debug --build="zlib/*"
...
Install finished successfully

假设我们有 CMake>=3.23,我们可以使用预设(否则,请使用 -DCMAKE_TOOLCHAIN_FILE 参数)

$ cmake . --preset conan-default

这将创建我们的项目,我们可以开始构建和调试。

使用 Visual Studio 步进到依赖项

项目创建后,在 Visual Studio 中,我们可以双击 compressor.sln 文件,或者从已打开的 Visual Studio IDE 中打开该文件。

项目打开后,第一步是构建它,确保 Debug 配置是活动配置,通过导航到 Build -> Build Solution 即可完成。然后我们可以在项目视图中将 compressor 定义为“启动项目”。

进入 compressor/main.c 源文件,我们可以在其中某行设置一个断点

main.c
int main(void) {
    ...

    // add a breakpoint in deflateInit line in your IDE
    deflateInit(&defstream, Z_BEST_COMPRESSION);
    deflate(&defstream, Z_FINISH);

点击 Debug -> Start Debugging(或 F5),程序将开始调试并在 deflateInit() 行停止。点击 Debug -> Step Into,IDE 应该能够导航到 deflate.c 源代码。如果我们检查此文件,其路径将在 Conan 缓存中,例如 C:\Users\<myuser>\.conan2\p\b\zlib4f7275ba0a71f\b\src\deflate.c

deflate.c
int ZEXPORT deflateInit_(strm, level, version, stream_size)
 z_streamp strm;
 int level;
 const char *version;
 int stream_size;
 {
     return deflateInit2_(strm, level, Z_DEFLATED, MAX_WBITS, DEF_MEM_LEVEL,
                         Z_DEFAULT_STRATEGY, version, stream_size);
     /* To do: ignore strm->next_in if we use it as window */
 }

另请参阅

  • 使用此方法无法在调试时修改依赖项的源代码。如果这是预期的流程,推荐的方法是使用可编辑包