utility_source

自 3.0 版本起不允許使用。請參閱 CMake 政策 CMP0034。

指定第三方工具的原始碼樹。

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

當第三方工具的原始碼包含在發行版本中時，此命令指定其位置和名稱。除非 path_to_source 和所有列出的檔案都存在，否則不會設定快取項目。假設在需要該工具之前，它的原始碼樹已經被建置。

當進行交叉編譯時，如果執行了 utility_source() 命令，CMake 會印出警告，因為在許多情況下，它被用來建置稍後會執行的可執行檔。當進行交叉編譯時，這會無法運作，因為該可執行檔只能在其目標平台上執行。因此，在這種情況下，必須手動調整快取項目，使其指向在建置主機上可執行的可執行檔。