refactor(compression): Unify compression APIs with libarchive backend

Replace fragmented compression utilities (QGCLZMA, QGCZlib, QGCZip) with
a unified QGCCompression interface backed by libarchive.

Changes:
- Add QGCCompression namespace with format detection and unified API
- Add QGClibarchive for ZIP archive operations via libarchive
- Support for GZIP, XZ, ZSTD, ZIP, TAR formats with auto-detection
- Add comprehensive compression library stack via CPM:
  - zlib-ng 2.3.2 (optimized zlib replacement)
  - xz/liblzma 5.8.2 (LZMA/XZ compression)
  - zstd 1.5.7 (Zstandard compression)
  - lz4 1.10.0 (fast compression)
  - bzip2 1.1.0 (bzip2 compression)
  - libarchive 3.8.4 (archive handling)
- Update callers to use new unified API
- Consolidate tests into single QGCCompressionTest
- Remove deprecated QGCLZMA, QGCZlib, QGCZip modules

The new API simplifies usage:
- QGCCompression::decompressIfNeeded() auto-detects and decompresses
- QGCCompression::decompressFile() for explicit decompression
- QGCCompression::zipDirectory() / unzipFile() for archives
- Format detection from extension or magic bytes

Author: HTRamsey

src/Camera/VehicleCameraControl.cc

@@ -22,7 +22,7 @@
 #include "VideoManager.h"
 #include "QGCCameraManager.h"
 #include "FTPManager.h"
-#include "QGCLZMA.h"
+#include "QGCCompression.h"
 #include "QGCCorePlugin.h"
 #include "Vehicle.h"
 #include "LinkInterface.h"
@@ -2190,16 +2190,9 @@ void VehicleCameraControl::_ftpDownloadComplete(const QString& fileName, const Q
 
     disconnect(_vehicle->ftpManager(), &FTPManager::downloadComplete, this, &VehicleCameraControl::_ftpDownloadComplete);
 
-    QString outputFileName = fileName;
-
-    if (fileName.endsWith(".lzma", Qt::CaseInsensitive) || fileName.endsWith(".xz", Qt::CaseInsensitive)) {
-        outputFileName = fileName.left(fileName.lastIndexOf("."));
-        if (QGCLZMA::inflateLZMAFile(fileName, outputFileName)) {
-            QFile(fileName).remove();
-        } else {
-            qCWarning(CameraControlLog) << "Inflate of compressed xml failed" << fileName;
-            outputFileName.clear();
-        }
+    QString outputFileName = QGCCompression::decompressIfNeeded(fileName);
+    if (outputFileName.isEmpty()) {
+        qCWarning(CameraControlLog) << "Inflate of compressed xml failed" << fileName;
     }
 
     QFile xmlFile(outputFileName);

src/Utilities/Compression/CMakeLists.txt

@@ -5,12 +5,12 @@
 
 target_sources(${CMAKE_PROJECT_NAME}
     PRIVATE
-        QGCLZMA.cc
-        QGCLZMA.h
-        QGCZip.cc
-        QGCZip.h
-        QGCZlib.cc
-        QGCZlib.h
+        # Unified compression interface
+        QGCCompression.cc
+        QGCCompression.h
+        # libarchive-based implementation
+        QGClibarchive.cc
+        QGClibarchive.h
 )
 
 target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR})
@@ -22,17 +22,24 @@ target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_
 # Platform-specific zlib options
 set(ZLIB_EXTRA_OPTIONS)
 if(WIN32)
