とにかくCMAKE_MODULE_PATHを指定する必要がある場合、find_package（）はどのように使用しますか？

CMakeを使用して、クロスプラットフォームのビルドシステムを動作させようとしています。現在、ソフトウェアにはいくつかの依存関係があります。自分でコンパイルして、システムにインストールしました。

インストールされたいくつかのサンプルファイル：

-- Installing: /usr/local/share/SomeLib/SomeDir/somefile
-- Installing: /usr/local/share/SomeLib/SomeDir/someotherfile
-- Installing: /usr/local/lib/SomeLib/somesharedlibrary
-- Installing: /usr/local/lib/SomeLib/cmake/FindSomeLib.cmake
-- Installing: /usr/local/lib/SomeLib/cmake/HelperFile.cmake

CMakeは、ファイルfind_package()を開きFind*.cmake、システム上のライブラリを検索して、いくつかの変数を定義するを持っていますSomeLib_FOUND。

私のCMakeLists.txtには次のようなものが含まれています。

set(CMAKE_MODULE_PATH "/usr/local/lib/SomeLib/cmake/;${CMAKE_MODULE_PATH}")
find_package(SomeLib REQUIRED)

最初のコマンドは、CMakeがの後に検索する場所を定義し、が見つかる場所のFind*.cmakeディレクトリを追加したので、期待どおりに機能します。SomeLibFindSomeLib.cmakefind_package()

しかし、find_package()存在する理由の1つは、非クロスプラットフォームのハードコードされたパスから離れることです。

これは通常どのように行われますか？のcmake/ディレクトリをSomeLibプロジェクトにコピーして、CMAKE_MODULE_PATH相対的に設定する必要がありますか？

コマンドにfind_packageは、ModuleモードとConfigモードの2つのモードがあります。Module実際にConfigモードが必要なときにモードを使用しようとしています。

モジュールモード

Find<package>.cmakeプロジェクト内にあるファイル。このようなもの：

CMakeLists.txt
cmake/FindFoo.cmake
cmake/FindBoo.cmake

CMakeLists.txt コンテンツ：

list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake")
find_package(Foo REQUIRED) # FOO_INCLUDE_DIR, FOO_LIBRARIES
find_package(Boo REQUIRED) # BOO_INCLUDE_DIR, BOO_LIBRARIES

include_directories("${FOO_INCLUDE_DIR}")
include_directories("${BOO_INCLUDE_DIR}")
add_executable(Bar Bar.hpp Bar.cpp)
target_link_libraries(Bar ${FOO_LIBRARIES} ${BOO_LIBRARIES})

注CMAKE_MODULE_PATH高い優先度を持っており、あなたが標準書き換える必要があるときに便利かもしれFind<package>.cmakeファイルを。

設定モード（インストール）

<package>Config.cmake外部にありinstall 、他のプロジェクトのコマンドによって生成されたファイル（Fooたとえば）。

foo 図書館：

> cat CMakeLists.txt 
cmake_minimum_required(VERSION 2.8)
project(Foo)

add_library(foo Foo.hpp Foo.cpp)
install(FILES Foo.hpp DESTINATION include)
install(TARGETS foo DESTINATION lib)
install(FILES FooConfig.cmake DESTINATION lib/cmake/Foo)

設定ファイルの簡略版：

> cat FooConfig.cmake 
add_library(foo STATIC IMPORTED)
find_library(FOO_LIBRARY_PATH foo HINTS "${CMAKE_CURRENT_LIST_DIR}/../../")
set_target_properties(foo PROPERTIES IMPORTED_LOCATION "${FOO_LIBRARY_PATH}")

デフォルトでは、CMAKE_INSTALL_PREFIXディレクトリにインストールされたプロジェクト：

> cmake -H. -B_builds
> cmake --build _builds --target install
-- Install configuration: ""
-- Installing: /usr/local/include/Foo.hpp
-- Installing: /usr/local/lib/libfoo.a
-- Installing: /usr/local/lib/cmake/Foo/FooConfig.cmake

設定モード（使用）

インポートされたターゲットfind_package(... CONFIG)に含めるために使用：FooConfig.cmakefoo

> cat CMakeLists.txt 
cmake_minimum_required(VERSION 2.8)
project(Boo)

