实用程序源

3.0 版后不允许。请参阅 CMake 政策:policy:CMP0034。

指定第三方实用程序的源代码树。

utility_source(cache_entry executable_name
               path_to_source [file1 file2 ...])

当第三方实用程序的源包含在分发中时，此命令指定其位置和名称。除非 path_to_source 和所有列出的文件都存在，否则不会设置缓存条目。假定实用程序的源代码树在需要之前已经构建。

交叉编译时，如果执行 utility_source() 命令，CMake 将打印警告，因为在许多情况下，它用于构建稍后执行的可执行文件。这在交叉编译时不起作用，因为可执行文件只能在其目标平台上运行。所以在这种情况下，必须手动调整缓存条目，使其指向可在构建主机上运行的可执行文件。