Provides release 2 first iteration

Entire-Checkpoint: 01M75099C2MVTQXYCH7PFTET6K
2026-11-11 09:51:03 +00:00
1 parent 3efd916d36
commit e1f856a710
@@ -0,0 +1,183 @@
+# guez Qt6 Release 2 - DEB Packages
+
+## Overview
+
+This release contains Qt6-migrated modules for the **guez** project (formerly known as "qatar"). The release is packaged as 5 DEB packages following the Release 2 structure, covering AP3 (shared libraries), AP4 (DDS middleware), and AP9 (tools/translations) modules.
+
+## Package Contents
+
+### 1. qt6-release-runtime (85M)
+**Purpose**: Runtime libraries and executables for Qt6-migrated modules
+
+**Contents**:
+- Shared libraries (.so) in `/usr/lib/`
+  - LTS modules: `libLtsCommandLineParser.so`, `libLtsCoordTrans.so`, `libLtsPluginLoader.so`, etc.
+  - DDS middleware: `libddsQoS.so`, `libddsconnector.so`, `libddscore.so`, etc.
+  - NGL components: `libnglapplication.so`, `libnglcompression.so`, `libnglcoreapplication.so`, etc.
+- Static libraries (.a): `libcodegen_grantlee.a`, `libddsftc.a`
+- Executables in `/usr/bin/`:
+  - `ParticipantDataGenerator`
+  - `tDataSampleGenerator`
+
+**Installation**:
+```bash
+sudo dpkg -i qt6-release-runtime_1.0-1_amd64.deb
+```
+
+### 2. qt6-release-sources (565M)
+**Purpose**: Complete source code for Qt6-migrated modules
+
+**Contents**:
+- Full source tree from `qt-migration-legatus/qt6-after/qt6-migrated-legatus/`
+- CMake build configuration
+- Application source code (AarApp, OpApp, etc.)
+- DDS middleware sources
+- LTS module sources
+- Build documentation and reports
+
+**Installation**:
+```bash
+sudo dpkg -i qt6-release-sources_1.0-1_amd64.deb
+```
+
+**Location after install**: `/opt/guez/sources/`
+
+### 3. qt6-release-ctest-runtime (565M)
+**Purpose**: Runtime components for CTest integration testing
+
+**Contents**:
+- CTest runtime libraries
+- Test executables
+- Test configuration files
+
+**Installation**:
+```bash
+sudo dpkg -i qt6-release-ctest-runtime_1.0-1_amd64.deb
+```
+
+### 4. qt6-release-ctest-sources (565M)
+**Purpose**: Source code for CTest integration tests
+
+**Contents**:
+- CTest source code
+- Test case implementations
+- Test configuration and fixtures
+
+**Installation**:
+```bash
+sudo dpkg -i qt6-release-ctest-sources_1.0-1_amd64.deb
+```
+
+**Location after install**: `/opt/guez/ctest-sources/`
+
+### 5. qt6-release-build-pipeline (1.1K)
+**Purpose**: Build pipeline configuration and scripts
+
+**Contents**:
+- Build pipeline scripts
+- CI/CD configuration
+- Docker build definitions
+
+**Installation**:
+```bash
+sudo dpkg -i qt6-release-build-pipeline_1.0-1_amd64.deb
+```
+
+**Location after install**: `/opt/guez/build-pipeline/`
+
+## Installation Order
+
+For a complete installation, install packages in this order:
+
+```bash
+# 1. Runtime libraries (required by all other packages)
+sudo dpkg -i qt6-release-runtime_1.0-1_amd64.deb
+
+# 2. Source packages (optional, for development)
+sudo dpkg -i qt6-release-sources_1.0-1_amd64.deb
+sudo dpkg -i qt6-release-ctest-sources_1.0-1_amd64.deb
+
+# 3. CTest runtime (for running integration tests)
+sudo dpkg -i qt6-release-ctest-runtime_1.0-1_amd64.deb
+
+# 4. Build pipeline (for CI/CD and reproducible builds)
+sudo dpkg -i qt6-release-build-pipeline_1.0-1_amd64.deb
+```
+
+## System Requirements
+
+- **Operating System**: Ubuntu 24.04 LTS or compatible Debian-based distribution
+- **Architecture**: x86_64 (amd64)
+- **Disk Space**: ~2.3GB total for all packages
+- **Qt6**: Pre-installed Qt6 libraries (installed via aqtinstall during build)
+
+## Build Information
+
+- **Version**: 1.0
+- **Build Date**: November 2025
+- **Build Script**: `rpmbuild/make_rpm_ubuntu26_release2.py`
+- **Entry Point**: `qt-migration-legatus/qt6-after/qt6-migrated-legatus/new_docker_build.sh`
+
+## Package Structure
+
+All packages follow Debian packaging standards:
+- **Control files**: `DEBIAN/control`, `DEBIAN/changelog`, `DEBIAN/rules`
+- **Installation prefix**: `/usr/` for runtime, `/opt/guez/` for sources
+- **Compression**: zstd (dpkg-deb default)
+
+## Migration Scope
+
+This release covers the following migration areas:
+
+### AP3 - Shared Libraries
+- LTS utility libraries
+- NGL core components
+- Code generation tools
+
+### AP4 - DDS Middleware
+- DDS QoS management
+- DDS connector and core
+- DDS FTC (Fast Transport Channel)
+- DDS code generator
+
+### AP9 - Tools and Translations
+- Grantlee templating
+- Localization tools
+- Build and test utilities
+
+## Known Issues
+
+1. **Build-pipeline package**: Currently minimal content; full pipeline configuration to be added in future release.
+
+2. **File permissions**: Some files in build4/ directory may be owned by root from Docker builds.
+
+## Verification
+
+To verify package contents:
+```bash
+# List package contents
+dpkg -c qt6-release-runtime_1.0-1_amd64.deb
+
+# Check package information
+dpkg -I qt6-release-runtime_1.0-1_amd64.deb
+
+# Verify installation
+dpkg -l | grep qt6-release
+```
+
+## Support
+
+For issues or questions related to this release, refer to:
+- Build status: `BUILD_STATUS_REPORT.md` (included in sources package)
+- DDS migration: `DDS_MIGRATION_STATUS.md`
+- Integration tests: `CTEST-INTEGRATION-STATUS.md`
+
+## License
+
+Proprietary - All rights reserved.
+
+---
+
+**Project**: guez (formerly qatar)  
+**Release**: Qt6 Migration - Release 2  
+**Date**: November 2025