[fix] Coverity: QPL_VERSION macro is now defined in a CMake-generated file (#1246)

The following warnings appeared in Coverity build log on Windows:
```
"sources/middle-layer/util/library_version.cpp", line 12: warning #7: unrecognized token
      return QPL_VERSION;
             ^
```
The issue is related to the fact that `QPL_VERSION` macro is defined using `/D` command-line option:
```
target_compile_definitions(middle_layer_lib
        PUBLIC QPL_VERSION="${CMAKE_PROJECT_VERSION}"
        PUBLIC $<$<C_COMPILER_ID:MSVC>:_ENABLE_EXTENDED_ALIGNED_STORAGE>
```

So it is passed to the compiler command line as...
* `-DQPL_VERSION=\"1.8.0\"` (in case of a regular build)
* `"-DQPL_VERSION=\"1.8.0\""` (in case of a Coverity build)

Since the value of this macro is a string literal, quoting around it requires escaping. It seems that in case of Coverity escaping should be different to achieve the same result. Also it may be [different in case of different shells](https://cmake.org/pipermail/cmake/2007-June/014611.html).

So `QPL_VERSION` macro definition was moved from command-line options (using a function `target_compile_definitions` in CMake) to a CMake-generated header file `project_version.h` (using a template file `project_version.h.in` and a function `configure_file()` in CMake) which is a typical approach to organize this functionality.

Three new macro definitions were added to this file (besides `QPL_VERSION`):
* `QPL_VERSION_MAJOR`
* `QPL_VERSION_MINOR`
* `QPL_VERSION_PATCH`

This generated header file is installed by CMake to the install folder just like other header files in `/include/qpl/c_api`.

Author: tizmajlo

.gitignore

@@ -18,3 +18,6 @@ qpl-*.tar.*z
 
 # RPM build
 qpl*.rpm
+
+# CMake-generated header file containing version information
+/include/qpl/c_api/project_version.h

include/qpl/c_api/project_version.h.in

@@ -0,0 +1,35 @@
+/*******************************************************************************
+ * Copyright (C) 2025 Intel Corporation
+ *
+ * SPDX-License-Identifier: MIT
+ ******************************************************************************/
+
+/*
+ *  Intel® Query Processing Library (Intel® QPL)
+ *  Job API (public C API)
+ */
+
+#ifndef QPL_C_API_VERSIONS_H
+#define QPL_C_API_VERSIONS_H
+
+/**
+ * QPL major version
+ */
+#define QPL_VERSION_MAJOR @QPL_VERSION_MAJOR@
+
+/**
+ * QPL minor version
+ */
+#define QPL_VERSION_MINOR @QPL_VERSION_MINOR@
+
+/**
+ * QPL patch version
+ */
+#define QPL_VERSION_PATCH @QPL_VERSION_PATCH@
+
+/**
+ * QPL version as a string: "major.minor.patch"
+ */
+#define QPL_VERSION "@QPL_VERSION@"
+
+#endif //QPL_C_API_VERSIONS_H

include/qpl/c_api/version.h

@@ -17,6 +17,7 @@
 #endif
 
 #include "qpl/c_api/defs.h"
+#include "qpl/c_api/project_version.h"
 
 #ifdef __cplusplus
 extern "C" {

sources/c_api/CMakeLists.txt

@@ -26,6 +26,11 @@ file(GLOB QPL_C_API_SRC
 
 add_library(qpl_c_api OBJECT ${QPL_C_API_SRC})
 
+# Add CMake-generated header file `project_version.h` containing version information (like `QPL_VERSION` macro definition)
+set (qpl_versions_header "project_version.h")
+set (qpl_versions_header_path "${QPL_PROJECT_DIR}/include/qpl/c_api/${qpl_versions_header}")
+configure_file("${qpl_versions_header_path}.in" "${qpl_versions_header_path}" @ONLY)
+
 target_include_directories(qpl_c_api
         PUBLIC $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
         PUBLIC $<BUILD_INTERFACE:${QPL_PROJECT_DIR}/include/> $<INSTALL_INTERFACE:include>

sources/middle-layer/CMakeLists.txt

@@ -51,7 +51,6 @@ if (CMAKE_C_COMPILER_ID STREQUAL "Clang")
 endif ()
 
 target_compile_definitions(middle_layer_lib
-        PUBLIC QPL_VERSION="${CMAKE_PROJECT_VERSION}"
         PUBLIC $<$<C_COMPILER_ID:MSVC>:_ENABLE_EXTENDED_ALIGNED_STORAGE>
         PUBLIC $<$<BOOL:${LOG_HW_INIT}>:LOG_HW_INIT>
         PUBLIC $<$<BOOL:${QPL_EXPERIMENTAL_LOG_IAA}>:QPL_EXPERIMENTAL_LOG_IAA>

sources/middle-layer/dispatcher/hw_dispatcher.cpp

@@ -11,6 +11,8 @@
 
 #include "hw_dispatcher.hpp"
 
+#include "qpl/c_api/project_version.h"
+
 #if defined(__linux__)
 
 #endif