Add verified PDF Presenter portable release to desktop apps
Config Central CI Config Central failed CI.
Beffroi/config-central/pipeline/head There was a failure building this commit Details

This commit is contained in:
Dandaedre 2026-11-20 08:20:26 +01:00
parent 948b8892cd
commit c113864389
5 changed files with 69 additions and 2 deletions

View File

@ -25,6 +25,13 @@ add software to the install list, or when you need to repair setup.
Requires Windows 10 1809 or newer, Windows 11, or Windows Server 2025, with
internet access and support for WinGet.
The desktop profile also installs PDF Presenter as a verified portable package
on Windows x64, pinned to preview version 0.1.33. Launch `pdf-presenter` from
Start → Config Central → idle-org. Close it before running install or `cc sync`
to update software; the config-only update below skips it. Future PDF Presenter
updates require a reviewed version/checksum change in the profile. See
[portable package updates](docs/advanced_commands.md#portable-package-updates).
## 2. Use update for routine config changes
Close the applications whose settings you are updating, then paste into

View File

@ -155,5 +155,5 @@ open until it is run on disposable machines with the required account setups.
- [x] Document portable package identity, pinning, storage and recovery semantics.
- [x] Validate and resolve portable package declarations alongside WinGet (17 Linux Pester tests pass).
- [x] Implement portable ZIP planning, verified staging, launchers and recovery with Linux Pester tests; keep Windows acceptance below open.
- [ ] Add the verified PDF Presenter release to the desktop profile and document updates.
- [x] Add the verified PDF Presenter 0.1.33 release to the desktop profile and document updates; validate archive/executable hashes and run the Linux suite (136 passed, 5 Windows-only skips).
- [ ] Validate portable installation, Start menu launch and running-app handling on disposable Windows x64.

View File

@ -327,3 +327,48 @@ actions. Redirected output and JSON remain plain. Set `$env:NO_COLOR = "1"` to
disable colors in a terminal. Errors go to stderr; JSON errors stay structured.
Runtime failures preserve nonzero status codes, and web commands leave the
terminal open with the outcome in `$LASTEXITCODE`.
## Portable package updates
The desktop profile includes PDF Presenter 0.1.33 for Windows x64 from the
[upstream preview release](https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter/releases/tag/v0.1.33).
Its ZIP and executable were checked against the published SHA256SUMS. Upstream
marks this release as a preview with unsigned Windows binaries; native Windows
acceptance remains pending here too.
Portable packages use `provider: "portable"`, user scope and a version pinned in
Git. `source` is a namespace (here `idle-org`), not a WinGet source. They appear
alongside WinGet packages in `cc plan`, `cc status`, `cc apply` and full `cc sync`.
Config-only commands and the scheduled config sync leave software alone.
To update PDF Presenter:
1. Select and review an upstream release, download its Windows portable ZIP,
and compare `Get-FileHash -Algorithm SHA256` with its published SHA256SUMS.
2. Update `version`, `url`, `sha256` and `executable` together in
`profiles/desktop-apps.json`. Use the version-specific download URL. No release
discovery or automatic prerelease tracking occurs on clients.
3. Commit and push the change. On each desktop, close PDF Presenter and run
`cc sync` (or rerun the web installer). Use `cc apply` for an updated local
checkout; `cc plan` previews the selected version without downloading it.
Default files live under
`%LOCALAPPDATA%\ConfigCentral\apps\idle-org\pdf-presenter`. `launch.ps1` is the
stable launcher; the Start menu shortcut is under `Config Central\idle-org`.
`current.json` records the active version and hashes. Older version directories
are retained, and removing the profile entry does not uninstall anything.
On a failed download, checksum check or setup step, fix the reported cause and
retry. Missing managed files are repaired. Locally changed binaries or launchers
are conflicts: inspect and save those changes elsewhere, then remove the affected
file to let the next apply repair it. `-ForceConfigs` does not override portable
package conflicts. Never change the hash of an existing release to bypass a
checksum mismatch. Persistent application settings must live outside the version
directory; extra files in an older version are preserved but are not migrated.
Linux Pester tests cover archive validation, hash verification, partial failure,
retry, version policies, conflict handling, launcher errors and elevation
rejection. Disposable Windows x64 acceptance still needs to verify first install,
Start menu launch, a no-change rerun, running-app refusal, and an upgrade with
settings preserved. Run the controller as the desktop user, not as a separate
administrator account.

View File

@ -4,6 +4,17 @@
"name": "desktop-apps",
"description": "Desktop productivity, communication, creative, media, and file synchronization applications.",
"packages": [
{
"id": "pdf-presenter",
"provider": "portable",
"source": "idle-org",
"scope": "user",
"update": "pinned",
"version": "0.1.33",
"url": "https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter/releases/download/v0.1.33/pdf-presenter-portable-x86_64-pc-windows-gnu-v0.1.33.zip",
"sha256": "78d6129e429448c0f0559a516c023ab5c4bc8e61137cb3390322796bef66382c",
"executable": "pdf-presenter-portable-x86_64-pc-windows-gnu-v0.1.33/pdf-presenter.exe"
},
{ "id": "clsid2.mpc-hc", "source": "winget", "scope": "machine", "update": "latest" },
{ "id": "XnSoft.XnViewMP", "source": "winget", "scope": "machine", "update": "latest" },
{ "id": "Zoom.Zoom", "source": "winget", "scope": "machine", "update": "latest" },

View File

@ -5,7 +5,7 @@ BeforeAll {
Describe 'Manifest resolution' {
It 'resolves the checked-in example in profile order' {
$result = Resolve-MachineManifest -RepositoryRoot "$PSScriptRoot/.." -Machine 'beffroi-laptop'
$result.packages.Count | Should -Be 14
$result.packages.Count | Should -Be 15
$result.configs.Count | Should -Be 9
$result.packages[0].id | Should -Be 'Git.Git'
$result.packages.id | Should -Contain 'XnSoft.XnViewMP'
@ -19,6 +19,10 @@ Describe 'Manifest resolution' {
$result.packages.id | Should -Contain 'Waterfox.Waterfox'
$result.packages.id | Should -Contain 'Meltytech.Shotcut'
$result.packages.id | Should -Contain 'clsid2.mpc-hc'
$presenter = $result.packages | Where-Object id -eq 'pdf-presenter'
$presenter.provider | Should -Be 'portable'
$presenter.scope | Should -Be 'user'
$presenter.update | Should -Be 'pinned'
$result.packages.id | Should -Not -Contain 'cpvalente.ontime'
}