CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数のサンプルコード

CMakeにおけるCMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数の解説

CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数は、CMakeが生成するXcodeスキームの診断セクションで動的リンカーAPIの使用状況を表示するかどうかを設定します。

デフォルト値

FALSE

設定方法

set(CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE TRUE)

詳細

この変数は、XcodeスキームのDYLD_INSERT_LIBRARIES環境変数に設定される値を制御します。

• TRUEに設定すると、DYLD_INSERT_LIBRARIES環境変数に-Wl,-dyld_API_usageフラグが追加されます。
• FALSEに設定すると、DYLD_INSERT_LIBRARIES環境変数にフラグは追加されません。

例

set(CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE TRUE)

add_executable(my_app main.c)

target_link_libraries(my_app "-Wl,-dyld_API_usage")

この例では、my_appターゲットがビルドされると、-Wl,-dyld_API_usageフラグがDYLD_INSERT_LIBRARIES環境変数に追加されます。

注意事項

• この変数は、Xcode 10以降でのみ使用できます。
• この変数は、CMAKE_XCODE_GENERATE_SCHEMEターゲットプロパティに設定する必要があります。

CMakeにおけるCMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数のサンプルコード

set(CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE TRUE)

add_library(my_lib static main.c)

add_executable(my_app app.c)

target_link_libraries(my_app my_lib)

この例では、my_appターゲットはmy_lib静的ライブラリに依存します。CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数をTRUEに設定することにより、my_appターゲットがビルドされると、-Wl,-dyld_API_usageフラグがDYLD_INSERT_LIBRARIES環境変数に追加されます。

動的ライブラリへの依存関係を持つプロジェクト

set(CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE TRUE)

add_library(my_lib shared main.c)

add_executable(my_app app.c)

target_link_libraries(my_app my_lib)

この例では、my_appターゲットはmy_lib動的ライブラリに依存します。CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数をTRUEに設定することにより、my_appターゲットがビルドされると、-Wl,-dyld_API_usageフラグがDYLD_INSERT_LIBRARIES環境変数に追加されます。

フレームワークへの依存関係を持つプロジェクト

set(CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE TRUE)

add_executable(my_app app.c)

target_link_libraries(my_app Cocoa.framework)

この例では、my_appターゲットはCocoaフレームワークに依存します。CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数をTRUEに設定することにより、my_appターゲットがビルドされると、-Wl,-dyld_API_usageフラグがDYLD_INSERT_LIBRARIES環境変数に追加されます。

複数のライブラリへの依存関係を持つプロジェクト

set(CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE TRUE)

add_library(my_lib1 static main1.c)
add_library(my_lib2 shared main2.c)

add_executable(my_app app.c)

target_link_libraries(my_app my_lib1 my_lib2)

この例では、my_appターゲットはmy_lib1静的ライブラリとmy_lib2動的ライブラリに依存します。CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数をTRUEに設定することにより、my_appターゲットがビルドされると、-Wl,-dyld_API_usageフラグがDYLD_INSERT_LIBRARIES環境変数に追加されます。

CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数以外の方法

DYLD_INSERT_LIBRARIES環境変数を直接設定する

set(ENV{DYLD_INSERT_LIBRARIES} "-Wl,-dyld_API_usage")

add_executable(my_app app.c)

この例では、DYLD_INSERT_LIBRARIES環境変数に-Wl,-dyld_API_usageフラグを直接設定しています。

Xcodeプロジェクトファイルを手動で編集する

Xcodeプロジェクトファイルをテキストエディタで開き、以下の設定を追加します。

<key>DYLD_INSERT_LIBRARIES</key>
<string>-Wl,-dyld_API_usage</string>

この設定は、DYLD_INSERT_LIBRARIES環境変数に-Wl,-dyld_API_usageフラグを追加するのと同じ効果があります。

Xcodeのビルド設定を使用して、DYLD_INSERT_LIBRARIES環境変数に-Wl,-dyld_API_usageフラグを追加することができます。

• Xcodeを開き、プロジェクトを選択します。
• ビルド設定タブを選択します。
• 検索フィールドにDYLD_INSERT_LIBRARIESと入力します。
• DYLD_INSERT_LIBRARIES設定を見つけ、+ボタンをクリックします。
• -Wl,-dyld_API_usageと入力します。

第三者製のツールを使用する

xcrunやotoolなどの第三者製のツールを使用して、動的リンカーAPIの使用状況を表示することができます。

• xcrun otool -l my_app

このコマンドは、my_appターゲットの動的リンカーAPIの使用状況を表示します。

どの方法を使用するべきかは、プロジェクトのニーズと開発者の好みによって異なります。

• CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE変数は、最も簡単で移植性の高い方法です。
• DYLD_INSERT_LIBRARIES環境変数を直接設定する方法は、最も柔軟性の高い方法です。
• Xcodeプロジェクトファイルを手動で編集する方法は、最も低レベルの方法です。
• Xcodeのビルド設定を使用する方法は、GUIベースの方法です。
• 第三者製のツールを使用する方法は、最も強力な方法です。