83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
|
|
## Abseil CMake build instructions
|
|
|
|
|
|
### Recommended usage : incorporate Abseil into an CMake project
|
|
|
|
For API / ABI compatibility reasons, it is recommended to build
|
|
and use abseil in a subdirectory of your project or as an embedded
|
|
dependency
|
|
|
|
This is similar to the recommended usage of the googletest framework
|
|
( https://github.com/google/googletest/blob/master/googletest/README.md )
|
|
|
|
Build and use step-by-step
|
|
|
|
|
|
1- Download abseil and copy it in a sub-directory in your project.
|
|
or add abseil as a git-submodule in your project
|
|
|
|
2- If not done yet, download and copy in your project the two dependencies of
|
|
abseil `cctz` and `googletest`
|
|
|
|
* cctz https://github.com/google/cctz
|
|
* googletest https://github.com/google/googletest
|
|
|
|
3- You can then use the cmake command `add_subdirectory()` to include
|
|
abseil directly and use the abseil targets in your project.
|
|
|
|
Note: Abseil requires CCTZ and the googletest framework. Consequently,
|
|
the targets `gtest`, `gtest_main`, `gmock` and `cctz` need
|
|
to be declared in your project before including abseil with `add_subdirectory`.
|
|
|
|
|
|
4- Add the absl:: target you wish to use to the `target_link_libraries()`
|
|
section of your executable or of your library
|
|
|
|
|
|
Here is a short CMakeLists.txt example of a possible project file
|
|
using abseil
|
|
|
|
cmake_minimum_required(VERSION 2.8.12)
|
|
project(my_project)
|
|
|
|
set(CMAKE_CXX_FLAGS "-std=c++11 -stdlib=libc++ ${CMAKE_CXX_FLAGS}")
|
|
|
|
if (MSVC)
|
|
# /wd4005 macro-redefinition
|
|
# /wd4068 unknown pragma
|
|
# /wd4244 conversion from 'type1' to 'type2'
|
|
# /wd4267 conversion from 'size_t' to 'type2'
|
|
# /wd4800 force value to bool 'true' or 'false' (performance warning)
|
|
add_compile_options(/wd4005 /wd4068 /wd4244 /wd4267 /wd4800)
|
|
add_definitions(/DNOMINMAX /DWIN32_LEAN_AND_MEAN=1 /D_CRT_SECURE_NO_WARNINGS)
|
|
endif()
|
|
|
|
add_subdirectory(googletest)
|
|
add_subdirectory(cctz)
|
|
add_subdirectory(abseil-cpp)
|
|
|
|
add_executable(my_exe source.cpp)
|
|
target_link_libraries(my_exe absl::base absl::synchronization absl::strings)
|
|
|
|
|
|
As of this writing, that pull request requires -DBUILD_TESTING=OFF as it doesn't correctly export cctz's dependency on Google Benchmark.
|
|
|
|
You will find here a non exhaustive list of absl public targets
|
|
|
|
absl::base
|
|
absl::algorithm
|
|
absl::container
|
|
absl::debugging
|
|
absl::memory
|
|
absl::meta
|
|
absl::numeric
|
|
absl::strings
|
|
absl::synchronization
|
|
absl::time
|
|
absl::utility
|
|
|
|
|
|
|
|
|
|
|