feat: 1. Windows Desktop Backend firstly setup ; 2. Refactorize the CMake Scripts, to avoid multi instance of logger

fix:
1.  multi instance of logger due to static link
2.  quit stuck of CFDesktop due to deconstruction of static instance
3.  Windows Compile Issue, LLVM Compile Issue of Queue test, caused by
    big objects directly placed in stack.

Author: Charliechen114514

desktop/CMakeLists.txt

@@ -16,8 +16,14 @@ log_info("Desktop" "Creating unified CFDesktop shared library")
 add_library(CFDesktop_shared SHARED)
 
 # Export symbols for Windows DLL
+# CFLOG_STATIC_BUILD: cflogger symbols resolve as regular refs within the DLL
+# CFDESKTOP_STATIC_BUILD: NOT set here — desktop_run_session.cpp needs
+#   CF_DESKTOP_EXPORT = dllexport (CFDESKTOP_EXPORTS is defined on this target)
 if(WIN32)
-    target_compile_definitions(CFDesktop_shared PRIVATE CFDESKTOP_EXPORTS)
+    target_compile_definitions(CFDesktop_shared PRIVATE
+        CFDESKTOP_EXPORTS
+        CFLOG_STATIC_BUILD
+    )
 endif()
 
 # Set symbol visibility to hidden on Unix/Linux
@@ -42,6 +48,12 @@ set(CFDESKTOP_STATIC_LIBS
     cfasciiart
     CFDesktopMain
     CFDesktopUi
+    cf_desktop_render
+)
+
+# Sources compiled directly into the DLL (with CFDESKTOP_EXPORTS defined)
+target_sources(CFDesktop_shared PRIVATE
+    ${CMAKE_CURRENT_SOURCE_DIR}/desktop_run_session.cpp
 )
 
 # Link all static libraries using --whole-archive
@@ -86,14 +98,14 @@ endif()
 # Add alias for consistent naming
 add_library(CFDesktop::lib ALIAS CFDesktop_shared)
 # ============================================================
-# Main executable (links against the shared library)
+# Main executable — thin shell that calls into the DLL
 # ============================================================
-add_executable(CFDesktop main.cpp desktop_entry.cpp)
+add_executable(CFDesktop main.cpp)
 
-# Link against the unified CFDesktop shared library
-# Also link CFDesktopEarlySession directly for symbols not exported from DLL
+# The EXE only links the DLL import library.
+# All code (CFDesktopMain, desktop_entry, init stages, etc.) lives in the DLL.
 target_link_libraries(CFDesktop PRIVATE
-    CFDesktop_shared CFDesktopMain cflogger cfbase
+    CFDesktop_shared
 )
 
 log_info("Desktop Buildings" "Configuring Desktop Buildings Done")

desktop/base/logger/CMakeLists.txt

