CMP0017

警告

此策略的 OLD 行為已在 CMake 4.0 版本中移除。此策略必須透過呼叫 cmake_minimum_required() 或 cmake_policy() 設定為 NEW。

當從 CMake 模組目錄包含檔案時，優先選擇該目錄中的檔案。

從 CMake 2.8.4 開始，如果 CMake 隨附的 cmake-module（即位於 CMake 模組目錄中）呼叫 include() 或 find_package()，則優先選擇位於 CMake 模組目錄中的檔案，而不是 CMAKE_MODULE_PATH 中的檔案。這確保了屬於 CMake 的模組始終包含它們期望的檔案，並針對這些檔案進行開發和測試。在所有其他情況下，在 CMAKE_MODULE_PATH 中找到的檔案仍然優先於 CMake 模組目錄中的檔案。OLD 行為是始終優先選擇來自 CMAKE_MODULE_PATH 的檔案，而不是來自 CMake 模組目錄的檔案。

此策略在 CMake 2.8.4 版本中引入。在 CMake 4.0 版本中移除之前，可以透過 cmake_policy() 或 cmake_minimum_required() 進行設定。如果未設定，CMake 會發出警告，並使用 OLD 行為。