tvl-depot/CMake/README.md
Abseil Team 075cf62092 Changes imported from Abseil "staging" branch:
- c3a608de577e0c278b50916ad4803549929f8f72 Merging https://github.com/abseil/abseil-cpp/pull/8/ inte... by Gennadiy Civil <misterg@google.com>
  - d0b528cdf5843db871784c629cb4e7c5165af716 explicitly cast -1 for Span::npos by Jon Cohen <cohenjon@google.com>
  - 32066311a4379f1144f029aaa3740af59b1e364e Remove GUARDED_VAR and PT_GUARDED_VAR entirely. by Abseil Team <absl-team@google.com>
  - 3d3c69d97d15b5c6457906631054109094c083a6 Remove unneeded inline on constexpr definitions. by Alex Strelnikov <strel@google.com>
  - a9a8fe71f90d0b80de8e77375228a7185032636b Remove unneeded lint suppression. by Alex Strelnikov <strel@google.com>

GitOrigin-RevId: c3a608de577e0c278b50916ad4803549929f8f72
Change-Id: I0897ce0b11e41f83fed8d88f18e079a15d086527
2017-11-06 15:58:57 -05:00

2.2 KiB

Abseil CMake build instructions

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}")

  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)

You will need to create your own CMake files for cctz until https://github.com/google/cctz/pull/54 lands. 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