utility_source

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

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

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

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

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