# import library target `foo`
find_package(Foo CONFIG REQUIRED)

add_executable(boo Boo.cpp Boo.hpp)
target_link_libraries(boo foo)
> cmake -H. -B_builds -DCMAKE_VERBOSE_MAKEFILE=ON
> cmake --build _builds
Linking CXX executable Boo
/usr/bin/c++ ... -o Boo /usr/local/lib/libfoo.a

インポートされたターゲットは高度に構成可能であることに注意してください。私の答えを見てください。

更新

• 例

自分自身cmakeを生成するために実行している場合SomeLib（たとえば、スーパービルドの一部として）、ユーザーパッケージレジストリの使用を検討してください。これはハードコーディングされたパスを必要とせず、クロスプラットフォームです。Windows（mingw64を含む）では、レジストリを介して動作します。インストールプレフィックスのリストがfind_packages（）コマンドのCONFIGモードによってどのように構築されるかを調べると、ユーザーパッケージレジストリが要素の1つであることがわかります。

簡単なハウツー

作成SomeLibしたCMakeLists.txtファイルのエクスポートセットにターゲットを追加して、その外部プロジェクトの外部で必要なターゲットを関連付けます。

add_library(thingInSomeLib ...)
install(TARGETS thingInSomeLib Export SomeLib-export DESTINATION lib)

作成XXXConfig.cmakeのためのファイルをSomeLibその中${CMAKE_CURRENT_BUILD_DIR}との2つの呼び出しを追加することにより、ユーザーのパッケージレジストリでこの場所を保存）（輸出にCMakeLists.txt関連付けられましたSomeLib：

export(EXPORT SomeLib-export NAMESPACE SomeLib:: FILE SomeLibConfig.cmake) # Create SomeLibConfig.cmake
export(PACKAGE SomeLib)                                                    # Store location of SomeLibConfig.cmake

「非クロスプラットフォームのハードコードされたパス」を使用せずに依存するプロジェクトfind_package(SomeLib REQUIRED)のCMakeLists.txtファイルでコマンドを発行します。SomeLibCMAKE_MODULE_PATH

それが正しいアプローチかもしれないとき

このアプローチは、ビルドディレクトリの下流でソフトウェアを使用しない（たとえば、クロスコンパイルしてマシンに何もインストールしない）場合や、テストを実行するためだけにソフトウェアをビルドする場合に最適です。ビルドディレクトリ）。「ビルド」出力に.cmakeファイルへのリンクが作成されるため、一時的な場合があります。

ただしSomeLib、ワークフローに実際にインストールすることがない場合は、呼び出しEXPORT(PACKAGE <name>)により、ハードコーディングされたパスを回避できます。そしてもちろん、をインストールしている場合はSomeLib、おそらくプラットフォームCMAKE_MODULE_PATHなどを知っているので、@ user2288008の優れた答えで対応できます。

モジュールパス自体を指定する必要はありません。CMakeには独自の組み込みのfind_packageスクリプトのセットが付属しており、その場所はデフォルトのCMAKE_MODULE_PATHにあります。

CMake化された依存プロジェクトのより一般的な使用例は、CMakeのexternal_projectコマンドを使用して、サブプロジェクトのUse [Project] .cmakeファイルを含めることです。Find [Project] .cmakeスクリプトだけが必要な場合は、それをサブプロジェクトから独自のプロジェクトのソースコードにコピーします。システムレベルでサブプロジェクトを見つけるためにCMAKE_MODULE_PATHを拡張する必要はありません。

これは通常どのように行われますか？cmake/SomeLib のディレクトリをプロジェクトにコピーして、CMAKE_MODULE_PATHを相対的に設定する必要がありますか？

CMakeがそのモジュールを持っていると信頼していない場合は- はい、そうします-並べ替え：find_SomeLib.cmakeとその依存関係をcmake/ディレクトリにコピーします。それが私がフォールバックとしてやっていることです。しかし、それは醜い解決策です。

FindFoo.cmakeモジュールはそれぞれプラットフォーム依存とプラットフォーム非依存の間の一種の橋であることに注意してください-それらは名前がプラットフォームに依存しない変数のパスを取得するためにさまざまなプラットフォーム固有の場所を調べます。