CMake の IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティに関するサンプルコード

CMake の IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティ

IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティは、CMake の "Properties: Targets" において、インポートされた静的ライブラリのサイクルにおける繰り返しカウントを設定するために使用されます。これは、LINK_INTERFACE_MULTIPLICITY プロパティのインポートターゲット版です。

詳細

IMPORTED_LINK_INTERFACE_MULTIPLICITY は、以下の状況で役立ちます。

• 複数の静的ライブラリが互いに依存し、循環依存関係が発生している場合
• リンカーに、特定のライブラリを複数回リンクする必要があることを指示したい場合

設定方法

IMPORTED_LINK_INTERFACE_MULTIPLICITY は、set_target_properties コマンドを使用して設定できます。以下の例をご覧ください。

set(TARGET_NAME my_target)

# インポートされたターゲットであることを指定
add_library(${TARGET_NAME} UNKNOWN IMPORTED)

# ライブラリの場所を指定
set_target_properties(${TARGET_NAME} PROPERTIES IMPORTED_LOCATION /path/to/library.a)

# 繰り返しカウントを 3 に設定
set_target_properties(${TARGET_NAME} PROPERTIES IMPORTED_LINK_INTERFACE_MULTIPLICITY 3)

注意事項

• IMPORTED_LINK_INTERFACE_MULTIPLICITY は、インポートされた静的ライブラリにのみ適用されます。
• 設定値は、0 以上の整数である必要があります。
• リンカーがサイクルを検出できない場合、ビルドエラーが発生する可能性があります。

補足

• IMPORTED_LINK_INTERFACE_MULTIPLICITY は、CMake バージョン 3.14 以降で利用可能です。
• 以前のバージョンの CMake を使用している場合は、LINK_INTERFACE_MULTIPLICITY プロパティを使用して、ターゲットを直接リンクすることができます。

例

以下の例は、IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティを使用して、循環依存関係を持つ 2 つの静的ライブラリをビルドする方法を示しています。

# ライブラリの場所を指定
set(LIBA_LOCATION /path/to/liba.a)
set(LIBB_LOCATION /path/to/libb.a)

# ライブラリ A を作成
add_library(liba STATIC IMPORTED)
set_target_properties(liba PROPERTIES IMPORTED_LOCATION ${LIBA_LOCATION})

# ライブラリ B を作成
add_library(libb STATIC IMPORTED)
set_target_properties(libb PROPERTIES IMPORTED_LOCATION ${LIBB_LOCATION})

# 循環依存関係を設定
set_target_properties(liba PROPERTIES IMPORTED_LINK_INTERFACE_LIBRARIES libb)
set_target_properties(libb PROPERTIES IMPORTED_LINK_INTERFACE_LIBRARIES liba)

# 繰り返しカウントを設定
set_target_properties(liba PROPERTIES IMPORTED_LINK_INTERFACE_MULTIPLICITY 2)
set_target_properties(libb PROPERTIES IMPORTED_LINK_INTERFACE_MULTIPLICITY 2)

# ターゲットを生成
add_executable(my_target main.c)
target_link_libraries(my_target PRIVATE liba libb)

この例では、liba と libb は互いに依存していますが、IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティを使用して、リンカーにそれぞれのライブラリを 2 回リンクするように指示しています。

CMake の IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティを使用したサンプルコード

循環依存関係を持つ 2 つの静的ライブラリをビルドする

# ライブラリの場所を指定
set(LIBA_LOCATION /path/to/liba.a)
set(LIBB_LOCATION /path/to/libb.a)

# ライブラリ A を作成
add_library(liba STATIC IMPORTED)
set_target_properties(liba PROPERTIES IMPORTED_LOCATION ${LIBA_LOCATION})

# ライブラリ B を作成
add_library(libb STATIC IMPORTED)
set_target_properties(libb PROPERTIES IMPORTED_LOCATION ${LIBB_LOCATION})

# 循環依存関係を設定
set_target_properties(liba PROPERTIES IMPORTED_LINK_INTERFACE_LIBRARIES libb)
set_target_properties(libb PROPERTIES IMPORTED_LINK_INTERFACE_LIBRARIES liba)