-    set(ZLIB_EXTRA_OPTIONS
-        "ZLIB_INSTALL_COMPAT_DLL OFF"
-    )
+    list(APPEND ZLIB_EXTRA_OPTIONS "ZLIB_INSTALL_COMPAT_DLL OFF")
+endif()
+
+list(APPEND ZLIB_EXTRA_OPTIONS "WITH_NATIVE_INSTRUCTIONS OFF")
+
+# Disable arch-specific optimizations when cross-compiling (x86 asm fails on ARM targets)
+if(APPLE OR ANDROID OR CMAKE_CROSSCOMPILING)
+    list(APPEND ZLIB_EXTRA_OPTIONS "WITH_OPTIM OFF")
 endif()
 
 CPMAddPackage(
     NAME zlib
-    GITHUB_REPOSITORY madler/zlib
-    GIT_TAG develop
+    GITHUB_REPOSITORY zlib-ng/zlib-ng
+    GIT_TAG 2.3.2
     OPTIONS
+        "ZLIB_COMPAT ON"
         "ZLIB_BUILD_TESTING OFF"
+        "WITH_GTEST OFF"
         "ZLIB_BUILD_SHARED OFF"
         "ZLIB_BUILD_STATIC ON"
         "ZLIB_BUILD_MINIZIP OFF"
@@ -41,48 +48,202 @@ CPMAddPackage(
         "${ZLIB_EXTRA_OPTIONS}"
 )
 
-target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE ZLIB::ZLIBSTATIC)
+target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE zlibstatic)
+
+# Export ZLIB paths for libarchive (prevent using system zlib during cross-compile)
+set(ZLIB_INCLUDE_DIR "${zlib_SOURCE_DIR};${zlib_BINARY_DIR}" CACHE PATH "" FORCE)
+set(ZLIB_LIBRARY "zlibstatic" CACHE STRING "" FORCE)
+set(ZLIB_LIBRARIES "zlibstatic" CACHE STRING "" FORCE)
+set(ZLIB_FOUND TRUE CACHE BOOL "" FORCE)
+# libarchive's FindZLIB may expect ZLIB::ZLIB target
+if(NOT TARGET ZLIB::ZLIB)
+    add_library(ZLIB::ZLIB ALIAS zlibstatic)
+endif()
 
 # ============================================================================
-# XZ (LZMA) Integration
+# XZ (LZMA) Integration - liblzma from xz-utils
 # ============================================================================
 
 CPMAddPackage(
-    NAME xz-embedded
-    VERSION 2024-12-30
-    GITHUB_REPOSITORY tukaani-project/xz-embedded
+    NAME xz
+    VERSION 5.8.2
+    GITHUB_REPOSITORY tukaani-project/xz
+    GIT_TAG v5.8.2
     OPTIONS
-        "BUILD_SHAPELIB_CONTRIB OFF"
-        "BUILD_APPS OFF"
-        "BUILD_TESTING OFF"
+        "BUILD_SHARED_LIBS OFF"
+        "XZ_TOOL_XZ OFF"
+        "XZ_TOOL_XZDEC OFF"
+        "XZ_TOOL_LZMADEC OFF"
+        "XZ_TOOL_LZMAINFO OFF"
+        "XZ_TOOL_SCRIPTS OFF"
+        "XZ_NLS OFF"
+        "XZ_THREADS no"
+        "XZ_SMALL OFF"
+        "XZ_DOC OFF"
+        "XZ_DOXYGEN OFF"
 )
 
