Search icon CANCEL
Arrow left icon
Explore Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Conferences
Free Learning
Arrow right icon
Modern CMake for C++
Modern CMake for C++

Modern CMake for C++: Effortlessly build cutting-edge C++ code and deliver high-quality solutions , Second Edition

eBook
$27.98 $39.99
Paperback
$34.98 $49.99
Subscription
Free Trial
Renews at $19.99p/m

What do you get with eBook?

Product feature icon Instant access to your Digital eBook purchase
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
Product feature icon AI Assistant (beta) to help accelerate your learning
Table of content icon View table of contents Preview book icon Preview Book

Modern CMake for C++

The CMake Language

Writing in the CMake language is trickier than one might expect. When you read a CMake listfile for the first time, you may be under the impression that the language in it is so simple that it can be just practiced without any theory. You may then attempt to introduce changes and experiment with the code without a thorough understanding of how it actually works. I wouldn’t blame you. We programmers are usually very busy, and build-related issues aren’t usually something that sounds exciting to invest lots of time in. In an effort to go fast, we tend to make gut-based changes hoping they just might do the trick. This approach to solving technical problems is called voodoo programming.

The CMake language appears trivial: after introducing our small extension, fix, hack, or one-liner, we suddenly realize that something isn’t working. Usually, the duration spent on debugging exceeds the time required for comprehending the topic itself. Luckily...

Technical requirements

You can find the code files that are present in this chapter on GitHub at https://github.com/PacktPublishing/Modern-CMake-for-Cpp-2E/tree/main/examples/ch02.

To build the examples provided in this book, always use the recommended commands:

cmake -B <build tree> -S <source tree>
cmake --build <build tree>

Be sure to replace the placeholders <build tree> and <source tree> with appropriate paths. As a reminder: build tree is the path to the target/output directory and source tree is the path at which your source code is located.

The basics of the CMake language syntax

Composing CMake code is very much like writing in any other imperative language: lines are executed from top to bottom and from left to right, occasionally stepping into an included file or a called function. The starting point of execution is determined by the mode (see the Mastering the command line section in Chapter 1, First Steps with CMake), either from the root file of the source tree (CMakeLists.txt) or a .cmake script file provided as an argument to cmake.

Since CMake scripts offer extensive support for the CMake language, except for project-related features, we will utilize them to practice CMake syntax in this chapter. Once we become proficient in composing simple listfiles, we can advance to creating actual project files, which we will cover in Chapter 4, Setting Up Your First CMake Project.

As a reminder, scripts can be run with the following command: cmake -P script.cmake.

CMake supports 7-bit ASCII text files...

Working with variables

Variables in CMake are a surprisingly complex subject. Not only are there three categories of variables – normal, cache, and environment – but they also reside in different variable scopes, with specific rules on how one scope affects the other. Very often, a poor understanding of these rules becomes a source of bugs and headaches. I recommend you study this section with care and make sure you understand all of the concepts before moving on.

Let’s start with some key facts about variables in CMake:

  • Variable names are case-sensitive and can include almost any character.
  • All variables are stored internally as strings, even if some commands can interpret them as values of other data types (even lists!).

The basic variable manipulation commands are set() and unset(), but there are other commands that can alter variable values, such as string() and list().

To declare a normal variable, we simply call set(), providing...

Using lists

To store a list, CMake concatenates all elements into a string, using a semicolon, ;, as a delimiter: a;list;of;5;elements. You can escape a semicolon in an element with a backslash, like so: a\;single\;element.

To create a list, we can use the set() command:

set(myList a list of five elements)

Because of how lists are stored, the following commands will have exactly the same effect:

set(myList "a;list;of;five;elements")
set(myList a list "of;five;elements")

CMake automatically unpacks lists in unquoted arguments. By passing an unquoted myList reference, we effectively send more arguments to the command:

message("the list is:" ${myList})

The message() command will receive six arguments: “the list is:", “a", “list", “of", “five", and “elements". This may have unintended consequences, as the output will be printed without any additional spaces...

Understanding control structures in CMake

The CMake language wouldn’t be complete without control structures! Like everything else, they are provided in the form of a command, and they come in three categories: conditional blocks, loops, and command definitions. Control structures are executed in scripts and during buildsystem generation for projects.

Conditional blocks

The only conditional block supported in CMake is the humble if() command. All conditional blocks have to be closed with an endif() command, and they may have any number of elseif() commands and one optional else() command in this order:

