utility_source

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

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

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

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

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