Skip to content

Commit cbe7ef8

Browse files
authored
updates for Preview 2 docs (#1958)
1 parent 7213437 commit cbe7ef8

5 files changed

+13
-11
lines changed

hub/apps/windows-app-sdk/check-windows-app-sdk-versions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,13 @@ ms.localizationpriority: medium
1414
To check which versions of the Windows App SDK runtime are installed on your development computer, open a **PowerShell** window and run this command.
1515

1616
```Powershell
17-
# For 1.0 Preview 1
17+
# For 1.0 Preview 1 and later
1818
get-appxpackage *appruntime*
1919
2020
# For 1.0 Experimental
2121
get-appxpackage *WindowsAppSDK*
2222
23-
# For 0.8 versions and older
23+
# For 0.8 versions and earlier
2424
get-appxpackage *reunion*
2525
```
2626

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

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@ This article provides guidance about deploying [MSIX](/windows/msix)-packaged ap
1515

1616
By default, when you create a project using one of the [WinUI project templates](..\winui\winui3\winui-project-templates-in-visual-studio.md) that are provided with the Windows App SDK extension for Visual Studio, your project includes a [Windows Application Packaging Project](/windows/msix/desktop/desktop-to-uwp-packaging-dot-net) that is configured to build the app into an MSIX package. For more information about configuring this project to build an MSIX package for your app, see [Package a desktop or UWP app in Visual Studio](/windows/msix/package/packaging-uwp-apps). After you build an MSIX package for your app, you have several options for deploying it to other computers. For more information, see [Manage your MSIX deployment](/windows/msix/desktop/managing-your-msix-deployment-overview).
1717

18-
Before configuring your apps for deployment, review [the Windows App SDK deployment architecture](deployment-architecture.md) to learn more about the dependencies your packaged app takes when it uses the Windows App SDK. These dependencies include the **framework**, **main**, and **singleton** packages, which are all signed and published by Microsoft. In order to have the Windows App SDK fully present and functional, all of these packages must be deployed to the system.
18+
Before configuring your apps for deployment, review [the Windows App SDK deployment architecture](deployment-architecture.md) to learn more about the dependencies your packaged app takes when it uses the Windows App SDK. These dependencies include the **framework**, **main**, and **singleton** packages, which are all signed and published by Microsoft.
1919

2020
## Deploy the Windows App SDK framework package
2121

22-
The Windows App SDK framework has different deployment requirements for different versions of the Windows App SDK.
22+
The Windows App SDK framework package contains the Windows App SDK binaries used at run time, and it is installed with the application. The framework has different deployment requirements for different versions of the Windows App SDK.
2323

2424
### Preview version
2525

@@ -43,14 +43,16 @@ As a result of that declared dependency, the framework package is installed when
4343

4444
## Deploy the Windows App SDK main and singleton package
4545

46+
The main package contains out-of-process services that are brokered between apps, such as push notifications, and it is also needed for the framework to be serviced by the Microsoft Store. The singleton package supports a single long-running process that is brokered between apps for features like push notifications.
47+
48+
If developers want to use features not included in the framework and prefer to have the framework automatically updated by the Store without needing to redistribute their packaged app, then the main and singleton packages are also required to be installed on the system.
49+
4650
While the Windows application model supports framework dependencies, it does not support a packaged app (a main package) declaring a dependency on other main packages (the Windows App SDK main and singleton packages). The framework package that is installed with your app will have the main and singleton package embedded within it, but your packaged app must use the API in the [Microsoft.Windows.ApplicationModel.WindowsAppRuntime](/windows/windows-app-sdk/api/winrt/microsoft.windows.applicationmodel.windowsappruntime) namespace to get those packages installed on the machine. The API in this namespace is also called the *deployment API*.
4751

4852
### Use the deployment API
4953

5054
The deployment API is provided by the Windows App SDK framework package. You should call the API after your app's process is initialized but before your app uses Windows App SDK runtime content in the main and singleton packages.
5155

52-
For more information on the main and singleton packages, review [the Windows App SDK deployment architecture](deployment-architecture.md).
53-
5456
> [!IMPORTANT]
5557
> In Windows App SDK version 1.0, only MSIX packaged apps that are full trust or have the [packageManagement](/windows/uwp/packaging/app-capability-declarations) restricted capability have the permission to use the deployment API to install the main and singleton package dependencies. Support for partial trust packaged apps will be coming in later releases.
5658

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,9 @@ Unpackaged apps have two options available for deploying the Windows App SDK pac
4343

4444
You can deploy the Windows App SDK by running the Windows App SDK silent installer:
4545

46-
- **WindowsAppRuntimeInstall.exe** if you are using version 1.0 Preview 1.
46+
- **WindowsAppRuntimeInstall.exe** if you are using version 1.0 Preview 1 and later.
4747
- **WindowsAppSDKInstall.exe** if you are using version 1.0 Experimental.
48-
- **ProjectReunionInstall.exe** if you are using version 0.8 Preview.
48+
- **ProjectReunionInstall.exe** if you are using version 0.8 Preview and earlier.
4949

5050
You should see an output similar to the following:
5151

hub/apps/windows-app-sdk/release-channels.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ The Windows App SDK has a lifecycle. A lifecycle begins when a version or servic
5252

5353
| Windows App SDK version | Original release date | Latest patch version | Patch release date | Support level | End of support |
5454
|---|---|---|---|---|---|
55-
|0.8| 6/24/2021 |0.8.2|8/13/2021|Current | 6/24/2022 |
55+
|0.8| 6/24/2021 |0.8.4| 9/22/2021|Current | 6/24/2022 |
5656
|0.5| 3/29/2021 | 0.5.8 | 7/13/2021 | Maintenance | 11/1/2021 |
5757

5858
### Servicing

hub/apps/windows-app-sdk/remove-windows-app-sdk-versions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,13 @@ The Windows App SDK runtime includes the [framework](deployment-architecture.md#
2323
First, run the `get-appxpackage` command to list all versions of the Windows App SDK runtime packages that are installed on your computer (including the framework, main, singleton, and DDLM packages). The list includes details about each runtime package, including the **PackageFullName** value. For an example of the output of this command, see [Check for installed versions of the Windows App SDK runtime](check-windows-app-sdk-versions.md).
2424

2525
```Powershell
26-
# For 1.0 Preview 1
26+
# For 1.0 Preview 1 and later
2727
get-appxpackage *appruntime*
2828
2929
# For 1.0 Experimental
3030
get-appxpackage *WindowsAppSDK*
3131
32-
# For 0.8 versions and older
32+
# For 0.8 versions and earlier
3333
get-appxpackage *reunion*
3434
```
3535

0 commit comments

Comments
 (0)