if(<condition>)
  <commands>
elseif(<condition>) # optional block, can be repeated
  <commands>
else()              # optional block
  <commands>
endif()

As in many other imperative languages, the if()-endif() block controls which sets of commands will be executed:

  • If the <condition> expression specified in the if...

Exploring the frequently used commands

CMake offers many scripting commands that allow you to work with variables and the environment. Some of them have been extensively covered in the Appendix: for example, list(), string(), and file(). Others, such as find_file(), find_package(), and find_path(), fit better in chapters that talk about their respective subjects. In this section, we will provide a brief overview of the common commands that are useful in most situations:

  • message()
  • include()
  • include_guard()
  • file()
  • execute_process()

Let’s get to it.

The message() command

We already know and love our trusty message() command, which prints text to standard output. However, there’s a lot more to it than meets the eye. By providing a MODE argument, you can customize the behavior of the command like so: message(<MODE> "text to print").

The recognized modes are as follows:

  • FATAL_ERROR: This stops...

Summary

This chapter opened the door to actual programming with CMake – you’re now able to write great, informative comments and utilize built-in commands, and you understand how to correctly provide all kinds of arguments to them. This knowledge alone will help you understand the unusual syntax of CMake listfiles that you might have seen in projects created by others. We have covered variables in CMake – specifically, how to reference, set, and unset normal, cache, and environment variables. We delved into how file and directory variable scopes work, how to create them, and what issues we might encounter and how to solve them. We also covered lists and control structures. We examined the syntax of conditions, their logical operations, the evaluation of unquoted arguments, as well as strings and variables. We learned how to compare values, do simple checks, and examine the state of the files in the system. This allows us to write conditional blocks and while loops...

Further reading

For more information on the topics covered in this chapter, you can refer to the following links:

Join our community on Discord

Join our community’s Discord space for discussions with the author and other readers:

https://discord.com/invite/vXN53A7ZcA

Left arrow icon Right arrow icon
Download code icon Download Code

Key benefits

  • Get to grips with CMake and take your C++ development skills to enterprise standards
  • Use hands-on exercises and self-assessment questions to lock-in your learning
  • Understand how to build in an array of quality checks and tests for robust code

Description

Modern CMake for C++ isn't just another reference book, or a repackaging of the documentation, but a blueprint to bridging the gap between learning C++ and being able to use it in a professional setting. It's an end-to-end guide to the automation of complex tasks, including building, testing, and packaging software. This second edition is significantly rewritten, restructured and refreshed with latest additions to CMake, such as support of C++20 Modules. In this book, you'll not only learn how to use the CMake language in CMake projects but also discover how to make those projects maintainable, elegant, and clean. As you progress, you'll dive into the structure of source directories, building targets, and packages, all while learning how to compile and link executables and libraries. You'll also gain a deeper understanding of how those processes work and how to optimize builds in CMake for the best results. You'll discover how to use external dependencies in your project – third-party libraries, testing frameworks, program analysis tools, and documentation generators. Finally, you'll gain profi ciency in exporting, installing, and packaging for internal and external purposes. By the end of this book, you'll be able to use CMake confi dently at a professional level.

Who is this book for?

The book is for build engineers and software developers with knowledge of C/C++ programming who are looking to learn CMake to automate the process of building small and large software solutions. If you’re just getting started with CMake, a long-time GNU Make user, or simply looking to brush up on the latest best practices, this book is for you.

What you will learn

  • Understand best practices to build ++ code
  • Gain practical knowledge of the CMake language
  • Guarantee code quality with tests and static and dynamic analysis
  • Discover how to manage, discover, download, and link dependencies with CMake
  • Build solutions that can be reused and maintained in the long term
  • Understand how to optimize build artifacts and the build process
  • Program modern CMake and manage your build processes
  • Acquire expertise in complex subjects such as CMake presets

Product Details

Country selected
Publication date, Length, Edition, Language, ISBN-13
Publication date : May 28, 2024
Length: 502 pages
Edition : 2nd
Language : English
ISBN-13 : 9781805123361
Category :
Languages :
Tools :

What do you get with eBook?

Product feature icon Instant access to your Digital eBook purchase
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
Product feature icon AI Assistant (beta) to help accelerate your learning

Product Details

