lib/json
1
0
Fork 0
mirror of https://github.com/nlohmann/json.git synced 2025-07-28 12:02:00 +03:00
Code Activity

📝 document FetchContent

Browse Source
This commit is contained in:
Niels Lohmann
2022-01-30 13:05:18 +01:00
parent 4d4c273036
commit c11f98228d
2 changed files with 19 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
README.md
View File

@ -1185,15 +1185,15 @@ target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json)
Since CMake v3.11, Since CMake v3.11,
[FetchContent](https://cmake.org/cmake/help/v3.11/module/FetchContent.html) can [FetchContent](https://cmake.org/cmake/help/v3.11/module/FetchContent.html) can
be used to automatically download the repository as a dependency at configure time. be used to automatically download a release as a dependency at configure time.
Example: Example:
```cmake ```cmake
include(FetchContent) include(FetchContent)
FetchContent_Declare(json FetchContent_Declare(json
GIT_REPOSITORY https://github.com/nlohmann/json.git URL https://github.com/nlohmann/json/releases/download/v3.10.5/json.tar.xz
GIT_TAG v3.7.3) )
FetchContent_GetProperties(json) FetchContent_GetProperties(json)
if(NOT json_POPULATED) if(NOT json_POPULATED)
@ -1204,10 +1204,8 @@ endif()
target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json) target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json)
``` ```
**Note**: The repository https://github.com/nlohmann/json download size is huge. **Note**: It is recommended to use the URL approach described above which is supported as of version 3.10.0. See
It contains all the dataset used for the benchmarks. You might want to depend on <https://json.nlohmann.me/integration/cmake/#fetchcontent> for more information.
a smaller repository. For instance, you might want to replace the URL above by
https://github.com/ArthurSonzogni/nlohmann_json_cmake_fetchcontent
#### Supporting Both #### Supporting Both

19
doc/mkdocs/docs/integration/cmake.md
View File

@ -90,7 +90,7 @@ to the following.
### FetchContent ### FetchContent
Since CMake v3.11, [FetchContent](https://cmake.org/cmake/help/v3.11/module/FetchContent.html) can be used to Since CMake v3.11, [FetchContent](https://cmake.org/cmake/help/v3.11/module/FetchContent.html) can be used to
automatically download the repository as a dependency at configure type. automatically download a release as a dependency at configure type.
!!! example !!! example
@ -101,8 +101,7 @@ automatically download the repository as a dependency at configure type.
include(FetchContent) include(FetchContent)
FetchContent_Declare(json FetchContent_Declare(json
GIT_REPOSITORY https://github.com/nlohmann/json URL https://github.com/nlohmann/json/releases/download/v3.10.5/json.tar.xz
GIT_TAG v3.10.5
) )
FetchContent_GetProperties(json) FetchContent_GetProperties(json)
@ -117,8 +116,18 @@ automatically download the repository as a dependency at configure type.
!!! Note !!! Note
The repository <https://github.com/nlohmann/json> download size is quite large. You might want to depend on a It is recommended to use the URL approach described above which is supported as of version 3.10.0. It is also
smaller repository. For instance, you might want to replace the URL in the example by possible to pass the Git repository like
```cmake
FetchContent_Declare(json
GIT_REPOSITORY https://github.com/nlohmann/json
GIT_TAG v3.10.5
)
```
However, the repository <https://github.com/nlohmann/json> download size is quite large. You might want to depend on
a smaller repository. For instance, you might want to replace the URL in the example by
<https://github.com/ArthurSonzogni/nlohmann_json_cmake_fetchcontent>. <https://github.com/ArthurSonzogni/nlohmann_json_cmake_fetchcontent>.
## CMake Options ## CMake Options