summaryrefslogtreecommitdiff
path: root/archived/projt-launcher/docs/handbook/images.md
diff options
context:
space:
mode:
Diffstat (limited to 'archived/projt-launcher/docs/handbook/images.md')
-rw-r--r--archived/projt-launcher/docs/handbook/images.md66
1 files changed, 66 insertions, 0 deletions
diff --git a/archived/projt-launcher/docs/handbook/images.md b/archived/projt-launcher/docs/handbook/images.md
new file mode 100644
index 0000000000..24cad7dd46
--- /dev/null
+++ b/archived/projt-launcher/docs/handbook/images.md
@@ -0,0 +1,66 @@
+# CI Docker Images
+
+> **Purpose**: Minimal Qt build images for CI testing
+> **Latest Version**: 0.0.5-1
+
+---
+
+## Overview
+
+These are minimal Docker images containing Qt built from source with specific options for CI testing purposes.
+
+---
+
+## Why Custom Images?
+
+The standard `jurplel/install-qt-action` downloads pre-built Qt binaries, but:
+
+- ❌ Does not support all build options
+- ❌ Cannot test `-qt-zlib` builds
+- ❌ Limited configuration options
+
+Our custom images provide:
+
+- ✅ Qt built with `-qt-zlib` option
+- ✅ Testing `QUAZIP_USE_QT_ZLIB=ON` builds
+- ✅ Full control over Qt configuration
+
+---
+
+## Available Images
+
+| Image | Qt Version | Platform |
+|-------|------------|----------|
+| `qt-minimal-linux` | Qt 6.x | Ubuntu |
+| `qt-minimal-static` | Qt 6.x (static) | Ubuntu |
+
+---
+
+## Usage in CI
+
+```yaml
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ container: ghcr.io/project-tick/qt-minimal-linux:latest
+ steps:
+ - uses: actions/checkout@v4
+ - run: cmake -B build -DQUAZIP_USE_QT_ZLIB=ON
+ - run: cmake --build build
+```
+
+---
+
+## Building Images
+
+```bash
+cd ci/images
+docker build -t qt-minimal-linux -f Dockerfile.linux .
+```
+
+---
+
+## Related Documentation
+
+- [Workflows](./workflows.md) — CI overview
+- [QuaZip](./quazip.md) — Uses these images for testing