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 v7.0.3  # Replace with a version, tag, or commit hash
)
 
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 <your-repo>
# Or, if already cloned:
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	Compila los ejemplos incluidos	OFF
FTXUI_BUILD_DOCS	Compila la documentación	OFF
FTXUI_BUILD_TESTS	Habilita las pruebas	OFF
FTXUI_ENABLE_INSTALL	Genera los objetivos de instalación	ON

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