-# Build XZ library from source
-qt_add_library(xz STATIC
-    ${xz-embedded_SOURCE_DIR}/linux/include/linux/xz.h
-    ${xz-embedded_SOURCE_DIR}/linux/lib/xz/xz_crc32.c
-    ${xz-embedded_SOURCE_DIR}/linux/lib/xz/xz_crc64.c
-    ${xz-embedded_SOURCE_DIR}/linux/lib/xz/xz_dec_lzma2.c
-    ${xz-embedded_SOURCE_DIR}/linux/lib/xz/xz_dec_stream.c
-    ${xz-embedded_SOURCE_DIR}/linux/lib/xz/xz_lzma2.h
-    ${xz-embedded_SOURCE_DIR}/linux/lib/xz/xz_private.h
-    ${xz-embedded_SOURCE_DIR}/linux/lib/xz/xz_stream.h
-    ${xz-embedded_SOURCE_DIR}/userspace/xz_config.h
+if(TARGET liblzma)
+    target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE liblzma)
+    # Help libarchive find our liblzma (prevent using system liblzma during cross-compile)
+    set(LIBLZMA_INCLUDE_DIR "${xz_SOURCE_DIR}/src/liblzma/api" CACHE PATH "" FORCE)
+    set(LIBLZMA_LIBRARY "liblzma" CACHE STRING "" FORCE)
+    set(LIBLZMA_FOUND TRUE CACHE BOOL "" FORCE)
+    set(LIBLZMA_LIBRARIES "liblzma" CACHE STRING "" FORCE)
+    set(LIBLZMA_HAS_AUTO_DECODER TRUE CACHE BOOL "" FORCE)
+    set(LIBLZMA_HAS_EASY_ENCODER TRUE CACHE BOOL "" FORCE)
+    set(LIBLZMA_HAS_LZMA_PRESET TRUE CACHE BOOL "" FORCE)
+    set(LibLZMA_FOUND TRUE CACHE BOOL "" FORCE)
+    # libarchive's FindLibLZMA expects LibLZMA::LibLZMA target
+    if(NOT TARGET LibLZMA::LibLZMA)
+        add_library(LibLZMA::LibLZMA ALIAS liblzma)
+    endif()
+    message(STATUS "liblzma support enabled")
+else()
+    message(FATAL_ERROR "liblzma target not found")
+endif()
+
+# ============================================================================
+# Zstandard (ZSTD) Integration
+# ============================================================================
+
+CPMAddPackage(
+    NAME zstd
+    VERSION 1.5.7
+    GITHUB_REPOSITORY facebook/zstd
+    GIT_TAG v1.5.7
+    SOURCE_SUBDIR build/cmake
+    OPTIONS
+        "ZSTD_BUILD_PROGRAMS OFF"
+        "ZSTD_BUILD_TESTS OFF"
+        "ZSTD_BUILD_CONTRIB OFF"
+        "ZSTD_BUILD_SHARED OFF"
+        "ZSTD_BUILD_STATIC ON"
+        "ZSTD_MULTITHREAD_SUPPORT OFF"
 )
 
-target_include_directories(xz
-    PUBLIC
-        ${xz-embedded_SOURCE_DIR}/linux/include/linux
-    PRIVATE
-        ${xz-embedded_SOURCE_DIR}/linux/lib/xz
-        ${xz-embedded_SOURCE_DIR}/userspace
+if(TARGET libzstd_static)
+    target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE libzstd_static)
+    target_compile_definitions(${CMAKE_PROJECT_NAME} PRIVATE QGC_ZSTD_ENABLED)
+    # Help libarchive find our ZSTD (prevent using system zstd during cross-compile)
+    set(ZSTD_INCLUDE_DIR "${zstd_SOURCE_DIR}/lib" CACHE PATH "" FORCE)
+    set(ZSTD_LIBRARY "libzstd_static" CACHE STRING "" FORCE)
+    set(ZSTD_LIBRARIES "libzstd_static" CACHE STRING "" FORCE)
+    set(ZSTD_FOUND TRUE CACHE BOOL "" FORCE)
+    set(Zstd_FOUND TRUE CACHE BOOL "" FORCE)
+    # libarchive's FindZstd.cmake expects Zstd::Zstd target
+    if(NOT TARGET Zstd::Zstd)
+        add_library(Zstd::Zstd ALIAS libzstd_static)
+    endif()
+    if(NOT TARGET zstd::libzstd_static)
+        add_library(zstd::libzstd_static ALIAS libzstd_static)
+    endif()
+    message(STATUS "Zstandard support enabled")
+else()
+    message(WARNING "zstd target not found, ZSTD compression will be disabled")
+endif()
+
+# ============================================================================
+# LZ4 Integration (Fast compression)
+# ============================================================================
+
+CPMAddPackage(
+    NAME lz4
+    VERSION 1.10.0
+    GITHUB_REPOSITORY lz4/lz4
+    GIT_TAG v1.10.0
+    SOURCE_SUBDIR build/cmake
+    OPTIONS
+        "LZ4_BUILD_CLI OFF"
+        "LZ4_BUILD_LEGACY_LZ4C OFF"
+        "BUILD_SHARED_LIBS OFF"
+        "BUILD_STATIC_LIBS ON"
 )
 
