utility_source

版本 3.0 起禁用。请参见 CMake Policy CMP0034。

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

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

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

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