Skip to content

Commit fa67cd2

Browse files
committed
Remove outdated preview warning
1 parent 904abb8 commit fa67cd2

File tree

3 files changed

+15
-20
lines changed

3 files changed

+15
-20
lines changed

hub/apps/windows-app-sdk/applifecycle/applifecycle-instancing.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,6 @@ An app's instancing model determines whether multiple instances of your app's pr
1313

1414
## Prerequisites
1515

16-
17-
1816
To use the app lifecycle API in the Windows App SDK:
1917

2018
1. Download and install the latest release of the Windows App SDK. For more information, see [Install tools for the Windows App SDK](../set-up-your-development-environment.md).
@@ -407,7 +405,7 @@ void CALLBACK OnFileClosed(HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam
407405
}
408406
```
409407
410-
> [!Warning]
408+
> [!WARNING]
411409
> Although keys are automatically unregistered when their process terminates, race conditions are possible where another instance may have initiated a redirection to the terminated instance before the terminated instance was unregistered. To mitigate this possibility, an app can use [UnregisterKey](/windows/windows-app-sdk/api/winrt/microsoft.windows.applifecycle.appinstance.unregisterkey) to manually unregister its key before it is terminated, giving the app a chance to redirect activations to another app that is not in the process of exiting.
412410
413411
### Instance information

hub/apps/windows-app-sdk/applifecycle/applifecycle-power.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ To use the app lifecycle API in the Windows App SDK:
2424

2525
The following example demonstrates how to subscribe and respond to [PowerManager](/windows/windows-app-sdk/api/winrt/microsoft.windows.system.power.powermanager) events. This code subscribes to the [BatteryStatusChanged](/windows/windows-app-sdk/api/winrt/microsoft.windows.system.power.powermanager.batterystatuschanged) event during startup. The app then responds to changes by checking the current power level and adjusting its resource usage appropriately. For example, if the battery discharges at a low power state, the app might defer any non-critical background work.
2626

27-
### [C++](#tab/cpp)
27+
#### [C++/WinRT](#tab/cpp)
2828

2929
> [!NOTE]
3030
> Apps can register and unregister for these events at any time, but most apps will want to set callbacks in `WinMain` that persist as long as the app continues to run.
@@ -96,7 +96,7 @@ void OnPowerSupplyStatusChanged()
9696
}
9797
```
9898

99-
### [C#](#tab/csharp)
99+
#### [C#](#tab/csharp)
100100

101101
> [!NOTE]
102102
> Apps can register and unregister for these events at any time, but most apps will want to set callbacks that persist as long as the app continues to run.
@@ -156,7 +156,7 @@ private void OnPowerSupplyStatusChanged()
156156

157157
[PowerManager](/windows/windows-app-sdk/api/winrt/microsoft.windows.system.power.powermanager) events are relatively low-level, and in some scenarios, a single event handler being called might not provide enough information for the app to decide how to behave. In this example, the [PowerSupplyStatusChanged](/windows/windows-app-sdk/api/winrt/microsoft.windows.system.power.powermanager.powersupplystatuschanged) event could be called when the device is disconnected from power. In that case, the app must check the current battery status before deciding how to proceed.
158158

159-
### [C++](#tab/cpp)
159+
#### [C++/WinRT](#tab/cpp)
160160

161161
```cpp
162162
void DetermineWorkloads()
@@ -186,7 +186,7 @@ void DetermineWorkloads()
186186
}
187187
```
188188

189-
### [C#](#tab/csharp)
189+
#### [C#](#tab/csharp)
190190

191191
```csharp
192192
private void DetermineWorkloads()
@@ -222,7 +222,7 @@ private void DetermineWorkloads()
222222

223223
The [PowerManager](/windows/windows-app-sdk/api/winrt/microsoft.windows.system.power.powermanager) class offers information about other device states relevant to an app's power usage. For example, apps can disable graphics processing when the device's display is turned off.
224224

225-
### [C++](#tab/cpp)
225+
#### [C++/WinRT](#tab/cpp)
226226

227227
```cpp
228228
void OnDisplayStatusChanged()
@@ -257,7 +257,7 @@ void OnDisplayStatusChanged()
257257
}
258258
```
259259

260-
### [C#](#tab/csharp)
260+
#### [C#](#tab/csharp)
261261

262262
```csharp
263263
private void OnDisplayStatusChanged()
@@ -288,7 +288,7 @@ private void OnDisplayStatusChanged()
288288

289289
Apps can register and deregister for notifications during their lifecycle. Use your language's preferred event registration management system if your app doesn't need to receive power status notifications during its entire lifecycle.
290290

291-
### [C++](#tab/cpp)
291+
#### [C++/WinRT](#tab/cpp)
292292

