Question 1

How do I install a CMake library without sudo or root access?

Accepted Answer

Use CMake's User Package Registry by building with -DCMAKE_EXPORT_PACKAGE_REGISTRY. This registers the build in ~/.cmake on UNIX systems, allowing other projects to find it via find_package without system installation, ideal for development environments.

Question 2

Why is my find_package not finding a library installed in a custom path?

Accepted Answer

You need to set the JSONUtils_DIR variable to the custom installation directory's lib/cmake/JSONUtils subfolder when configuring the dependent project. This points CMake to the correct location, as explained in the building executable section.

Question 3

Modern CMake targets vs old CMake variables - which should I use?

Accepted Answer

Modern CMake targets are preferred for better dependency scoping and portability. They avoid global variable pollution, reduce side effects, and make builds more maintainable, as illustrated in this sample project compared to legacy patterns.

Question 4

How to set up CMake User Package Registry for local development?

Accepted Answer

Build your library with the flag -DCMAKE_EXPORT_PACKAGE_REGISTRY during configuration. This automatically registers it in the user registry, so dependent projects can find it without manual path setting, streamlining workflow as shown in the README.

Question 5

Can I use this sample for Windows or cross-platform CMake projects?

Accepted Answer

While it demonstrates modern CMake principles that are cross-platform, the installation and registry examples are UNIX-centric. You may need to adapt paths and commands for Windows or other systems, as it lacks specific guidance.

Question 6

What are the best practices for adding tests in a CMake project like this?

Accepted Answer

Integrate tests using CMake's built-in testing framework by defining test targets in your CMakeLists.txt. This sample shows how to run tests with 'cmake --build build -- test', but for complex setups, you might need to explore frameworks like Google Test.

modern-cmake-sample

What is modern-cmake-sample?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions