Clarify App Installer file version is independent of the package version - #485
Open
Roy (RDMacLachlan) wants to merge 2 commits into
Open
Clarify App Installer file version is independent of the package version#485Roy (RDMacLachlan) wants to merge 2 commits into
Roy (RDMacLachlan) wants to merge 2 commits into
Conversation
The App Installer file's root Version attribute is the version of the .appinstaller file itself, independent of the referenced package versions. App Installer detects a published change by this file version, so it must always move forward. A customer who downgraded their package (1.1.0.0 -> 1.0.0.0) also lowered the App Installer file version to match, so the update was never applied. Adds an [!IMPORTANT] note at Step 2 (version independence + always increment) and an [!NOTE] at Step 6 (keep increasing the file version when downgrading the package) in how-to-create-appinstaller-file.md, and a matching note on the ForceUpdateFromAnyVersion entry in update-settings.md. Resolves AB#27479263 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Roy (RDMacLachlan)
requested review from
Howard Kapustein (DrusTheAxe) and
John Kennedy (GrantMeStrength)
July 3, 2026 18:21
Contributor
|
Learn Build status updates of commit 9edcaf3: ✅ Validation status: passed
For more details, please refer to the build report. |
Replace em dashes with standard punctuation and convert the italic 'package' to bold to match these files' emphasis convention (both use bold, not italic, and have no pre-existing emdashes). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 18e32334-aec6-40fd-a4f8-0631ef4d5840
Contributor
|
Learn Build status updates of commit b968bb9: ✅ Validation status: passed
For more details, please refer to the build report. |
| @@ -273,6 +276,9 @@ The App Installer file can also specify update setting so that the related sets | |||
| | ShowPrompt | Defines if a window is displayed when updates are being installed, and when updates are being checked for. | | |||
| | ForceUpdateFromAnyVersion | Specifies that the next version of the application could be to a newer or older version. If True, will all for both, if False (default), only new versions will be installed. | | |||
There was a problem hiding this comment.
This option has complexities e.g. it downgrades, then if something stages another version to the machine that'll be the new desired version handed out.
We should warn folks away from this option, and be very careful documenting its behavior.
See Stephen for details about this option and MostRecentlyStaged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Clarifies that the
.appinstallerfile's rootVersionattribute is the version of the App Installer file itself, independent of the referenced package versions, and that it must always move forward for App Installer to detect and apply a published change.Addresses a customer issue where a package downgrade (1.1.0.0 -> 1.0.0.0) wasn't applied because the App Installer file
Versionwas also lowered to 1.0.0.0 to match the package. Adds an[!IMPORTANT]note at Step 2 and an[!NOTE]at Step 6 inhow-to-create-appinstaller-file.md, plus a matching note on theForceUpdateFromAnyVersionentry inupdate-settings.md.Resolves AB#27479263