293293
```cpp
294294
void UnregisterPowerManagerCallbacks()
@@ -302,7 +302,7 @@ void UnregisterPowerManagerCallbacks()
302302
}
303303
```
304304

305-
### [C#](#tab/csharp)
305+
#### [C#](#tab/csharp)
306306

307307
```csharp
308308
private void UnregisterPowerManagerCallbacks()

hub/apps/windows-app-sdk/applifecycle/applifecycle-rich-activation.md

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
description: Describes how to use rich activation features with the app lifecycle API in unpackaged apps (Windows App SDK).
33
title: Rich activation with the app lifecycle API (Windows App SDK)
44
ms.topic: article
5-
ms.date: 11/16/2021
5+
ms.date: 03/07/2024
66
keywords: AppLifecycle, Windows, activation, activation contracts, rich activation, win32, win32 activation, unpackaged app, unpackaged app activation
77
ms.localizationpriority: medium
88
---
@@ -18,12 +18,9 @@ Supporting rich activations requires two steps:
1818

1919
## Prerequisites
2020

21-
> [!IMPORTANT]
22-
> The app lifecycle API is currently supported in the [preview release channel](../preview-channel.md) and [experimental release channel](../experimental-channel.md) of the Windows App SDK. This feature is not currently supported for use by apps in production environments.
23-
2421
To use the app lifecycle API in the Windows App SDK:
2522

26-
1. Download and install the latest preview or experimental release of the Windows App SDK. For more information, see [Install tools for the Windows App SDK](../set-up-your-development-environment.md).
23+
1. Download and install the latest release of the Windows App SDK. For more information, see [Install tools for the Windows App SDK](../set-up-your-development-environment.md).
2724
2. Follow the instructions to [Create your first WinUI 3 project](../../winui/winui3/create-your-first-winui3-app.md) or to [use the Windows App SDK in an existing project](../use-windows-app-sdk-in-existing-project.md).
2825

2926
## Activation details for unpackaged apps
@@ -32,10 +29,10 @@ The current version of the Windows App SDK supports the four most common activat
3229

3330
| Activation kind | Description |
3431
| --------------- | ------------------------------------------------------------ |
35-
| `Launch` | Activate the app from the command line, when the user double-clicks the app's icon, or programmatically via [ShellExecute](/windows/win32/api/shellapi/nf-shellapi-shellexecuteexw) or [CreateProcess](/windows/win32/api/processthreadsapi/nf-processthreadsapi-createprocessw). |
36-
| `File` | Activate an app that has registered for a file type when a file of the type is opened via [ShellExecute](/windows/win32/api/shellapi/nf-shellapi-shellexecuteexw), [Launcher.LaunchFileAsync](/uwp/api/windows.system.launcher.launchfileasync), or the command line. |
37-
| `Protocol` | Activate an app that has registered for a protocol when a string of that protocol is executed via [ShellExecute](/windows/win32/api/shellapi/nf-shellapi-shellexecuteexw), [Launcher.LaunchUriAsync](/uwp/api/windows.system.launcher.launchuriasync), or the command-line. |
38-
| `StartupTask` | Activate the app when the user logs into Windows, either because of a registry key, or because of a shortcut in a well-known startup folder. |
32+
| `Launch` | Activate the app from the command line, when the user double-clicks the app's icon, or programmatically via [ShellExecute](/windows/win32/api/shellapi/nf-shellapi-shellexecuteexw) or [CreateProcess](/windows/win32/api/processthreadsapi/nf-processthreadsapi-createprocessw). |
33+
| `File` | Activate an app that has registered for a file type when a file of the type is opened via [ShellExecute](/windows/win32/api/shellapi/nf-shellapi-shellexecuteexw), [Launcher.LaunchFileAsync](/uwp/api/windows.system.launcher.launchfileasync), or the command line. |
34+
| `Protocol` | Activate an app that has registered for a protocol when a string of that protocol is executed via [ShellExecute](/windows/win32/api/shellapi/nf-shellapi-shellexecuteexw), [Launcher.LaunchUriAsync](/uwp/api/windows.system.launcher.launchuriasync), or the command-line. |
35+
| `StartupTask` | Activate the app when the user logs into Windows, either because of a registry key, or because of a shortcut in a well-known startup folder. |
3936

4037
Each type of unpackaged app retrieves its command line arguments in different ways. For example, C++ Win32 apps expect to receive activation arguments to be passed into `WinMain` in the form of a string (though they also have the option to call [GetCommandLineW](/windows/win32/api/processenv/nf-processenv-getcommandlinew)). Windows Forms apps, however, *must* call [Environment.GetCommandLineArgs](/dotnet/api/system.environment.getcommandlineargs), because arguments will not be automatically passed to them.
4138

0 commit comments

Comments
 (0)