Publication date : May 28, 2024
Length: 502 pages
Edition : 2nd
Language : English
ISBN-13 : 9781805123361
Category :
Languages :
Tools :

Packt Subscriptions

See our plans and pricing
Modal Close icon
$19.99 billed monthly
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Simple pricing, no contract
$199.99 billed annually
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts
$279.99 billed in 18 months
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts

Frequently bought together


Stars icon
Total $ 114.96 154.97 40.01 saved
Modern C++ Programming Cookbook
$37.99 $54.99
Asynchronous Programming in Rust
$41.99 $49.99
Modern CMake for C++
$34.98 $49.99
Total $ 114.96 154.97 40.01 saved Stars icon

Table of Contents

18 Chapters
First Steps with CMake Chevron down icon Chevron up icon
The CMake Language Chevron down icon Chevron up icon
Using CMake in Popular IDEs Chevron down icon Chevron up icon
Setting Up Your First CMake Project Chevron down icon Chevron up icon
Working with Targets Chevron down icon Chevron up icon
Using Generator Expressions Chevron down icon Chevron up icon
Compiling C++ Sources with CMake Chevron down icon Chevron up icon
Linking Executables and Libraries Chevron down icon Chevron up icon
Managing Dependencies in CMake Chevron down icon Chevron up icon
Using the C++20 Modules Chevron down icon Chevron up icon
Testing Frameworks Chevron down icon Chevron up icon
Program Analysis Tools Chevron down icon Chevron up icon
Generating Documentation Chevron down icon Chevron up icon
Installing and Packaging Chevron down icon Chevron up icon
Creating Your Professional Project Chevron down icon Chevron up icon
Writing CMake Presets Chevron down icon Chevron up icon
Other Books You May Enjoy Chevron down icon Chevron up icon
Index Chevron down icon Chevron up icon

Customer reviews

Top Reviews
Rating distribution
Full star icon Full star icon Full star icon Full star icon Half star icon 4.6
(11 Ratings)
5 star 72.7%
4 star 18.2%
3 star 9.1%
2 star 0%
1 star 0%
Filter icon Filter
Top Reviews

Filter reviews by




Austin Bachurski Jun 03, 2024
Full star icon Full star icon Full star icon Full star icon Full star icon 5
Prior to going through this book, I had no idea that CMake is all but a programming language unto itself. This book goes over a ton of information with lots of examples on things like testing. How to use test frameworks with CMake. How to use analysis tools for both performance and safety using CMake. Generating documentation with CMake. I didn't even know CMake could do these things, but this book has an entire section for each of these topics. It's quite a lot to take in at once, but it's going to be a great reference to have on the shelf to come back to when I have questions. Highly recommended if you're finding CMake confusing.
Amazon Verified review Amazon
Felix Bytow Jun 21, 2024
Full star icon Full star icon Full star icon Full star icon Full star icon 5
Disclaimer: I received a free review copy.But I liked it so much, I actually ordered a physical copy as well.I'm using CMake for many years already to build my C and C++ projects.Over the years a lot of things changed. A lot of things became easier with CMake,but CMake also became more powerful.So I was thrilled, when I saw this book. Reading through it, I found it to be a rather complete manualto everything CMake has to offer. There was a lot of information about functionality,that I had either only heard about, or didn't even know exists.I think the book handles both pretty well:As a beginner, reading it from the start, will give a good introduction of what CMake is, what it does, how it integrates with other tools and what best practices are.For experienced users it can act as a reference, whenever you find yourself in a situation, where you are unsure how to do something.
Amazon Verified review Amazon
Amazon Customer Jul 15, 2024
Full star icon Full star icon Full star icon Full star icon Full star icon 5
I enjoyed the read having recently picked up CMake. This book is well structured and comprehensive, giving practical examples of how to get started. Each chapter is broken down into bite size chunks that are easy to follow and grasp.
Amazon Verified review Amazon
Neil Jul 03, 2024
Full star icon Full star icon Full star icon Full star icon Full star icon 5
Disclosure: I was provided an early review copy at no expense but these opinions are my own.I've used CMake for several years and know enough to generally make it do what I need it to do. That being said, there's always more to learn. This book is a fantastic resource for a number of reasons.1. It starts from an introductory level with very few assumptions of your current knowledge.2. There are a number of side-notes and tips for best practices that can help provide context for deeper understanding.3. It goes beyond introductory tutorials and explains deeper concepts before ending with a solid summary chapter project.By building on a foundation of basics piece by piece all the way to more complicated topics -- with chapters explaining concepts that I didn't know even after using CMake for years -- I anticipate that this book would be a solid roadmap for beginners to learn how to start effectively using CMake in their projects and for the proficient to at least learn something new.
Amazon Verified review Amazon
Y. Arazi Sep 13, 2024
Full star icon Full star icon Full star icon Full star icon Full star icon 5
I recently read Modern CMake for C++, Second Edition and was thoroughly impressed. Despite considering myself highly technical and knowledgeable in CMake, I still learned a plethora of new information. The book covers a wide range of topics, from debugging a CMake project, understanding the grammar, targets, and package management like FetchContent, to using CMake in advanced IDEs.One of the standout aspects of this book is its guidance on properly setting up a project. It emphasizes good practices, what to focus on when building a project, the hierarchy, and various gotchas to avoid. The book even delves into the linking models of C and C++ and how to handle them correctly in CMake.This book is a must-read for every developer using CMake. By following the rules and best practices outlined, it will make your project healthier. Regardless of your experience level, you are bound to pick up new skills. The format and organization of this book are simply fabulous, making it highly recommended.
Amazon Verified review Amazon
Get free access to Packt library with over 7500+ books and video courses for 7 days!
Start Free Trial