-target_compile_definitions(xz
-    PRIVATE
-        XZ_DEC_ANY_CHECK
-    PUBLIC
-        XZ_USE_CRC64
+if(TARGET lz4_static)
+    # Help libarchive find our LZ4
+    set(LZ4_INCLUDE_DIR "${lz4_SOURCE_DIR}/lib" CACHE PATH "" FORCE)
+    set(LZ4_LIBRARY "lz4_static" CACHE STRING "" FORCE)
+    set(LZ4_FOUND TRUE CACHE BOOL "" FORCE)
+    if(NOT TARGET LZ4::LZ4)
+        add_library(LZ4::LZ4 ALIAS lz4_static)
+    endif()
+    message(STATUS "LZ4 support enabled")
+else()
+    message(WARNING "LZ4 target not found")
+endif()
+
+# ============================================================================
+# BZip2 Integration (official repo with CMake support)
+# ============================================================================
+
+CPMAddPackage(
+    NAME bzip2
+    VERSION 1.0.8
+    GIT_REPOSITORY https://gitlab.com/bzip2/bzip2.git
+    GIT_TAG 66c46b8c9436613fd81bc5d03f63a61933a4dcc3  # master (tagged releases lack CMake)
+    OPTIONS
+        "ENABLE_LIB_ONLY ON"
+        "ENABLE_SHARED_LIB OFF"
+        "ENABLE_STATIC_LIB ON"
+        "ENABLE_APP OFF"
+        "ENABLE_DOCS OFF"
+        "ENABLE_EXAMPLES OFF"
+        "ENABLE_TESTS OFF"
 )
 
-target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE xz)
+if(TARGET bz2_static)
+    # Help libarchive/minizip find our BZip2
+    set(BZIP2_INCLUDE_DIR "${bzip2_SOURCE_DIR}" CACHE PATH "" FORCE)
+    set(BZIP2_LIBRARY "bz2_static" CACHE STRING "" FORCE)
+    set(BZIP2_FOUND TRUE CACHE BOOL "" FORCE)
+    set(BZIP2_LIBRARIES "bz2_static" CACHE STRING "" FORCE)
+    if(NOT TARGET BZip2::BZip2)
+        add_library(BZip2::BZip2 ALIAS bz2_static)
+    endif()
+    message(STATUS "BZip2 support enabled")
+else()
+    message(WARNING "BZip2 target not found")
+endif()
+
+# ============================================================================
+# libarchive Integration (Full-featured C library)
+# ============================================================================
+
+CPMAddPackage(
+    NAME libarchive
+    VERSION 3.8.4
+    GITHUB_REPOSITORY libarchive/libarchive
+    GIT_TAG v3.8.4
+    OPTIONS
+        "ENABLE_TEST OFF"
+        "ENABLE_INSTALL OFF"
+        "ENABLE_TAR OFF"
+        "ENABLE_CPIO OFF"
+        "ENABLE_CAT OFF"
+        "ENABLE_UNZIP OFF"
+        "ENABLE_ACL OFF"
+        "ENABLE_XATTR OFF"
+        "ENABLE_ICONV OFF"
+        "ENABLE_PCRE2POSIX OFF"
+        "ENABLE_LIBXML2 OFF"
+        "ENABLE_EXPAT OFF"
+        "ENABLE_ZLIB ON"
+        "ENABLE_LZMA ON"
+        "ENABLE_BZip2 ON"
+        "ENABLE_ZSTD ON"
+        "ENABLE_LIBB2 OFF"
+        "ENABLE_LZ4 ON"
+        "ENABLE_LIBMD OFF"
+        "ENABLE_OPENSSL OFF"
+        "ENABLE_MBEDTLS OFF"
+)
+
+if(TARGET archive_static)
+    target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE archive_static)
+    target_compile_definitions(${CMAKE_PROJECT_NAME} PRIVATE QGC_LIBARCHIVE_ENABLED LIBARCHIVE_STATIC)
+    message(STATUS "libarchive support enabled")
+else()
+    message(WARNING "libarchive target not found, QGCZipLibarchive will be disabled")
+endif()
+