2026-04-20 07:48:53 +08:00
|
|
|
# PDC Incremental Update Migration
|
|
|
|
|
|
|
|
|
|
## Goal
|
|
|
|
|
|
2026-04-20 12:55:19 +08:00
|
|
|
Replace VeloPack-based incremental packaging with a unified PDC FileMap + object-repo pipeline, while keeping Launcher installation, rollback, and update orchestration ownership unchanged.
|
2026-04-20 07:48:53 +08:00
|
|
|
|
2026-04-20 12:55:19 +08:00
|
|
|
## Stage 1 (Completed)
|
2026-04-20 07:48:53 +08:00
|
|
|
|
2026-04-20 12:55:19 +08:00
|
|
|
- Release workflow removed VeloPack-based release packaging.
|
|
|
|
|
- Signed FileMap path was restored as an interim release mechanism.
|
|
|
|
|
- Host/Launcher fallback behavior stayed compatible with `files.json + files.json.sig + update.zip`.
|
2026-04-20 07:48:53 +08:00
|
|
|
|
2026-04-20 12:55:19 +08:00
|
|
|
## Stage 2 (Current Implementation Target)
|
2026-04-20 07:48:53 +08:00
|
|
|
|
2026-04-20 12:55:19 +08:00
|
|
|
- Move release publishing to PDCC + `phainon.yml` (ClassIsland-style).
|
|
|
|
|
- Promote PDC-distributed FileMap/object-repo as the primary incremental path.
|
|
|
|
|
- Keep GitHub Release installers and metadata as parallel distribution.
|
|
|
|
|
- Keep Launcher state machine ownership (`.current/.partial/.destroy` + snapshots).
|
|
|
|
|
- Update source defaults to `stcn` (S3/PDC), with GitHub fallback.
|
|
|
|
|
- S3 object root is fixed to `lanmountain/update/` with no update-system version prefix.
|
|
|
|
|
|
|
|
|
|
Expected S3 layout:
|
|
|
|
|
- `lanmountain/update/repo/<hash-prefix>/<hash-object>`
|
|
|
|
|
- `lanmountain/update/meta/channels/<channel>/<subchannel>/latest.json`
|
|
|
|
|
- `lanmountain/update/meta/distributions/<distributionId>/*.json`
|
|
|
|
|
- `lanmountain/update/installers/<platform>/<arch>/*`
|
2026-04-20 07:48:53 +08:00
|
|
|
|
|
|
|
|
## Acceptance
|
|
|
|
|
|
2026-04-20 12:55:19 +08:00
|
|
|
- `release.yml` includes PDCC publish steps and no Velopack steps.
|
|
|
|
|
- Release jobs keep building installers for Windows x64/x86, Linux x64, and macOS.
|
|
|
|
|
- PDC metadata + FileMap + object repo are published under `lanmountain/update/`.
|
|
|
|
|
- Host can consume PDC payload (`stcn` source) and fallback to GitHub when unavailable.
|
|
|
|
|
- Launcher can apply both:
|
|
|
|
|
- legacy signed `files.json + update.zip`
|
|
|
|
|
- PDC FileMap object-repo payload.
|
|
|
|
|
- Rollback semantics remain unchanged.
|
|
|
|
|
|
|
|
|
|
## Deprecated Notes
|
|
|
|
|
|
|
|
|
|
- The following interim outputs are compatibility-only (not the long-term primary path):
|
|
|
|
|
- `files-windows-x64.json` / `.sig` / `update-windows-x64.zip`
|
|
|
|
|
- `files-windows-x86.json` / `.sig` / `update-windows-x86.zip`
|
|
|
|
|
- `files-linux-x64.json` / `.sig` / `update-linux-x64.zip`
|
