Skip to content

xianglin1998/breakpad_cmake

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

为什么要用CMAKE?

  1. breakpad从2018年提交了一个commit之后,就没办法用gyp生成VS的sln项目进行编译输出lib了,现在只能用mingw进行./configure & make,生成的库只有libbreakpad.a
  2. 折腾了两天,最初以为mingw输出的.a库和VS的cmake + msvc的工程依赖的.lib库是同一个东西,但是链接的时候始终是缺少某些资源,查资料且看编译过程,发现msvc和mingw使用的gcc其实是两种编译器了,跨编译器的库依赖非常复杂而且可能有隐藏问题,于是放弃研究.a转.lib,开始研究CMAKE编译breakpad

为什么一定要用CMAKE且编译出来.lib?

  1. 已经成型的项目是cmake管理的,开发团队统一使用VS + CMAKE进行项目开发,没精力移植到mingw端再去写makefile
  2. 跨平台的项目,在windows端已经有其他的依赖库是.lib的,比如pthread,不方便更换。

一定要用CMAKE吗?

  1. 不一定,对于Linux平台开发来说,项目最终编译和运行的环境就是Linux,比如Debian或者Ubuntu,Linux平台测试和生产环境都可以考虑安装libbreakpad的prebuild库或者手动编译,libbreakpad安装好了之后,我们依赖breakpad的库就行了,就算是VS的remote debug都不影响使用。
  2. 我们最终的目的就是编译breakpad,将其编译为static或者shared库,在Windows上进行开发需要msvc且依赖.lib的,可以考虑使用此cmake编译,而linux直接用./configure & make无脑编译就好了,mac端更是有自带xcode的工程,没必要cmake。浪费时间就是浪费生命。

还有一些注意事项

  1. breakpad官方设计dump文件格式的时候,为了统一,决策后采用了Microsoft的minidump格式。
  2. 根据官方文档描述breakpad的架构就是:
    • client,也就是libbreakpad.a(.lib),运行在我们最终的.exe可执行程序上的,用于注册监听crash事件,发生crash事件后将当前堆栈信息进行记录为minidump文件。
    • dumper,也就是把可执行程序的debug信息提取出来成为breakpad规范的可识别symbol文件,这个symbol文件是后面定位问题能到某一行代码上的关键。
    • processor,在client崩溃后得到输出的 'guid.dmp' 堆栈信息文件,processor加载.dmp和dumper导出的symbol文件,就可以debug到出问题的代码行。包括汇编信息那些。
  3. 上面描述的架构是linux和mac上用的,因此编译最好是用breakpad官方提供的编译脚本或者工程,他们会管理好所有的依赖,最终生成libbreakpad.a(client),dump_syms.exe(dumper),minidump_stackwalk.exe(processor),但是windows上用vs+cmake开发,我们不需client之外的东西,因为VS原生支持.dmp文件的解析,双击.dmp文件打开VS面板,然后symbol文件选择你输出的exe编译时输出的.pdb,就能直接解析到问题点了。
  4. c++?,还是算了吧,我现在维护的一个工程是98%血统的C工程,所以 c_wapper 存在的意义就是把breakpad的初始化注册的c++流程用c包装一遍,所以如果你遇到在C项目上使用breakpad的需求,可以参考一下 c_wapper 目录下的写法

最后再说一下,目前的仓库只提供编译Windows端的msvc库文件的能力,有其他的需要的直接忽略本仓库,去breakpad官方仓库阅读文档编译吧。

About

Using cmake to compile breakpad

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published