Skip to content

Note the restricted capability required to use the PackageManager API#481

Open
RDMacLachlan wants to merge 1 commit into
MicrosoftDocs:mainfrom
RDMacLachlan:users/romaclac/docbug-25736442
Open

Note the restricted capability required to use the PackageManager API#481
RDMacLachlan wants to merge 1 commit into
MicrosoftDocs:mainfrom
RDMacLachlan:users/romaclac/docbug-25736442

Conversation

@RDMacLachlan

Copy link
Copy Markdown
Collaborator

Resolves the doc bug asking that the PackageManager API references note the appropriate restricted capability and link to the capability declarations page (AB#25736442).

What changed

The literal API reference page (/uwp/api/...PackageManager) lives in the winrt-api repo, but several conceptual topics here reference the PackageManager API for install/query without noting the required restricted capability. This adds notes that follow the same pattern already used in non-store-developer-updates.md, distinguishing install from query (per the reporter's own guidance on the bug):

  • msix-server-2019.md — installing via the Package Manager API requires the packageManagement restricted capability
  • app-installer/app-installer-documentation.md — the AddPackageByAppInstallerFileAsync / RequestAddPackageByAppInstallerFileAsync methods require the packageManagement restricted capability
  • package/package-folding.md — querying packages your app didn't author with the PackageManager class requires the packageQuery restricted capability

Each note links to the restricted capability declarations reference and the package manifest, and clarifies that managing/querying your own app's packages doesn't require the capability. ms.date bumped on the edited files.

The PackageManager (Windows.Management.Deployment) references in these
conceptual topics didn't mention that the calling app must declare the
appropriate restricted capability, or link to the capability declarations
page. Add capability notes that distinguish install from query:

- msix-server-2019.md: installing via the Package Manager API requires the
  `packageManagement` restricted capability
- app-installer/app-installer-documentation.md: the AddPackageByAppInstaller-
  FileAsync / RequestAddPackageByAppInstallerFileAsync methods require the
  `packageManagement` restricted capability
- package/package-folding.md: querying packages your app didn't author with
  the PackageManager class requires the `packageQuery` restricted capability

Each note links to the restricted capability declarations reference and the
package manifest, and clarifies that managing/querying your own app's
packages doesn't require the capability. Bump ms.date on the edited files.

Resolves AB#25736442

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit b6d2729:

✅ Validation status: passed

File Status Preview URL Details
msix-src/app-installer/app-installer-documentation.md ✅Succeeded
msix-src/msix-server-2019.md ✅Succeeded
msix-src/package/package-folding.md ✅Succeeded

For more details, please refer to the build report.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant