Document including the virtual registry (Registry.dat) when packaging manually#491
Open
RDMacLachlan wants to merge 2 commits into
Open
Document including the virtual registry (Registry.dat) when packaging manually#491RDMacLachlan wants to merge 2 commits into
RDMacLachlan wants to merge 2 commits into
Conversation
… manually Add an "(Optional) Include registry entries (virtual registry)" section to the manual/command-line packaging how-to. It explains that a package's virtual registry lives in a Registry.dat hive at the layout root, that MakeAppx packs the layout as-is and does not generate the hive from a .reg file, and the supported ways to produce it for CI/CD: the MSIX Packaging Tool command line (recommended), the Package Editor Virtual registry page, and generating a hive with reg save. Cross-links to the runtime registry behavior and the relevant tooling pages. Resolves AB#31660799 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
|
Learn Build status updates of commit 8b9c1b2: ✅ Validation status: passed
For more details, please refer to the build report. |
- Replace the emdash with standard punctuation to match the file's style. - Drop the '(Optional)' prefix from the heading; optionality is already conveyed in the section body. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 18e32334-aec6-40fd-a4f8-0631ef4d5840
Contributor
|
Learn Build status updates of commit cf8f266: ✅ Validation status: passed
For more details, please refer to the build report. |
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
1 participant
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.
Summary
Adds an (Optional) Include registry entries (virtual registry) section to
msix-src/desktop/desktop-to-uwp-manual-conversion.md, resolving this bug's request to document how to create theRegistry.dat(virtual registry / "vreg") hive from scratch in a CI/CD pipeline.The manual/command-line packaging how-to walks through the manifest, PRI, and MakeAppx, but never explains how to include registry entries. The new section documents:
Registry.datis — a registry hive at the package layout root that represents the virtual HKLM\Software, merged at runtime (cross-links to the Registry section of Understanding how packaged desktop apps run on Windows).Registry.datfrom a.regfile, so the hive must already exist in the layout.reg save.The bug's ReproSteps asked to source the exact generation method from the MSIX Packaging Tool devs; the recommended path here points at that tooling (which captures registry into the hive automatically) rather than publishing an unverified low-level binary-hive recipe.
All four cross-links were verified to resolve (including the
#registryand#virtual-registry-pageanchors).Resolves AB#31660799