CMake ポリシー CMP0060 とは？

CMake ポリシー CMP0060 の詳細解説

CMake ポリシー CMP0060 は、CMake 3.3 で導入されたポリシーで、ライブラリのリンク方法に影響を与えます。このポリシーは、デフォルトで OLD 動作に設定されていますが、NEW 動作に変更することもできます。

OLD 動作と NEW 動作の違い

• OLD 動作:

  • ライブラリのフルパスが暗黙のリンクディレクトリにある場合、リンカーにそのライブラリを検索するように指示します。
  • 従来の CMake プロジェクトと互換性があります。

• NEW 動作:

  • ライブラリのフルパスが暗黙のリンクディレクトリにある場合でも、フルパスでライブラリをリンクします。
  • より明確で一貫したリンク動作を提供します。
  • 将来の CMake バージョンでデフォルトになる可能性があります。

CMP0060 の設定方法

CMP0060 ポリシーは、以下の方法で設定できます。

• cmake_policy() コマンド:

cmake_policy(CMP0060 NEW)

• cmake_minimum_required() コマンド:

cmake_minimum_required(VERSION 3.3)
set(CMAKE_POLICY_CMP0060 NEW)

注意事項

• CMP0060 ポリシーを NEW に設定すると、従来の CMake プロジェクトとの互換性が失われる可能性があります。
• 暗黙のリンクディレクトリに依存しているプロジェクトは、CMP0060 ポリシーを NEW に設定する前に、明示的なリンクディレクトリを使用するように変更する必要があります。

補足

• CMake ポリシーは、CMake の動作を制御するための仕組みです。
• さまざまなポリシーがあり、それぞれ異なる動作に影響を与えます。
• ポリシーは、プロジェクトのニーズに合わせて設定する必要があります。

CMake ポリシー CMP0060 のサンプルコード

# 従来の CMake プロジェクト

set(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/modules)

find_library(FOO foo)
target_link_libraries(bar ${FOO})

NEW 動作

# CMP0060 ポリシーを NEW に設定

cmake_policy(CMP0060 NEW)

set(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/modules)

find_library(FOO foo)
target_link_libraries(bar ${CMAKE_BINARY_DIR}/lib/foo.so)

補足

• 上記のサンプルコードは、あくまでも参考です。
• プロジェクトのニーズに合わせて、コードを変更する必要があります。

CMake ポリシー CMP0060 を設定するその他の方法

cmake_minimum_required(VERSION 3.3)

# CMake 3.3 以降では、デフォルトで OLD 動作になります。
# 必要に応じて、NEW 動作に設定できます。
set(CMAKE_POLICY_CMP0060 NEW)

ターゲットプロパティ

target_link_libraries(bar
    PUBLIC
        ${CMAKE_BINARY_DIR}/lib/foo.so
)

環境変数

export CMAKE_POLICY_CMP0060=NEW

補足

• 上記の方法以外にも、CMake GUI や IDE を使用して CMP0060 ポリシーを設定することができます。

その他の方法

• CMake の設定ファイル (.cmake) を使用してポリシーを設定することもできます。