update
This commit is contained in:
parent
c41683d9e2
commit
d931b5aaea
@ -1 +1 @@
|
||||
Subproject commit c651ba0ef064734b6457684c780f8c863f0956bf
|
||||
Subproject commit ce6b18660a933855dbe996fc5b5d3d0ac1c25223
|
||||
@ -248,21 +248,22 @@ set(CPACK_PACKAGE_DESCRIPTION_SUMMARY "CMake project example")
|
||||
set(CPACK_DEBIAN_PACKAGE_SECTION "misc")
|
||||
set(CPACK_DEBIAN_PACKAGE_PRIORITY "optional")
|
||||
set(CPACK_SOURCE_IGNORE_FILES
|
||||
${CMAKE_BINARY_DIR}
|
||||
.git/
|
||||
.git$
|
||||
.gitlab-ci/
|
||||
_output/
|
||||
files/lib
|
||||
files/log
|
||||
.clang-tidy
|
||||
.cmake-format
|
||||
.gitignore
|
||||
.gitmodules
|
||||
.gitlab-ci.yml
|
||||
CMakeLists.txt.user.*
|
||||
~$
|
||||
\\\\..*\\\\.swp$)
|
||||
"${CMAKE_BINARY_DIR}"
|
||||
"/\\\\.git/"
|
||||
"/\\\\.gitlab-ci/"
|
||||
"^${CMAKE_SOURCE_DIR}/.?build.?/"
|
||||
"^${CMAKE_SOURCE_DIR}/.?output.?/"
|
||||
"^${CMAKE_SOURCE_DIR}/files/lib"
|
||||
"^${CMAKE_SOURCE_DIR}/files/log"
|
||||
"\\\\.clang-tidy$"
|
||||
"\\\\.cmake-format$"
|
||||
"\\\\.gitignore$"
|
||||
"\\\\.gitattributes$"
|
||||
"\\\\.gitmodules$"
|
||||
"\\\\.gitlab-ci.yml"
|
||||
"CMakeLists.txt.user.*"
|
||||
"~$"
|
||||
"\\\\.swp$")
|
||||
----
|
||||
|
||||
Произведённые изменения можно зафиксировать:
|
||||
@ -354,23 +355,28 @@ make uninstall
|
||||
----
|
||||
|
||||
|
||||
== Архивирование проекта
|
||||
== Архивирование проекта и создание пакетов
|
||||
|
||||
Стандартный модуль `CPack` предназначен для архивирования исходных
|
||||
текстов проекта и создания пакетов для установки в целевую систему.
|
||||
Необходимые переменные устанавливаются в файле `cmake/etc/Variables.cmake`
|
||||
<<variables-cmake,см. выше>>.
|
||||
|
||||
По умолчанию цель для упаковки исходных текстов называется `package_source`.
|
||||
В библиотеке CMLib определены значения основных параметров,
|
||||
а также дополнительная цель `dist`.
|
||||
Устанавливаемые файлы делятся на две группы `MAIN` и `DEV` с помощью
|
||||
параметра `COMPONENT` функции `install`. В группу `MAIN` необходимо
|
||||
помещать файлы для установки на целевую систему (исполняемые файлы,
|
||||
файлы настроек, файлы данных, разделяемые библиотеки), а в группу `DEV` ---
|
||||
для установки на систему для разработки (заголовочные файлы, статические
|
||||
библиотеки).
|
||||
|
||||
Для создания бинарных пакетов нужно выполнить в каталоге сборки команду `cpack`.
|
||||
По умолчанию цель для упаковки исходных текстов называется `package_source`.
|
||||
Бинарные пакеты создаются программой `cpack`. Пример:
|
||||
|
||||
[source,sh]
|
||||
----
|
||||
cd _build/debug
|
||||
make dist
|
||||
make
|
||||
make package_source
|
||||
cpack
|
||||
----
|
||||
|
||||
@ -422,12 +428,10 @@ add_dependencies(cmlib-example create_auxilary_symlinks)
|
||||
set(TRGT cmlib-example)
|
||||
|
||||
# Список файлов исходных текстов
|
||||
set(TRGT_sources
|
||||
${CMAKE_CURRENT_SOURCE_DIR}/init.cpp)
|
||||
set(TRGT_sources ${CMAKE_CURRENT_SOURCE_DIR}/init.cpp)
|
||||
|
||||
# Список заголовочных файлов (используется для установки)
|
||||
set(TRGT_headers
|
||||
${CMAKE_CURRENT_SOURCE_DIR}/init.hpp)
|
||||
set(TRGT_headers ${CMAKE_CURRENT_SOURCE_DIR}/init.hpp)
|
||||
|
||||
# Функция для создания цели, результатом которой будет сборка библиотеки
|
||||
add_common_library(TARGET ${TRGT} SOURCES ${TRGT_sources})
|
||||
@ -438,30 +442,22 @@ target_include_directories(${TRGT} SYSTEM PUBLIC ${Boost_INCLUDE_DIRS})
|
||||
|
||||
# Цель, используемая только для установки
|
||||
# заголовочных файлов без компиляции проекта
|
||||
add_custom_target(
|
||||
${TRGT}-install-headers
|
||||
COMMAND "${CMAKE_COMMAND}" -DCMAKE_INSTALL_COMPONENT=headers -P
|
||||
"${CMAKE_BINARY_DIR}/cmake_install.cmake")
|
||||
add_custom_target(${TRGT}-install-headers COMMAND "${CMAKE_COMMAND}" -DCMAKE_INSTALL_COMPONENT=DEV -P
|
||||
"${CMAKE_BINARY_DIR}/cmake_install.cmake")
|
||||
|
||||
# Установка статической библиотеки
|
||||
install(TARGETS ${TRGT}_static
|
||||
ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR})
|
||||
install(TARGETS ${TRGT}_static COMPONENT DEV ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR})
|
||||
|
||||
# Установка динамической библиотеки
|
||||
if(BUILD_SHARED_LIBS)
|
||||
install(TARGETS ${TRGT}_shared
|
||||
LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR})
|
||||
install(TARGETS ${TRGT}_shared COMPONENT DEV LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR})
|
||||
endif()
|
||||
|
||||
# Установка заголовочных файлов
|
||||
install(
|
||||
FILES ${TRGT}_headers
|
||||
COMPONENT headers
|
||||
DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/${TRGT})
|
||||
install(FILES ${TRGT_headers} COMPONENT DEV DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/${TRGT})
|
||||
|
||||
# Установка файла для pkg-config
|
||||
install(FILES ${CMAKE_BINARY_DIR}/${TRGT}.pc
|
||||
DESTINATION ${CMAKE_INSTALL_LIBDIR}/pkgconfig)
|
||||
install(FILES ${CMAKE_BINARY_DIR}/${TRGT}.pc COMPONENT DEV DESTINATION ${CMAKE_INSTALL_LIBDIR}/pkgconfig)
|
||||
----
|
||||
|
||||
|
||||
@ -498,105 +494,107 @@ int32_t cmlib_example_init(int32_t i = 0)
|
||||
}
|
||||
----
|
||||
|
||||
|
||||
|
||||
ПИШУ ЗДЕСЬ!!!
|
||||
|
||||
|
||||
|
||||
=== Базовое приложение
|
||||
|
||||
Проект с базовым приложением реализован на основе <<base-project,базового проекта>>.
|
||||
Исходные тексты содержат комментарии, объясняющие назначение используемых функций.
|
||||
Проект можно посмотреть https://git.246060.ru/f1x1t/cmlib-example-application[здесь]
|
||||
Проект можно посмотреть https://git.246060.ru/f1x1t/cmlib-example-app[здесь]
|
||||
или сделать его копию командой:
|
||||
|
||||
[source,sh]
|
||||
----
|
||||
git clone --recursive https://git.246060.ru/f1x1t/cmlib-example-application
|
||||
git clone --recursive https://git.246060.ru/f1x1t/cmlib-example-app
|
||||
----
|
||||
|
||||
В файл `CMakeLists.txt`, находящийся в корневом каталоге проекта, нужно добавить:
|
||||
|
||||
[source,cmake]
|
||||
----
|
||||
# Boost
|
||||
set(Boost_USE_STATIC_LIBS ON)
|
||||
set(Boost_USE_MULTITHREADED OFF)
|
||||
set(Boost_USE_STATIC_RUNTIME ON)
|
||||
find_package(Boost 1.55.0 REQUIRED COMPONENTS headers)
|
||||
|
||||
# Автоматически генерируемый заголовочный файл
|
||||
cmlib_config_hpp_generate()
|
||||
|
||||
# Приложение
|
||||
add_subdirectory(src/cmlib-example)
|
||||
|
||||
# Документация
|
||||
add_subdirectory(cmake/doc)
|
||||
|
||||
# Создание вспомогательных символических ссылок
|
||||
add_dependencies(cmlib-example create_auxilary_symlinks)
|
||||
----
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
В файле `cmex/CMakeLists.txt` должна быть строка, включающая поиск файла
|
||||
`CMakeLists.txt` в подкаталоге `src/cmex`:
|
||||
В подкаталоге `src/cmlib-example` нужно создать файл `CMakeLists.txt`:
|
||||
|
||||
[source,cmake]
|
||||
----
|
||||
add_subdirectory(src/cmex)
|
||||
# Название основной цели и имя библиотеки в текущем каталоге
|
||||
set(TRGT cmlib-example)
|
||||
|
||||
# Список файлов исходных текстов
|
||||
set(TRGT_sources ${CMAKE_CURRENT_SOURCE_DIR}/main.cpp)
|
||||
|
||||
# Функция для создания цели, результатом которой будет сборка приложения
|
||||
add_executable(${TRGT} ${TRGT_sources})
|
||||
common_target_properties(${TRGT})
|
||||
|
||||
# Добавление к пути поиска заголовочных файлов
|
||||
target_include_directories(${TRGT} SYSTEM PUBLIC ${Boost_INCLUDE_DIRS})
|
||||
|
||||
# Имя целевого каталога и выходного файла для цели
|
||||
set_target_properties(${TRGT}
|
||||
PROPERTIES
|
||||
OUTPUT_NAME ${TRGT}
|
||||
RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_BINDIR}
|
||||
)
|
||||
|
||||
# Правила для установки
|
||||
install(TARGETS ${TRGT} COMPONENT MAIN RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})
|
||||
----
|
||||
|
||||
В каталоге `cmex/src/cmex` нужно создать файл `main.cpp`:
|
||||
и файл `main.cpp`:
|
||||
|
||||
[source,cpp]
|
||||
----
|
||||
#include "compiler_features.hpp"
|
||||
#include "cmlib_config.hpp"
|
||||
#include "cmlib_private_config.hpp"
|
||||
|
||||
#include <iostream>
|
||||
#include <boost/range/counting_range.hpp>
|
||||
|
||||
#include "cmex.hpp"
|
||||
int32_t nsum(int32_t i = 0)
|
||||
{
|
||||
int32_t s = 0;
|
||||
for ( auto r : boost::counting_range( 1, i ) )
|
||||
{
|
||||
s += r;
|
||||
}
|
||||
return s;
|
||||
}
|
||||
|
||||
int main(int argc, char **argv) {
|
||||
std::cout << CMEX_COMPILER_VERSION_MAJOR << std::endl; // Значение из compiler_features.hpp
|
||||
std::cout << BUILD_TYPE << std::endl; // Значение из cmlib_config.hpp
|
||||
std::cout << CMEX_VERSION_STR << std::endl; // Значение из cmlib_config.hpp
|
||||
std::cout << cmex_init(4) << std::endl; // Функция из внутренней библиотеки
|
||||
return 0;
|
||||
int main(int argc, char* argv[])
|
||||
{
|
||||
// Значение из compiler_features.hpp
|
||||
std::cout << CMLIB_EXAMPLE_APP_COMPILER_VERSION_MAJOR << std::endl;
|
||||
// Значение из cmlib_private_config.hpp
|
||||
std::cout << CMLIB_BUILD_TYPE << std::endl;
|
||||
// Значение из cmlib_private_config.hpp
|
||||
std::cout << CMLIB_BUILD_DATE << std::endl;
|
||||
|
||||
auto s = nsum( argc );
|
||||
std::cout << s << std::endl;
|
||||
|
||||
return ( s );
|
||||
}
|
||||
----
|
||||
|
||||
и файл `CMakeLists.txt`:
|
||||
|
||||
[source,cmake]
|
||||
----
|
||||
# Название основной цели в текущем каталоге
|
||||
set(current_target cmex_app)
|
||||
|
||||
# Список файлов исходных текстов
|
||||
set(current_target_sources
|
||||
${CMAKE_CURRENT_SOURCE_DIR}/main.cpp
|
||||
)
|
||||
|
||||
# Цель для создания исполняемого файла
|
||||
add_executable(${current_target} ${current_target_sources})
|
||||
common_target_properties(${current_target})
|
||||
|
||||
# Зависимость от библиотеки из текущего проекта
|
||||
add_dependencies(${current_target} cmex)
|
||||
|
||||
# Добавление внутреннего каталога src/libcmex к списку путей для поиска заголовочных файлов
|
||||
target_include_directories(${current_target} PUBLIC
|
||||
$<BUILD_INTERFACE:${CMAKE_SOURCE_DIR}/src/libcmex>)
|
||||
|
||||
# Имя выходного файла для цели (параметр OUTPUT_NAME)
|
||||
set_target_properties(${current_target}
|
||||
PROPERTIES
|
||||
OUTPUT_NAME cmex
|
||||
RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/${CMAKE_INSTALL_BINDIR}
|
||||
)
|
||||
|
||||
# Путь поиска библиотек внутри проекта
|
||||
link_directories(${CMAKE_INSTALL_LIBDIR})
|
||||
|
||||
# Сначала внутренние статические библиотеки
|
||||
target_link_libraries(${current_target} cmex_static)
|
||||
|
||||
# Правила для установки
|
||||
install(TARGETS ${current_target} RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})
|
||||
----
|
||||
|
||||
ПИШУ ЗДЕСЬ!!!
|
||||
|
||||
|
||||
== Подключение внешнего проекта
|
||||
|
||||
Loading…
Reference in New Issue
Block a user