# 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