You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: hub/apps/windows-app-sdk/deploy-packaged-apps.md
+6-3Lines changed: 6 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Windows App SDK deployment guide for framework-dependent packaged apps
3
3
description: This article provides guidance about deploying framework-dependent packaged apps (see [What is MSIX?](/windows/msix/overview)) that use the Windows App SDK.
4
4
ms.topic: article
5
-
ms.date: 07/14/2025
5
+
ms.date: 07/22/2025
6
6
keywords: windows win32, windows app development, Windows App SDK
7
7
ms.localizationpriority: medium
8
8
---
@@ -66,7 +66,10 @@ For packaged apps that are *not* distributed through the Store, you as the devel
66
66
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.
67
67
68
68
* 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.
70
73
71
74
### Deployment API sample app
72
75
@@ -90,4 +93,4 @@ If you encounter errors that you can't diagnose, then file an issue in the [Wind
90
93
*[Deployment architecture for the Windows App SDK](deployment-architecture.md)
91
94
*[Windows App SDK deployment guide for framework-dependent apps packaged with external location or unpackaged](deploy-unpackaged-apps.md)
92
95
*[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