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
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:
parent
948b8892cd
commit
c113864389
|
|
@ -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
|
||||
|
|
|
|||
2
TASKS.md
2
TASKS.md
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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" },
|
||||
|
|
|
|||
|
|
@ -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'
|
||||
}
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue