CMake

Table of Contents

• Métodos de Integración
  • Usando FetchContent
  • Usando find_package
  • Usando git submodule
• Banderas CMake Opcionales
• Verificando la Integración

Esta página explica cómo depender de FTXUI usando CMake.

Métodos de Integración

Usando FetchContent

Este enfoque descarga FTXUI en tiempo de configuración y no requiere una instalación en todo el sistema.

include(FetchContent)
 
FetchContent_Declare(ftxui
  GIT_REPOSITORY https://github.com/ArthurSonzogni/FTXUI
  GIT_TAG v6.1.9  # Reemplazar con una versión, etiqueta o hash de commit
)
 
FetchContent_MakeAvailable(ftxui)
 
add_executable(main main.cpp)
target_link_libraries(main
  PRIVATE ftxui::screen
  PRIVATE ftxui::dom
  PRIVATE ftxui::component
)

Esto asegura compilaciones reproducibles y una fácil gestión de dependencias.

Usando find_package

Si FTXUI está instalado en todo el sistema o mediante un gestor de paquetes (por ejemplo, vcpkg o Conan), puede usar:

find_package(ftxui REQUIRED)
 
add_executable(main main.cpp)
target_link_libraries(main
  PRIVATE ftxui::screen
  PRIVATE ftxui::dom
  PRIVATE ftxui::component
)

Asegúrese de que el paquete sea visible en su CMAKE_PREFIX_PATH.

Usando git submodule

También puede agregar FTXUI como un submódulo de Git, manteniéndolo como parte de su repositorio:

git submodule add https://github.com/ArthurSonzogni/FTXUI external/ftxui
git submodule update --init --recursive

Al clonar un repositorio que ya incluye FTXUI como submódulo, asegúrese de obtener los submódulos con:

git clone --recurse-submodules <su-repositorio>
# O, si ya está clonado:
git submodule update --init --recursive

Luego, en su CMakeLists.txt:

add_subdirectory(external/ftxui)
 
add_executable(main main.cpp)
target_link_libraries(main
  PRIVATE ftxui::screen
  PRIVATE ftxui::dom
  PRIVATE ftxui::component
)

Este enfoque funciona bien si desea incluir FTXUI en su propio repositorio.

Banderas CMake Opcionales

FTXUI admite las siguientes opciones de CMake:

Opción	Descripción	Predeterminado
FTXUI_BUILD_EXAMPLES	Construir ejemplos incluidos	OFF
FTXUI_BUILD_DOCS	Construir la documentación	OFF
FTXUI_BUILD_TESTS	Habilitar pruebas	OFF
FTXUI_ENABLE_INSTALL	Generar objetivos de instalación	ON
FTXUI_MICROSOFT_TERMINAL_FALLBACK	Mejorar compatibilidad con Windows	ON/OFF

Para habilitar una opción:

cmake -DFTXUI_BUILD_EXAMPLES=ON ..

Verificando la Integración

Para confirmar que la configuración funciona, compile y ejecute un ejemplo mínimo. Si necesita una plantilla completa, consulte: ftxui-starter

Anterior
Primeros pasos