@@ -29,3 +29,23 @@ target_link_libraries(cflogger PUBLIC
 
 # Alias for consistent naming
 add_library(CFDesktop::logger ALIAS cflogger)
+
+# =============================================================================
+# cflogger_headers — Header-only INTERFACE library
+# =============================================================================
+# DLL-internal modules that only call the public API (cflog.h free functions)
+# should link this instead of the static lib, to avoid duplicating compiled
+# symbols. Only CFDesktop_shared (via --whole-archive) and CFDesktopMain
+# (PRIVATE, for internal classes like FileSink/ConsoleSink) link the real lib.
+add_library(cflogger_headers INTERFACE)
+target_include_directories(cflogger_headers INTERFACE
+    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+    $<INSTALL_INTERFACE:include>
+)
+target_link_libraries(cflogger_headers INTERFACE CFDesktop::base)
+add_library(CFDesktop::logger_headers ALIAS cflogger_headers)
+
+# cflogger itself: mark symbols for DLL export when building on Windows
+if(WIN32)
+    target_compile_definitions(cflogger PRIVATE CFLOG_BUILDING)
+endif()

desktop/base/logger/include/cflog.h

@@ -6,26 +6,27 @@
 #pragma once
 
 #include "cflog/cflog.hpp"
+#include "cflog/cflog_export.h"
 #include <format>
 #include <source_location>
 #include <string_view>
 
 namespace cf::log {
 
-void trace(std::string_view msg, std::string_view tag = "CFLog",
-           std::source_location loc = std::source_location::current());
+CFLOG_API void trace(std::string_view msg, std::string_view tag = "CFLog",
+                     std::source_location loc = std::source_location::current());
 
-void debug(std::string_view msg, std::string_view tag = "CFLog",
-           std::source_location loc = std::source_location::current());
+CFLOG_API void debug(std::string_view msg, std::string_view tag = "CFLog",
+                     std::source_location loc = std::source_location::current());
 
-void info(std::string_view msg, std::string_view tag = "CFLog",
-          std::source_location loc = std::source_location::current());
+CFLOG_API void info(std::string_view msg, std::string_view tag = "CFLog",
+                    std::source_location loc = std::source_location::current());
 
-void warning(std::string_view msg, std::string_view tag = "CFLog",
-             std::source_location loc = std::source_location::current());
+CFLOG_API void warning(std::string_view msg, std::string_view tag = "CFLog",
+                       std::source_location loc = std::source_location::current());
 
-void error(std::string_view msg, std::string_view tag = "CFLog",
-           std::source_location loc = std::source_location::current());
+CFLOG_API void error(std::string_view msg, std::string_view tag = "CFLog",
+                     std::source_location loc = std::source_location::current());
 
 // ============================================================================
 // Formatted logging functions (std::format style)
@@ -203,8 +204,8 @@ template <typename... Args> struct traceftag {
         detail::log_helper<level::TRACE, Args...>{tag, fmt, std::forward<Args>(args)..., loc};
     }
 };
-template <typename... Args>
-traceftag(std::string_view, std::format_string<Args...>, Args&&...) -> traceftag<Args...>;
+template <typename... Args> traceftag(std::string_view, std::format_string<Args...>, Args&&...)
+    -> traceftag<Args...>;
 
 /**
  * @brief  Temporary object for debug-level formatted logging with custom tag.
@@ -229,8 +230,8 @@ template <typename... Args> struct debugftag {
         detail::log_helper<level::DEBUG, Args...>{tag, fmt, std::forward<Args>(args)..., loc};
     }
 };
-template <typename... Args>
-debugftag(std::string_view, std::format_string<Args...>, Args&&...) -> debugftag<Args...>;
+template <typename... Args> debugftag(std::string_view, std::format_string<Args...>, Args&&...)
+    -> debugftag<Args...>;
 
 /**
  * @brief  Temporary object for info-level formatted logging with custom tag.
@@ -255,8 +256,8 @@ template <typename... Args> struct infoftag {
         detail::log_helper<level::INFO, Args...>{tag, fmt, std::forward<Args>(args)..., loc};
     }
 };
-template <typename... Args>
-infoftag(std::string_view, std::format_string<Args...>, Args&&...) -> infoftag<Args...>;
+template <typename... Args> infoftag(std::string_view, std::format_string<Args...>, Args&&...)
+    -> infoftag<Args...>;
 
 /**
  * @brief  Temporary object for warning-level formatted logging with custom tag.
@@ -281,8 +282,8 @@ template <typename... Args> struct warningftag {
         detail::log_helper<level::WARNING, Args...>{tag, fmt, std::forward<Args>(args)..., loc};
     }
 };
-template <typename... Args>
-warningftag(std::string_view, std::format_string<Args...>, Args&&...) -> warningftag<Args...>;
+template <typename... Args> warningftag(std::string_view, std::format_string<Args...>, Args&&...)
+    -> warningftag<Args...>;
 
 /**
  * @brief  Temporary object for error-level formatted logging with custom tag.
@@ -307,34 +308,36 @@ template <typename... Args> struct errorftag {
         detail::log_helper<level::ERROR, Args...>{tag, fmt, std::forward<Args>(args)..., loc};
     }
 };
-template <typename... Args>
-errorftag(std::string_view, std::format_string<Args...>, Args&&...) -> errorftag<Args...>;
+template <typename... Args> errorftag(std::string_view, std::format_string<Args...>, Args&&...)
+    -> errorftag<Args...>;
 
 /**
  * @brief  Sets the minimum log level.
  *
  * Only messages at or above this level are processed.
  *
  * @param[in] lvl Minimum log level to set.
+ * @return    None
  * @throws     None
  * @note       None
  * @warning    None
  * @since      N/A
  * @ingroup    cflog
  */
-void set_level(level lvl);
+CFLOG_API void set_level(level lvl);
 
 /**
  * @brief  Flushes all pending log messages.
  *
  * Blocks until all queued messages are written to sinks.
  *
+ * @return    None
  * @throws     None
  * @note       This operation may block if the queue is full.
  * @warning    None
  * @since      N/A
  * @ingroup    cflog
  */
-void flush();
+CFLOG_API void flush();
 
 } // namespace cf::log

desktop/base/logger/include/cflog/cflog.hpp

@@ -14,6 +14,7 @@
 #pragma once
 
 #include "base/singleton/simple_singleton.hpp"
+#include "cflog_export.h"
 #include "cflog_level.hpp"
 #include <atomic>
 #include <memory>