FAQs

How do I buy and download an eBook? Chevron down icon Chevron up icon

Where there is an eBook version of a title available, you can buy it from the book details for that title. Add either the standalone eBook or the eBook and print book bundle to your shopping cart. Your eBook will show in your cart as a product on its own. After completing checkout and payment in the normal way, you will receive your receipt on the screen containing a link to a personalised PDF download file. This link will remain active for 30 days. You can download backup copies of the file by logging in to your account at any time.

If you already have Adobe reader installed, then clicking on the link will download and open the PDF file directly. If you don't, then save the PDF file on your machine and download the Reader to view it.

Please Note: Packt eBooks are non-returnable and non-refundable.

Packt eBook and Licensing When you buy an eBook from Packt Publishing, completing your purchase means you accept the terms of our licence agreement. Please read the full text of the agreement. In it we have tried to balance the need for the ebook to be usable for you the reader with our needs to protect the rights of us as Publishers and of our authors. In summary, the agreement says:

  • You may make copies of your eBook for your own use onto any machine
  • You may not pass copies of the eBook on to anyone else
How can I make a purchase on your website? Chevron down icon Chevron up icon

If you want to purchase a video course, eBook or Bundle (Print+eBook) please follow below steps:

  1. Register on our website using your email address and the password.
  2. Search for the title by name or ISBN using the search option.
  3. Select the title you want to purchase.
  4. Choose the format you wish to purchase the title in; if you order the Print Book, you get a free eBook copy of the same title. 
  5. Proceed with the checkout process (payment to be made using Credit Card, Debit Cart, or PayPal)
Where can I access support around an eBook? Chevron down icon Chevron up icon
  • If you experience a problem with using or installing Adobe Reader, the contact Adobe directly.
  • To view the errata for the book, see www.packtpub.com/support and view the pages for the title you have.
  • To view your account details or to download a new copy of the book go to www.packtpub.com/account
  • To contact us directly if a problem is not resolved, use www.packtpub.com/contact-us
What eBook formats do Packt support? Chevron down icon Chevron up icon

Our eBooks are currently available in a variety of formats such as PDF and ePubs. In the future, this may well change with trends and development in technology, but please note that our PDFs are not Adobe eBook Reader format, which has greater restrictions on security.

You will need to use Adobe Reader v9 or later in order to read Packt's PDF eBooks.

What are the benefits of eBooks? Chevron down icon Chevron up icon
  • You can get the information you need immediately
  • You can easily take them with you on a laptop
  • You can download them an unlimited number of times
  • You can print them out
  • They are copy-paste enabled
  • They are searchable
  • There is no password protection
  • They are lower price than print
  • They save resources and space
What is an eBook? Chevron down icon Chevron up icon

Packt eBooks are a complete electronic version of the print edition, available in PDF and ePub formats. Every piece of content down to the page numbering is the same. Because we save the costs of printing and shipping the book to you, we are able to offer eBooks at a lower cost than print editions.

When you have purchased an eBook, simply login to your account and click on the link in Your Download Area. We recommend you saving the file to your hard drive before opening it.

For o