CMAKE_FIND_PACKAGE_SORT_ORDER

在版本 3.7 中添加。

使用 find_package() 找到的包含 glob 表达式的搜索路径所匹配的目录的默认排序顺序。它可以假定为以下值之一

NONE

默认值。不尝试对目录进行排序。将选择找到的第一个有效包。

NAME

在搜索之前按字典顺序对目录进行排序。

NATURAL

使用自然顺序对目录进行排序(参见 strverscmp(3) 手册),即,将连续的数字作为整数进行比较。

当可以通过 find_package() 找到同一库的多个版本时,可以使用自然排序来返回最高版本。例如,假设以下库在磁盘上具有包配置文件,位于同名目录中,所有这些目录都位于同一父目录中

  • libX-1.1.0

  • libX-1.2.9

  • libX-1.2.10

通过设置 NATURAL 顺序,我们可以选择版本号最高的那个 libX-1.2.10

set(CMAKE_FIND_PACKAGE_SORT_ORDER NATURAL)
find_package(libX CONFIG)

可以使用 CMAKE_FIND_PACKAGE_SORT_DIRECTION 变量控制排序方向(默认为降序,例如,lib-B 将在 lib-A 之前进行测试)。