@@ -40,7 +41,7 @@ class ISink;
  * logger.log(level::INFO, "Hello, world!", "MyApp", std::source_location::current());
  * @endcode
  */
-class Logger : public SimpleSingleton<Logger> {
+class CFLOG_API Logger {
   public:
     /**
      * @brief  Constructor.
@@ -62,7 +63,16 @@ class Logger : public SimpleSingleton<Logger> {
      */
     ~Logger();
 
-    /* Native Interface */
+    /**
+     * @brief   Intentionally leaks to avoid deadlock on Ctrl+C
+     *          that occurs with Meyer Singletons.
+     *
+     * @return Logger&
+     */
+    static Logger& instance() {
+        static Logger* inst = new Logger();
+        return *inst;
+    }
 
     /**
      * @brief  Logs a message with the specified level and metadata.

desktop/base/logger/include/cflog/cflog_export.h

@@ -0,0 +1,21 @@
+/**
+ * @file    cflog_export.h
+ * @brief   Export/import macros for CFLog library symbols.
+ *
+ * When building cflogger (static lib merged into CFDesktop_shared DLL),
+ * CFLOG_BUILDING is defined so symbols are marked dllexport.
+ * When consuming from the EXE or other targets, symbols are marked dllimport.
+ */
+#pragma once
+
+#if defined(_WIN32) || defined(_MSC_VER)
+#    ifdef CFLOG_STATIC_BUILD
+#        define CFLOG_API
+#    elif defined(CFLOG_BUILDING)
+#        define CFLOG_API __declspec(dllexport)
+#    else
+#        define CFLOG_API __declspec(dllimport)
+#    endif
+#else
+#    define CFLOG_API __attribute__((visibility("default")))
+#endif

desktop/base/logger/include/cflog/cflog_level.hpp

@@ -34,12 +34,10 @@ enum class level {
 };
 
 static constexpr const level kDEFAULT_LEVEL =
-#ifdef CFDESKTOP_DEBUG_BUILD
+#if defined(CFDESKTOP_DEBUG_BUILD) || defined(CFDESKTOP_DEVELOP_BUILD)
     level::TRACE;
-#elif defined(CFDESKTOP_DEVELOP_BUILD)
-    level::INFO;
 #else
-    level::DEBUG;
+    level::INFO;
 #endif
 
 /**

desktop/base/logger/include/cflog/formatter/console_formatter.h

@@ -13,6 +13,7 @@
  */
 #pragma once
 
+#include "cflog/cflog_export.h"
 #include "cflog/cflog_format.h"
 #include "cflog/cflog_format_config.h"
 #include <memory>
@@ -34,7 +35,7 @@ enum class level : int;
  *
  * @note   Thread-safe for format operations.
  */
-class AsciiColorFormatter : public IFormatter {
+class CFLOG_API AsciiColorFormatter : public IFormatter {
   public:
     /**
      * @brief  Constructs a new AsciiColorFormatter.

desktop/base/logger/include/cflog/formatter/file_formatter.h

@@ -13,6 +13,7 @@
  */
 #pragma once
 
+#include "cflog/cflog_export.h"
 #include "cflog/cflog_format.h"
 #include "cflog/cflog_format_config.h"
 #include <memory>
@@ -37,7 +38,7 @@ enum class level : int;
  * @note   COLOR flag is always ignored since ANSI escape codes
  *         should not appear in log files.
  */
-class FileFormatter : public IFormatter {
+class CFLOG_API FileFormatter : public IFormatter {
   public:
     /**
      * @brief  Constructs a new FileFormatter.

desktop/base/logger/include/cflog/sinks/console_sink.h

@@ -13,6 +13,7 @@
  */
 #pragma once
 
+#include "cflog/cflog_export.h"
 #include "cflog/cflog_sink.h"
 
 namespace cf::log {
@@ -33,7 +34,7 @@ namespace cf::log {
  * sink.flush();
  * @endcode
  */
-class ConsoleSink : public ISink {
+class CFLOG_API ConsoleSink : public ISink {
   public:
     /**
      * @brief  Writes a log record to the console.

desktop/base/logger/include/cflog/sinks/file_sink.h

@@ -12,6 +12,7 @@
  */
 #pragma once
 
+#include "cflog/cflog_export.h"
 #include "cflog/cflog_sink.h"
 #include <fstream>
 #include <string>
@@ -45,7 +46,7 @@ enum class OpenMode {
  * sink.flush();
  * @endcode
  */
-class FileSink : public ISink {
+class CFLOG_API FileSink : public ISink {
   public:
     /**
      * @brief  Constructs a new FileSink.