Yine de CMAKE_MODULE_PATH belirtmeniz gerekiyorsa find_package () ne işe yarar?

CMake kullanarak çalışan bir çapraz platform oluşturma sistemi elde etmeye çalışıyorum. Şimdi yazılımın birkaç bağımlılığı var. Onları kendim derledim ve sistemime kurdum.

Yüklü bazı örnek dosyalar:

-- 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

Şimdi CMake, bir dosyayı find_package()açan Find*.cmakeve sistemdeki kütüphaneyi arayan ve SomeLib_FOUNDvb. Gibi bazı değişkenleri tanımlayan bir dosyaya sahiptir .

CMakeLists.txt dosyamda şöyle bir şey var:

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

İlk komut, CMake'in nerede aradığını tanımlar ve bulunabileceği Find*.cmakedizini ekledim , bu yüzden beklendiği gibi çalışır.SomeLibFindSomeLib.cmakefind_package()

Ancak bu biraz gariptir, çünkü find_package()var olmanın nedenlerinden biri, platforma olmayan sabit kodlu yollardan uzaklaşmaktır.

Bu genellikle nasıl yapılır? Ben kopya mı cmake/dizinini SomeLibbenim projeye ve set CMAKE_MODULE_PATHnispeten?

Komutun find_packageiki modu vardır: Modulemod ve Configmod. ModuleGerçekten Configmoda ihtiyacınız olduğunda modu kullanmaya çalışıyorsunuz .

Modül modu

Find<package>.cmakedosyanın bulunduğu dahilinde projeniz. Bunun gibi bir şey:

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

CMakeLists.txt içerik:

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_PATHYüksek önceliğe sahip olduğunu ve standart Find<package>.cmakedosyayı yeniden yazmanız gerektiğinde yararlı olabileceğini unutmayın .

Yapılandırma modu (yükleme)

<package>Config.cmakedosya dışarıda bulunur ve install başka bir projenin komutuyla üretilir ( Fooörneğin).

foo kütüphane:

> 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)

Yapılandırma dosyasının basitleştirilmiş sürümü:

> 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}")

Varsayılan olarak CMAKE_INSTALL_PREFIXdizinde kurulu proje :

> 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

Yapılandırma modu (kullanım)

İçe aktarılan hedefe find_package(... CONFIG)dahil FooConfig.cmakeetmek için kullanın foo:

> 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

İçe aktarılan hedefin son derece yapılandırılabilir olduğunu unutmayın . Cevabımı gör .

Güncelleme

• Misal

Kendiniz cmakeüretmeye çalışıyorsanız SomeLib(bir süper yapının parçası olarak söyleyin), Kullanıcı Paketi Kayıt Defterini kullanmayı düşünün . Bu sabit kodlanmış yollar gerektirmez ve çapraz platformdur. Windows'ta (mingw64 dahil) kayıt defteri aracılığıyla çalışır. Yükleme önekleri listesinin find_packages () komutunun CONFIGmodu tarafından nasıl oluşturulduğunu incelerseniz , Kullanıcı Paketi Kayıt Defteri'nin öğelerden biri olduğunu görürsünüz.

Kısa nasıl yapılır

SomeLibİhtiyaç duyduğunuz hedefleri CMakeLists.txt, oluşturuldukları dosyalarda bir dışa aktarma kümesine ekleyerek bu harici projenin dışında ilişkilendirin :

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

Bir oluşturma XXXConfig.cmakeiçin dosya SomeLibonun içinde ${CMAKE_CURRENT_BUILD_DIR}ve iki çağrı ekleyerek Kullanıcı Paketi Sicil içinde bu konuma depolamak ihracat () için CMakeLists.txtilişkili SomeLib:

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

Senin Sayı find_package(SomeLib REQUIRED)içinde Commmand CMakeLists.txtbağlıdır projenin dosyası SomeLibile müdahalesi "sert kodlu yolları olmayan çapraz platform" olmadan CMAKE_MODULE_PATH.

Ne zaman doğru yaklaşım olabilir

Bu yaklaşım muhtemelen yazılımınızı derleme dizininin aşağısında asla kullanmayacağınız durumlar için en uygunudur (örneğin, çapraz derleme yaparsınız ve makinenize hiçbir şey yüklemezsiniz veya yazılımı yalnızca testleri çalıştırmak için oluşturursunuz build dizini), "build" çıktısında geçici olabilen bir .cmake dosyasına bir bağlantı oluşturduğundan.

Ancak SomeLib, iş akışınıza gerçekten hiç yüklemiyorsanız, çağrı EXPORT(PACKAGE <name>)yapmak sabit kodlu yoldan kaçınmanıza olanak tanır. Ve tabii ki, eğer kuruyorsanız SomeLib, muhtemelen platformunuzu CMAKE_MODULE_PATHvb. Biliyorsunuzdur , bu yüzden @ user2288008'in mükemmel cevabı sizi ele alacaktır.

Modül yolunu kendiniz belirtmeniz gerekmez . CMake, kendi yerleşik find_package komut dosyalarıyla birlikte gönderilir ve konumları varsayılan CMAKE_MODULE_PATH konumundadır.

CMakeified olan bağımlı projeler için daha normal kullanım durumu, CMake'nin external_project komutunu kullanmak ve sonra alt projeden [Project] .cmake dosyasını kullanmak olacaktır. Yalnızca Find [Project] .cmake komut dosyasına ihtiyacınız varsa, alt projeden kendi projenizin kaynak koduna kopyalayın ve alt projeyi sistem düzeyinde bulmak için CMAKE_MODULE_PATH değerini artırmanız gerekmez.

Bu genellikle nasıl yapılır? cmake/SomeLib dizinini projeme kopyalamalı ve CMAKE_MODULE_PATH değerini nispeten ayarlamam gerekir mi?

CMake'in bu modüle sahip olduğuna güvenmiyorsanız, - evet, bunu - bir çeşit yapın:find_SomeLib.cmake ve bağımlılıklarını cmake/dizininize kopyalayın . Bunu bir yedek olarak yapıyorum. Gerçi çirkin bir çözüm.

FindFoo.cmakeModüllerin her birinin platforma bağımlılık ile platformdan bağımsızlık arasında bir tür köprü olduğunu unutmayın - adları platformdan bağımsız olan değişkenlerde yollar elde etmek için platforma özgü çeşitli yerlere bakarlar.