refs #12066 - add online-help.qhc target to CMake if `qhelpgenerato…

…r` is available

cmake/findDependencies.cmake

@@ -28,6 +28,17 @@ if(BUILD_GUI)
         find_package(Qt5 COMPONENTS ${qt_components} REQUIRED)
         set(QT_VERSION "${Qt5Core_VERSION_STRING}")
     endif()
+
+    find_program(QHELPGENERATOR qhelpgenerator)
+    if(NOT QHELPGENERATOR)
+        # TODO: how to properly get the Qt binary folder?
+        # piggy-back off Qt::qmake for now as it should be in the same folder as the binary we are looking for
+        get_target_property(_qmake_executable Qt::qmake IMPORTED_LOCATION)
+        get_filename_component(_qt_bin_dir ${_qmake_executable} DIRECTORY)
+        message(STATUS "qhelpgenerator not found in PATH - trying ${_qt_bin_dir}")
+        # cannot be mandatory since qhelpgenerator is missing from the official qttools Linux package - https://bugreports.qt.io/browse/QTBUG-116168
+        find_program(QHELPGENERATOR qhelpgenerator HINTS ${_qt_bin_dir})
+    endif()
 endif()
 
 if(HAVE_RULES)

cmake/printInfo.cmake

@@ -73,6 +73,7 @@ if(BUILD_GUI)
         message(STATUS "Qt5Core_LIBRARIES =     ${Qt5Core_LIBRARIES}")
         message(STATUS "Qt5Core_INCLUDE_DIRS =  ${Qt5Core_INCLUDE_DIRS}")
     endif()
+    message(STATUS "QHELPGENERATOR =        ${QHELPGENERATOR}")
 endif()
 message(STATUS)
 message(STATUS "HAVE_RULES =            ${HAVE_RULES}")

gui/CMakeLists.txt

@@ -71,6 +71,12 @@ CheckOptions:
         target_compile_options_safe(cppcheck-gui -Wno-redundant-parens)
     endif()
 
+    if (QHELPGENERATOR)
+        # TODO: generate in CMAKE_BINARY_DIR folder
+        add_custom_target(online-help.qhc ${QHELPGENERATOR} ${CMAKE_CURRENT_SOURCE_DIR}/help/online-help.qhcp -o ${CMAKE_CURRENT_SOURCE_DIR}/help/online-help.qhc)
+        add_dependencies(cppcheck-gui online-help.qhc)
+    endif()
+
     install(TARGETS cppcheck-gui RUNTIME DESTINATION ${CMAKE_INSTALL_FULL_BINDIR} COMPONENT applications)
     install(FILES ${qms} DESTINATION ${CMAKE_INSTALL_FULL_BINDIR} COMPONENT applications)