sentry-native库是sentry.io公司推出崩溃调试SDK库。本文记录在windows上编译sentry-native库的过程，并实现静态/动态/x86/x64/Debug/Release/RelWithDebInfo多模式编译。

如果不想自己编译，也可以借助vcpkg导入sentry-native库实现全自动编译。编译完成后去vcpkg的库文件夹里把crashpad_handler.exe复制到项目程序目录就可以了。

编译

首先去sentry-native库的release发布页面下载最新版本的sentry-native.zip。直接克隆库也可以。

下载好库以后，在库目录里新建批处理文件，保存为UTF8编码，内容如下：

@echo off
chcp 65001 > nul
setlocal enabledelayedexpansion
echo author: https://wkings.blog/archives/1721
rem SENTRY_BUILD_RUNTIMESTATIC 是否链接MSVC静态运行时 ON=链接静态运行时 OFF=链接动态运行时
set SENTRY_BUILD_RUNTIMESTATIC=OFF

@REM i=platform, j=configuration
for %%i in (Win32 x64) do (
    for %%j in (Debug Release RelWithDebInfo) do (
        rem k=BUILD_SHARED_LIBS ON=构建动态库 OFF=构建静态库
        for %%k in (ON OFF) do (
            if %%k==ON (set LIBS=Dynamic) else (set LIBS=Static)
            echo ===========================================================
            echo 平台=%%i 模式=%%j 动态链接库=%%k MSVC静态链接库=%SENTRY_BUILD_RUNTIMESTATIC% 构建目录=build/%%i_%%j_!LIBS!
            echo 配置项目
            cmake -B build/%%i_%%j_!LIBS! -A %%i -D BUILD_SHARED_LIBS=%%k -D SENTRY_BUILD_RUNTIMESTATIC=%SENTRY_BUILD_RUNTIMESTATIC% > nul
            echo 构建项目
            cmake --build build/%%i_%%j_!LIBS! --clean-first --parallel --config %%j > nul
            cmake --install build/%%i_%%j_!LIBS! --prefix install/%%i_%%j_!LIBS! --config %%j > nul
        )
    )
)

@echo off

chcp 65001 > nul

setlocal enabledelayedexpansion

echo author: https://wkings.blog/archives/1721

rem SENTRY_BUILD_RUNTIMESTATIC 是否链接MSVC静态运行时 ON=链接静态运行时 OFF=链接动态运行时

set SENTRY_BUILD_RUNTIMESTATIC=OFF

@REM i=platform, j=configuration

for %%i in (Win32 x64) do (

for %%j in (Debug Release RelWithDebInfo) do (

rem k=BUILD_SHARED_LIBS ON=构建动态库 OFF=构建静态库

for %%k in (ON OFF) do (

if %%k==ON (set LIBS=Dynamic) else (set LIBS=Static)

echo ===========================================================

echo 平台=%%i 模式=%%j 动态链接库=%%k MSVC静态链接库=%SENTRY_BUILD_RUNTIMESTATIC% 构建目录=build/%%i_%%j_!LIBS!

echo 配置项目

cmake -B build/%%i_%%j_!LIBS! -A %%i -D BUILD_SHARED_LIBS=%%k -D SENTRY_BUILD_RUNTIMESTATIC=%SENTRY_BUILD_RUNTIMESTATIC% > nul

echo 构建项目

cmake --build build/%%i_%%j_!LIBS! --clean-first --parallel --config %%j > nul

cmake --install build/%%i_%%j_!LIBS! --prefix install/%%i_%%j_!LIBS! --config %%j > nul

)

然后打开带有可执行cmake命令的命令行，切换到库所在目录，执行刚刚创建的批处理文件即可。

批处理执行完成后，会在库目录里新建build和install目录。build是构建配置目录，可以不管它。install目录是生成的要集成到你项目里的sentry SDK文件。

集成到自己的项目

本文参考官方文档。

集成代码很简单，从sentry库install目录里选择你想要的哪个版本的SDK

#include <sentry.h>

// windows平台上，需要链接sentry所需的库
#pragma comment(lib, "Version.lib")
#pragma comment(lib, "Winhttp.lib")
#pragma comment(lib, "Dbghelp.lib")

int main(void) {
  sentry_options_t *options = sentry_options_new();
  sentry_options_set_dsn(options, "https://524ce90a723cd308a13bb304864cf4bd@o4510951641317376.ingest.us.sentry.io/4511054406090752");
  // This is also the default-path. For further information and recommendations:
  // https://docs.sentry.io/platforms/native/configuration/options/#database-path
  sentry_options_set_database_path(options, ".sentry-native");
  sentry_options_set_release(options, "my-project-name@2.3.12");
  sentry_options_set_debug(options, 1);
  sentry_init(options);

  /* ... */

  // make sure everything flushes
  sentry_close();
}