CMP0068

新增於 3.9 版本。

macOS 上的 RPATH 設定不會影響 install_name。

CMake 3.9 及更新版本會移除以下設定可能對 macOS 上目標的 install_name 產生的任何影響。

• BUILD_WITH_INSTALL_RPATH 目標屬性

• SKIP_BUILD_RPATH 目標屬性

• CMAKE_SKIP_RPATH 變數

• CMAKE_SKIP_INSTALL_RPATH 變數

先前，設定 BUILD_WITH_INSTALL_RPATH 的效果是將目標的 install_name 設定為 INSTALL_NAME_DIR，並將 RPATH 設定為 INSTALL_RPATH。在 CMake 3.9 中，它僅影響 RPATH 的設定。但是，如果想要讓 INSTALL_NAME_DIR 應用於建置樹中的目標，可以設定 BUILD_WITH_INSTALL_NAME_DIR。

如果使用 SKIP_BUILD_RPATH、CMAKE_SKIP_RPATH 或 CMAKE_SKIP_INSTALL_RPATH 來移除目標的 install_name 的目錄部分，可以改為設定 INSTALL_NAME_DIR=""。

此政策的 OLD 行為是針對 macOS 上的 install_name 使用 RPATH 設定。此政策的 NEW 行為是忽略 macOS 上 install_name 的 RPATH 設定。

此政策於 CMake 3.9 版本中引入。它可由 cmake_policy() 或 cmake_minimum_required() 設定。如果未設定，CMake 會發出警告，並使用 OLD 行為。

注意

政策的 OLD 行為 依定義已棄用，並可能在未來版本的 CMake 中移除。