utility_source

自 3.0 版本起禁用。请参阅 CMake 策略 CMP0034。

指定第三方工具的源代码树。

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

当分发中包含第三方工具的源代码时，此命令指定其位置和名称。只有当 path_to_source 和所有列出的文件都存在时，才会设置缓存条目。假定在需要之前，该工具的源代码树已经构建完毕。

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