There's a number of options to choice from.
It's strongly recommended to use a package manager, as JWT-CPP has dependencies for both cryptography and JSON libraries, having a tool to do the heavily lifting can be ideal. Examples of a C and C++ package manager are Conan and vcpkg. If the version is out of date please check with their respective communities before opening and issue here.
When manually adding this dependency, and the dependencies this has, check the GitHub Actions and Workflows for some inspiration about how to go about it.
- Conan: https://conan.io/center/recipes/jwt-cpp
- vcpkg: https://vcpkg.link/ports/jwt-cpp
- Nuget: https://www.nuget.org/packages/jwt-cpp/
- Hunter: https://hunter.readthedocs.io/en/latest/packages/pkg/jwt-cpp.html
- Spack: https://packages.spack.io/package.html?name=jwt-cpp
- Xrepo: https://xrepo.xmake.io/#/packages/linux?id=jwt-cpp-linux
Looking for ways to contribute? Help by adding JWT-CPP to your favorite package manager! Nixpkgs for example. Currently many are behind the latest.
Simply downloading the include/ directory is possible.
Make sure the jwt-cpp/ subdirectories is visible during compilation.
This does require correctly linking to OpenSSL or alternative cryptography library.
The minimum is jwt.h but you will need to add the defines:
In addition to providing your own JSON traits implementation, see traits.md for more information.
Using find_package is recommended. Step you environment by installing OpenSSL. Once complete, configure and install the jwt-cpp target using CMake.
A simple installation of JWT-CPP may look like
cmake .
cmake --build . # Make sure everything compiles and links together
cmake --install .Then from your own project
find_package(jwt-cpp CONFIG REQUIRED)
target_link_libraries(my_app PRIVATE jwt-cpp::jwt-cpp)There's also the possibility of using FetchContent in pull this this project to your build tree.
include(FetchContent)
fetchcontent_declare(jwt-cpp
GIT_REPOSITORY https://github.com/Thalhammer/jwt-cpp.git
GIT_TAG 08bcf77a687fb06e34138e9e9fa12a4ecbe12332 # v0.7.0 release
)
set(JWT_BUILD_EXAMPLES OFF CACHE BOOL "disable building examples" FORCE)
fetchcontent_makeavailable(jwt-cpp)
target_link_libraries(my_app PRIVATE jwt-cpp::jwt-cpp)Lastly, you can use add_subdirectory, this is untested but should work.