Document Deckstride software updates
Config Central CI Config Central passed all CI integrity checks.
Beffroi/config-central/pipeline/head This commit looks good
Details
Config Central CI Config Central passed all CI integrity checks.
Beffroi/config-central/pipeline/head This commit looks good
Details
This commit is contained in:
parent
73c4505780
commit
75cb036c7c
27
README.md
27
README.md
|
|
@ -57,6 +57,11 @@ user, and run:
|
|||
cc update-software
|
||||
```
|
||||
|
||||
`cc software-update` is an equivalent alias. The command shows an elapsed
|
||||
spinner while its refreshed snapshot updates software. Redirected output gets a
|
||||
single plain status line, and `-Json` remains machine-readable without progress
|
||||
text.
|
||||
|
||||
This command updates Config Central and the software selected by the machine
|
||||
manifest without deploying any configs. It runs operations in this order:
|
||||
|
||||
|
|
@ -82,27 +87,25 @@ an item failure, reports reboot requirements, and never restarts Windows. Close
|
|||
a running portable application before updating it. The working version remains
|
||||
available until its replacement is fully activated, then older versions are removed.
|
||||
|
||||
The desktop profile installs PDF Presenter and PPTX Reporter as verified portable
|
||||
packages and creates per-user Start menu shortcuts under Config Central. PDF
|
||||
Presenter is also registered as a per-user PDF handler, with a separate document
|
||||
The desktop profile installs Deckstride and PPTX Reporter as verified portable
|
||||
packages and creates per-user Start menu shortcuts under Config Central.
|
||||
Deckstride is also registered as a per-user PDF handler, with a separate document
|
||||
icon based on its turquoise presentation mark. After the first
|
||||
`cc update-software` or full apply, open its Windows Default Apps page:
|
||||
|
||||
```powershell
|
||||
Start-Process 'ms-settings:defaultapps?registeredAppUser=ConfigCentral.idle-org.pdf-presenter'
|
||||
Start-Process 'ms-settings:defaultapps?registeredAppUser=ConfigCentral.idle-org.deckstride'
|
||||
```
|
||||
|
||||
Select PDF Presenter for `.pdf`. On older Windows builds that open the general
|
||||
Select Deckstride for `.pdf`. On older Windows builds that open the general
|
||||
Default Apps page, right-click a PDF, choose **Open with → Choose another app**,
|
||||
select **PDF Presenter**, and enable **Always**. Windows requires this one-time
|
||||
select **Deckstride**, and enable **Always**. Windows requires this one-time
|
||||
user confirmation and Config Central preserves that choice across updates.
|
||||
|
||||
PDF Presenter is being renamed to
|
||||
[Deckstride](https://proxy.dandaedre.com/gitea/idle-org/Deckstride). The existing
|
||||
PDF Presenter release remains pinned until the first Deckstride Windows release
|
||||
is available and verified. The prepared migration will install Deckstride first,
|
||||
then remove the managed PDF Presenter files, Start menu shortcut and old handler
|
||||
registration. Windows will require one new Default Apps selection for Deckstride.
|
||||
The first Deckstride update installs and verifies
|
||||
[Deckstride 0.1.96](https://proxy.dandaedre.com/gitea/idle-org/Deckstride/releases/tag/v0.1.96)
|
||||
before removing the managed PDF Presenter files, Start menu shortcut and old
|
||||
handler registration.
|
||||
|
||||
Like `cc sync`, `update-software` refuses to fetch while the checkout contains
|
||||
uncommitted or untracked files. It does not reset or overwrite those edits.
|
||||
|
|
|
|||
|
|
@ -181,6 +181,7 @@ cc plan # show intended work; change nothing
|
|||
cc apply # apply the current checkout
|
||||
cc sync # fetch and apply an immutable remote snapshot
|
||||
cc update-software # refresh cc, then update declared software
|
||||
cc software-update # alias for update-software
|
||||
cc status # show drift and the last run
|
||||
cc sync -ConfigsOnly # fetch and deploy configs; do not call WinGet
|
||||
cc apply -ForceConfigs # back up local edits, then replace them
|
||||
|
|
@ -331,7 +332,7 @@ terminal open with the outcome in `$LASTEXITCODE`.
|
|||
|
||||
## Portable package updates
|
||||
|
||||
The desktop profile includes PDF Presenter 0.1.91 and PPTX Reporter 0.2.0 for
|
||||
The desktop profile includes Deckstride 0.1.96 and PPTX Reporter 0.2.0 for
|
||||
Windows x64 from their published portable releases. Their exact ZIP hashes and
|
||||
executable paths were checked against each release's SHA256SUMS and artifact
|
||||
manifest. The Windows binaries are unsigned; native Windows acceptance remains
|
||||
|
|
@ -342,17 +343,21 @@ 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 installed software, close PDF Presenter and PPTX Reporter and run:
|
||||
To update installed software, close Deckstride and PPTX Reporter and run:
|
||||
|
||||
```powershell
|
||||
cc update-software
|
||||
```
|
||||
|
||||
`cc software-update` runs the same command. In an interactive terminal the
|
||||
outer command shows an elapsed spinner while the refreshed snapshot works.
|
||||
Redirected output gets one plain start line; `-Json` suppresses progress output.
|
||||
|
||||
The command fetches the configured repository branch and continues from an
|
||||
immutable snapshot of that commit, so the current run uses the latest Config
|
||||
Central code and policy. It then checks the Gitea releases API for opted-in
|
||||
portable packages and asks WinGet to apply each declared package's policy by
|
||||
exact ID. PDF Presenter follows the newest eligible preview or stable release.
|
||||
exact ID. Deckstride follows the newest eligible stable release.
|
||||
Unmanaged WinGet applications are left alone. Configs are not planned or changed.
|
||||
Each release lookup resolves one exact ZIP, reads its exact entry from
|
||||
`SHA256SUMS`, and verifies the downloaded archive before activation. Both tools
|
||||
|
|
@ -375,38 +380,35 @@ To review and advance the deterministic repository pin:
|
|||
contacting the release API or downloading it.
|
||||
|
||||
Default files live under
|
||||
`%LOCALAPPDATA%\ConfigCentral\apps\idle-org\pdf-presenter`. `launch.ps1` is the
|
||||
`%LOCALAPPDATA%\ConfigCentral\apps\idle-org\deckstride`. `launch.ps1` is the
|
||||
stable terminal launcher; the Start menu shortcut under `Config Central\idle-org`
|
||||
targets `pdf-presenter.exe` directly and uses its embedded icon. `current.json`
|
||||
targets `deckstride.exe` directly and uses its embedded icon. `current.json`
|
||||
records the active version and hashes. A successful update removes older managed
|
||||
version directories. The working version remains active when download,
|
||||
verification, or setup fails. Removing the profile entry does not uninstall anything.
|
||||
|
||||
The package also declares `displayName`, `fileAssociations`, and a dedicated
|
||||
`fileAssociationIcon`, which register PDF Presenter per user as a `.pdf` handler
|
||||
`fileAssociationIcon`, which register Deckstride per user as a `.pdf` handler
|
||||
with Windows Default Apps. Config Central copies the icon into the stable package
|
||||
root so Explorer does not depend on a versioned executable. The open command
|
||||
passes the selected PDF directly to the active executable. Windows requires the
|
||||
user to confirm the protected default-app choice. After applying the package,
|
||||
open its settings page and select PDF Presenter for `.pdf`:
|
||||
open its settings page and select Deckstride for `.pdf`:
|
||||
|
||||
```powershell
|
||||
Start-Process 'ms-settings:defaultapps?registeredAppUser=ConfigCentral.idle-org.pdf-presenter'
|
||||
Start-Process 'ms-settings:defaultapps?registeredAppUser=ConfigCentral.idle-org.deckstride'
|
||||
```
|
||||
|
||||
Updates repair the registration to point at the new verified executable without
|
||||
rewriting the user's default-app preference.
|
||||
|
||||
PDF Presenter is being renamed to Deckstride and moved to
|
||||
`idle-org/Deckstride`. The current 0.1.91 pin remains active until a Deckstride
|
||||
release with verified Windows assets is available. That release declaration will
|
||||
use Deckstride's new portable identity and a `replaces` entry for
|
||||
`idle-org/pdf-presenter`. On the first successful update, Config Central will
|
||||
activate Deckstride before removing PDF Presenter's managed files, shortcut and
|
||||
Deckstride's declaration includes a `replaces` entry for
|
||||
`idle-org/pdf-presenter`. On the first successful update, Config Central
|
||||
activates Deckstride before removing PDF Presenter's managed files, shortcut and
|
||||
old `.pdf` registration. If the old installation was locally modified or cannot
|
||||
be removed, Deckstride stays installed and cleanup is retried later. Select
|
||||
Deckstride once in Windows Default Apps afterward because Windows does not allow
|
||||
software to transfer the protected `.pdf` default choice to a renamed handler.
|
||||
Deckstride once in Windows Default Apps because Windows does not allow software
|
||||
to transfer the protected `.pdf` default choice to a renamed handler.
|
||||
|
||||
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
|
||||
|
|
|
|||
|
|
@ -46,6 +46,7 @@ cc plan [-Machine NAME] [-ConfigsOnly] [-Json]
|
|||
cc apply [-Machine NAME] [-ConfigsOnly] [-ForceConfigs] [-Json]
|
||||
cc sync [-Machine NAME] [-ConfigsOnly] [-ForceConfigs] [-Json]
|
||||
cc update-software [-Machine NAME] [-Json]
|
||||
cc software-update [-Machine NAME] [-Json]
|
||||
cc status [-Machine NAME] [-Json]
|
||||
cc restore -Config NAME [-Machine NAME] [-Json]
|
||||
cc schedule [-Machine NAME]
|
||||
|
|
@ -65,6 +66,9 @@ according to its normal policy and exact ID. It never performs an unbounded
|
|||
prevent independent package operations. When the snapshot run finishes, the
|
||||
installed checkout advances to the same revision only when Git can fast-forward
|
||||
it without discarding local work.
|
||||
`software-update` is a CLI alias normalized to the same command and result name.
|
||||
Interactive software updates show elapsed activity feedback; redirected human
|
||||
output uses one plain status line and JSON output contains no progress text.
|
||||
|
||||
`schedule` registers a limited, interactive-user task at logon. Scheduled runs
|
||||
always use `sync -ConfigsOnly`; package installation and upgrades remain manual
|
||||
|
|
|
|||
Loading…
Reference in New Issue