183 lines
4.9 KiB
Markdown
183 lines
4.9 KiB
Markdown
# 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 |