From a84a6e8ff637beeb47b867db6160d953bf84826f Mon Sep 17 00:00:00 2001 From: Torsten Wierschin Date: Fri, 13 Nov 2026 14:36:48 +0000 Subject: [PATCH] Add Release 2 README with 37 targets (Krypto absent) - Document Release 2 scope: 37 targets - AP3/AP4/AP9 modules + Release 1 (TetraIF/Z/Lts) - Build instructions with aqt install-qt - DEB package list (5 packages) - Known absent: Krypto module - Docker image: guez-release2:2.0 --- .../qt6-migrated-legatus/README_RELEASE_2.md | 187 ++++++++++++++++++ 1 file changed, 187 insertions(+) create mode 100644 qt6-after/qt6-migrated-legatus/README_RELEASE_2.md diff --git a/qt6-after/qt6-migrated-legatus/README_RELEASE_2.md b/qt6-after/qt6-migrated-legatus/README_RELEASE_2.md new file mode 100644 index 000000000..2d389eef2 --- /dev/null +++ b/qt6-after/qt6-migrated-legatus/README_RELEASE_2.md @@ -0,0 +1,187 @@ +# Guez Release 2 - Qt6 Migration + +**Version:** 2.0 +**Date:** 2026-11-26 +**Branch:** story/create-release-two-delivery-25_11_2026 + +## Overview + +Release 2 of the Guez project represents the Qt6-migrated version of the AP3, AP4, and AP9 modules, plus all Release 1 components (TetraIF, Z module, Lts/Common). + +**Total Scope:** 37 targets (Krypto excluded - absent from codebase) + +## Module Scope + +### AP3 — Shared Libraries (Lts/Common) +- LtsUtils +- LtsWidgets +- LtsSession +- LtsPluginManager +- CodeGen (includes ngl_codegen tool) + +### AP4 — DDS Middleware +- Core +- DDSConnector +- Routing +- QosProfile +- DTC +- DTS + +### AP9 — Tools and Viewers +- DdsView +- LogViewer +- SqlBrowser + +### Release 1 Modules +- **TetraIF** (5 targets): TetraIF, TetraIFCommon, TetraIFServices, TetraIFUtils, TetraIFData +- **Z Module** (16 targets): Complete Z graphics framework +- **Lts/Common** utilities and services + +### Test Framework +- Google Test (gtest) +- Google Mock (gmock) + +## Build System + +### Prerequisites + +- Ubuntu 24.04 or compatible +- CMake 3.28+ +- Ninja build system +- Python 3.10+ +- Qt 6.10.2 (installed via aqt) + +### Qt6 Installation + +Qt6 is installed using aqt (not apt packages): + +```bash +pip3 install --break-system-packages --quiet aqtinstall +aqt install-qt linux desktop 6.10.2 linux_gcc_64 \ + -m qtmultimedia qtserialport qtimageformats qtwebsockets qtwebengine \ + qtpdf qtwebview qt5compat qtwebchannel qtpositioning qtlocation qtsensors \ + --outputdir /opt/Qt +``` + +**Required Qt Modules:** +- QtMultimedia +- QtSerialPort +- QtImageFormats +- QtWebSockets +- QtWebEngine +- QtPdf +- QtWebView +- Qt5Compat +- QtWebChannel +- QtPositioning +- QtLocation +- QtSensors + +### System Dependencies + +```bash +apt-get install -y \ + build-essential \ + cmake \ + ninja-build \ + git \ + python3-pip \ + libboost-all-dev \ + libkf6texttemplate-dev \ + libgtest-dev \ + libgmock-dev \ + libpq-dev \ + libvlc-dev \ + libssl-dev \ + libxml2-dev \ + libxerces-c-dev +``` + +### Docker Build + +Build the Release 2 Docker image: + +```bash +docker build -f Dockerfile.release2 -t guez-release2:2.0 . +``` + +Or use the build script: + +```bash +./new_docker_build_release2.sh +``` + +## DEB Packages + +Release 2 produces 5 Debian packages: + +1. **guez-build-pipeline_2.0_amd64.deb** - Build tools and CMake config +2. **guez-runtime_2.0_amd64.deb** - Runtime libraries (Lts, DDS, Z, TetraIF) +3. **guez-ctest-runtime_2.0_amd64.deb** - CTest runtime and test executables +4. **guez-ctest-sources_2.0_amd64.deb** - CTest source files +5. **guez-sources_2.0_amd64.deb** - Complete source package + +## Target List (37 Total) + +### GROUP1: DDS Middleware (6 targets) +- Lts/DDS/Core +- Lts/DDS/DDSConnector +- Lts/DDS/Routing +- Lts/DDS/QosProfile +- Lts/DDS/DTC +- Lts/DDS/DTS + +### GROUP3: Shared Libraries + TetraIF + Tests (28 targets) +- Lts/Common/LtsUtils +- Lts/Common/LtsWidgets +- Lts/Common/LtsSession +- Lts/Common/LtsPluginManager +- Lts/Common/CodeGen (ngl_codegen) +- Z module (16 targets) +- TetraIF (5 targets) +- external-dependencies/googletest/gtest +- external-dependencies/googletest/gmock + +### GROUP5: Viewer Tools (3 targets) +- Lts/Tools/DdsView +- Lts/Tools/LogViewer +- Lts/Tools/SqlBrowser + +### GROUP6: Code Generation Tools (1 target) +- Lts/Common/CodeGen/ngl_codegen + +## Known Absent Modules + +### Krypto ❌ +- **Status:** ABSENT from codebase +- **Reason:** Module not found in repository +- **Impact:** Excluded from Release 2 scope +- **Original plan:** 38 targets → **Actual:** 37 targets + +## Testing + +Run CTest suite: + +```bash +cd build +ctest --output-on-failure -j$(nproc) +``` + +## Verification + +All 37 targets verified with: +- ✅ Source files (.cpp, .h) +- ✅ CMakeLists.txt build configuration +- ✅ Proper directory structure + +See `RELEASE_2_SOURCE_VERIFICATION_REPORT.md` for detailed verification. + +## Branch Information + +- **Delivery Branch:** story/create-release-two-delivery-25_11_2026 +- **Reference Branch:** story/release-validation-scope +- **Parent Repository:** qt6-migration-pipeline + +## License + +Proprietary - Guez Project \ No newline at end of file