Skip to content

Commit 8f09c03

Browse files
authored
Updates around usage advice. (#5610)
* Updates around usage advice. * Fixing build issue
1 parent 4498f44 commit 8f09c03

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

hub/apps/windows-app-sdk/deploy-packaged-apps.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Windows App SDK deployment guide for framework-dependent packaged apps
33
description: This article provides guidance about deploying framework-dependent packaged apps (see [What is MSIX?](/windows/msix/overview)) that use the Windows App SDK.
44
ms.topic: article
5-
ms.date: 07/14/2025
5+
ms.date: 07/22/2025
66
keywords: windows win32, windows app development, Windows App SDK
77
ms.localizationpriority: medium
88
---
@@ -66,7 +66,10 @@ For packaged apps that are *not* distributed through the Store, you as the devel
6666
You should call the Deployment API after your app's process is initialized, but before your app uses Windows App SDK runtime features that use the Singleton package (for example, push notifications). The main methods of the Deployment API are the static [GetStatus](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.deploymentmanager.getstatus) and [Initialize](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.deploymentmanager.initialize) methods of the [DeploymentManager](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime.deploymentmanager) class.
6767

6868
* The **GetStatus** method returns the current deployment status of the Windows App SDK runtime that's currently loaded. Use this method to identify whether there's work required to install Windows App SDK runtime packages before the current app can use Windows App SDK features.
69-
* The **Initialize** method verifies whether all required packages are present to a minimum version needed by the Windows App SDK runtime that's currently loaded. If any package dependencies are missing, then the method attempts to register those missing packages. Beginning in Windows App SDK 1.1, the **Initialize** method also supports the option to force-deploy the Windows App SDK runtime packages. That shuts down any processes for the *Main* and *Singleton* runtime packages, and thus interrupts their services (for example, push notifications won't deliver notifications during this time).
69+
* The **Initialize** method verifies whether all required packages are present to a minimum version needed by the Windows App SDK runtime that's currently loaded. If any package dependencies are missing, then the method attempts to register those missing packages. Beginning in Windows App SDK 1.1, the **Initialize** method also supports the option to force-deploy the Windows App SDK runtime packages. That shuts down any processes for the *Main* and *Singleton* runtime packages, and thus interrupts their services (for example, push notifications won't deliver notifications during this time). You should call **Initialize** only once. You don't need to call **Initialize** for apps deployed via the **Start Without Debugging** and **Start Debugging** commands in Visual Studio.
70+
71+
> [!IMPORTANT]
72+
> The default value of the Visual Studio property `<WindowsAppSdkDeploymentManagerInitialize>` is `true`. So if you wish to call **DeploymentManager.Initialize** explicitly, then set `<WindowsAppSdkDeploymentManagerInitialize>false</WindowsAppSdkDeploymentManagerInitialize>` in your Visual Studio project file.
7073
7174
### Deployment API sample app
7275

@@ -90,4 +93,4 @@ If you encounter errors that you can't diagnose, then file an issue in the [Wind
9093
* [Deployment architecture for the Windows App SDK](deployment-architecture.md)
9194
* [Windows App SDK deployment guide for framework-dependent apps packaged with external location or unpackaged](deploy-unpackaged-apps.md)
9295
* [Release channels](release-channels.md)
93-
* [Package your app using single-project MSIX](./single-project-msix.md)
96+
* [Package your app using single-project MSIX](./single-project-msix.md)

0 commit comments

Comments
 (0)