CMake: Como fazer git submodule update --init automaticamente

Quando você está usando git submodules no seu projeto CMake, você pode querer garantir que os submodules sejam inicializados e atualizados automaticamente ao configurar o projeto. Você pode conseguir isso adicionando um comando customizado no seu arquivo CMakeLists.txt.

CMakeLists.txt
# Tentar inicializar git submodules automaticamente durante a configuração para que
# consumidores downstream não precisem de uma etapa manual separada. Isso é best-effort
# e só será executado quando Git estiver disponível.
find_package(Git QUIET)
if(GIT_FOUND)
  message(STATUS "Git found: initializing/updating submodules...")
  execute_process(
    COMMAND ${GIT_EXECUTABLE} submodule update --init --recursive
    WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
    RESULT_VARIABLE _git_submodule_result
    OUTPUT_QUIET ERROR_QUIET
  )
  if(NOT _git_submodule_result EQUAL 0)
    message(WARNING "git submodule update --init --recursive failed with exit code ${_git_submodule_result}")
  endif()
else()
  message(STATUS "Git not found; skipping automatic git submodule initialization")
endif()

Check out similar posts by category: CMake, Git