SumatraPDF is a multi-format (PDF, EPUB, MOBI, FB2, CHM, XPS, DjVu) reader for Windows under (A)GPLv3 license, with some code under BSD license (see AUTHORS).
More information:
- main website with downloads and documentation
- manual
- all other docs
To compile you need Visual Studio 2019 16.6 or later. Free Community edition works.
Open vs2019/SumatraPDF.sln
and hit F5 to compile and run.
For best results use the latest release available as that's what I use and test with. If things don't compile, first make sure you're using the latest version of Visual Studio.
Notes on targets:
x32_asan
target is for enabling address sanitizer, only works in 32-bit Release build and requires installing an optional "C++ AddressSanitizers" component
Docs:
- https://devblogs.microsoft.com/cppblog/asan-for-windows-x64-and-debug-build-support/
- https://devblogs.microsoft.com/cppblog/addresssanitizer-asan-for-windows-with-msvc/
Flags:
- https://github.com/google/sanitizers/wiki/SanitizerCommonFlags
- https://github.com/google/sanitizers/wiki/AddressSanitizerFlags
Can be set with env variable:
ASAN_OPTIONS=halt_on_error=0:allocator_may_return_null=1:verbosity=2:check_malloc_usable_size=false:print_suppressions=true:suppressions="C:\Users\kjk\src\sumatrapdf\asan.supp"
In Visual Studio, this is in Debugging
, Environment
section.
Note:
- as of VS 16.6.2
ASAN_OPTIONS=detect_leaks=1
(i.e. memory leaks) doesn't work. Unix version relies on tcmalloc so this might never work
Supressing issues: https://clang.llvm.org/docs/AddressSanitizer.html#issue-suppression Note: I couldn't get supressing to work.