Skip to content

Commit a13c1ed

Browse files
niels9001jwmsft
andauthored
Deduping packaging content (#6565)
--------- Co-authored-by: Jim Walker <[email protected]>
1 parent ccd1acf commit a13c1ed

8 files changed

Lines changed: 88 additions & 179 deletions

File tree

.openpublishing.redirection.json

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11082,17 +11082,17 @@
1108211082
},
1108311083
{
1108411084
"source_path": "hub/apps/how-tos/chatgpt-openai-winui3.md",
11085-
"redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
11085+
"redirect_url": "/windows/apps/how-tos/ai-build",
1108611086
"redirect_document_id": false
1108711087
},
1108811088
{
1108911089
"source_path": "hub/apps/how-tos/copilot-chat-winui3.md",
11090-
"redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
11090+
"redirect_url": "/windows/apps/how-tos/ai-build",
1109111091
"redirect_document_id": false
1109211092
},
1109311093
{
1109411094
"source_path": "hub/apps/how-tos/dall-e-winui3.md",
11095-
"redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
11095+
"redirect_url": "/windows/apps/how-tos/ai-build",
1109611096
"redirect_document_id": false
1109711097
},
1109811098
{
@@ -11410,6 +11410,11 @@
1141011410
"redirect_url": "/windows/apps/dev-tools/visual-studio",
1141111411
"redirect_document_id": false
1141211412
},
11413+
{
11414+
"source_path": "hub/apps/package-and-deploy/choose-packaging-model.md",
11415+
"redirect_url": "/windows/apps/package-and-deploy/packaging/",
11416+
"redirect_document_id": false
11417+
},
1141311418
{
1141411419
"source_path": "hub/apps/design/globalizing/use-patterns-to-format-dates-and-times.md",
1141511420
"redirect_url": "/windows/apps/design/globalizing/use-global-ready-formats#use-templates-and-patterns-for-advanced-datetime-formatting",

hub/apps/dev-tools/winapp-cli/index.md

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -21,17 +21,7 @@ Whether you're building with .NET/Win32, CMake, Electron, or Rust, this CLI give
2121

2222
## Why package identity?
2323

24-
Many powerful Windows APIs require your app to have package identity, enabling you to leverage OS components Windows offers that you wouldn't otherwise have access to. With identity, your app gains access to features like notifications, OS integration, and on-device AI.
25-
26-
Examples of what package identity and MSIX packaging unlocks:
27-
28-
- [Interactive native notifications](/windows/apps/develop/notifications/app-notifications/app-notifications-quickstart?tabs=cs) and notification management
29-
- [Integration with Windows Explorer, Taskbar, Share sheet](/windows/apps/develop/windows-integration/integrate-sharesheet-packaged), and other shell surfaces
30-
- [Protocol handlers](/windows/apps/desktop/modernize/desktop-to-uwp-extensions#start-your-application-in-different-ways) (`yourapp://` URIs)
31-
- [On-device AI](/windows/ai/apis/) (local LLM, text and image AI APIs)
32-
- [Background tasks](/windows/uwp/launch-resume/declare-background-tasks-in-the-application-manifest) (run when app is closed)
33-
- [File type associations](/windows/apps/desktop/modernize/desktop-to-uwp-extensions#integrate-with-file-explorer)
34-
- [Clean install/uninstall and auto-updates](/windows/msix/overview)
24+
Many powerful Windows APIs require your app to have package identity. With identity, your app gains access to features like notifications, OS integration, and on-device AI. For a full list of what package identity unlocks and help choosing the right packaging model, see [Packaging overview](../../package-and-deploy/packaging/index.md).
3525

3626
## Installation
3727

hub/apps/get-started/start-here.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -69,9 +69,6 @@ In the Visual Studio Installer, select the following workloads on the **Workload
6969

7070
2. Search for **WinUI**, select the **WinUI Blank App (Packaged)** C# project template, and select **Next**.
7171

72-
> [!NOTE]
73-
> The **Packaged** template is recommended for new apps. A packaged app (using MSIX) gives your users a clean install and uninstall experience, and enables Windows features like notifications, background tasks, and the Microsoft Store. You can learn more about the packaged vs. unpackaged choice in [Windows apps: packaging, deployment, and process](intro-pack-dep-proc.md).
74-
7572
:::image type="content" source="images/hello-world/create-project.png" lightbox="images/hello-world/create-project.png" alt-text="Blank, packaged WinUI C# desktop app":::
7673

7774
3. Enter a project name and select **Create**.

hub/apps/package-and-deploy/choose-packaging-model.md

Lines changed: 0 additions & 127 deletions
This file was deleted.

hub/apps/package-and-deploy/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.localizationpriority: medium
1414

1515
App packaging provides your application with a predictable installation, update, and servicing model on Windows. While WinUI 3 apps are packaged by default, many other types of apps aren't. And adding package identity unlocks a wide range of Windows capabilities. Features that depend on package identity to function include background tasks, notifications, live tiles, custom context menu extensions, share targets, and other extensibility points. Packaging also helps ensure cleaner deployments, reliable updates, and streamlined distribution through channels such as the Microsoft Store and enterprise deployment tools.
1616

17-
Not sure which packaging model is right for your app? See [Choose a packaging model](choose-packaging-model.md).
17+
Not sure which packaging model is right for your app? See [Packaging overview](packaging/index.md).
1818

1919
When deploying apps that use the Windows App SDK, you can choose between framework-dependent and self-contained deployment models. Framework-dependent apps rely on the Windows App SDK runtime and/or framework package being installed on the user’s machine. In contrast, self-contained apps bundle the Windows App SDK dependencies directly with the application, ensuring the app carries everything it needs to run. The right model depends on your distribution scenario, update strategy, and how much control you want over the app’s footprint and dependencies.
2020

0 commit comments

Comments
 (0)