# 繰り返しカウントを設定
set_target_properties(liba PROPERTIES IMPORTED_LINK_INTERFACE_MULTIPLICITY 2)
set_target_properties(libb PROPERTIES IMPORTED_LINK_INTERFACE_MULTIPLICITY 2)

# ターゲットを生成
add_executable(my_target main.c)
target_link_libraries(my_target PRIVATE liba libb)

リンカーに特定のライブラリを複数回リンクさせる

# ライブラリの場所を指定
set(LIB_LOCATION /path/to/library.a)

# ライブラリを作成
add_library(my_lib STATIC IMPORTED)
set_target_properties(my_lib PROPERTIES IMPORTED_LOCATION ${LIB_LOCATION})

# 繰り返しカウントを設定
set_target_properties(my_lib PROPERTIES IMPORTED_LINK_INTERFACE_MULTIPLICITY 3)

# ターゲットを生成
add_executable(my_target main.c)
target_link_libraries(my_target PRIVATE my_lib)

異なる構成で異なる繰り返しカウントを設定する

# ライブラリの場所を指定
set(LIB_LOCATION /path/to/library.a)

# ライブラリを作成
add_library(my_lib STATIC IMPORTED)
set_target_properties(my_lib PROPERTIES IMPORTED_LOCATION ${LIB_LOCATION})

# デバッグ構成では繰り返しカウントを 2 に設定
set_target_properties(my_lib PROPERTIES IMPORTED_LINK_INTERFACE_MULTIPLICITY_DEBUG 2)

# リリース構成では繰り返しカウントを 1 に設定
set_target_properties(my_lib PROPERTIES IMPORTED_LINK_INTERFACE_MULTIPLICITY_RELEASE 1)

# ターゲットを生成
add_executable(my_target main.c)
target_link_libraries(my_target PRIVATE my_lib)

CMake の IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティの代替方法

LINK_INTERFACE_MULTIPLICITY プロパティは、ターゲットを直接リンクする場合に使用できます。以下の例をご覧ください。

# ライブラリの場所を指定
set(LIBA_LOCATION /path/to/liba.a)
set(LIBB_LOCATION /path/to/libb.a)

# ライブラリ A を作成
add_library(liba STATIC)
set_target_properties(liba PROPERTIES LINK_INTERFACE_MULTIPLICITY 2)

# ライブラリ B を作成
add_library(libb STATIC)
set_target_properties(libb PROPERTIES LINK_INTERFACE_MULTIPLICITY 2)

# ターゲットを生成
add_executable(my_target main.c)
target_link_libraries(my_target PRIVATE liba libb)

この例では、liba と libb は互いに依存していませんが、LINK_INTERFACE_MULTIPLICITY プロパティを使用して、リンカーにそれぞれのライブラリを 2 回リンクするように指示しています。

手動でリンカーコマンドを指定する

ターゲットをビルドする際に、手動でリンカーコマンドを指定することもできます。以下の例をご覧ください。

# ライブラリの場所を指定
set(LIBA_LOCATION /path/to/liba.a)
set(LIBB_LOCATION /path/to/libb.a)

# ターゲットを生成
add_executable(my_target main.c)

# リンカーコマンドを指定
set_target_properties(my_target PROPERTIES LINK_FLAGS "-Wl,-rpath,${LIBA_LOCATION} -Wl,-rpath,${LIBB_LOCATION} -Wl,-L,${LIBA_LOCATION} -Wl,-L,${LIBB_LOCATION} -Wl,-l:liba -Wl,-l:libb")

この例では、-Wl,-rpath オプションを使用して、リンカーにライブラリの検索パスを指定しています。また、-Wl,-L オプションを使用して、リンカーにライブラリの場所を指定しています。最後に、-Wl,-l オプションを使用して、リンカーにリンクするライブラリを指定しています。

これらの代替方法は、IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティを使用できない場合に役立ちます。

注意事項

• これらの代替方法は、IMPORTED_LINK_INTERFACE_MULTIPLICITY プロパティよりも複雑です。
• これらの代替方法は、すべてのプラットフォームでサポートされているとは限りません。