Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 18 additions & 8 deletions microsoft-edge/progressive-web-apps/how-to/app-actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ ms.author: msedgedevrel
ms.topic: conceptual
ms.service: microsoft-edge
ms.subservice: pwa
ms.date: 05/19/2025
ms.date: 06/24/2025
---
# Enable App Actions on Windows for a PWA

Expand Down Expand Up @@ -262,9 +262,7 @@ The above code is not in [Demos/wami/manifest.json](https://github.com/Microsoft

At the current stage, your PWA needs to be packaged as a Microsoft Store PWA, to be called by the Windows App Actions framework. You must use Microsoft Edge 137 or greater.

The Stable release of Edge 137 will be available on May 29, 2025. If you'd like to try it out before May 29, 2025, you can package your PWA in Edge Canary; see [Package a store PWA in Edge Canary](#package-a-store-pwa-in-edge-canary), below.

1. Upgrade to Edge Stable 137 version. (Edge 137 stable will be available after May 29, 2025.)
1. Upgrade to Edge Stable 137 version.

1. Package your PWA for [PWABuilder.com](https://www.pwabuilder.com); see [Package your PWA for the Store](./microsoft-store.md#package-your-pwa-for-the-store) in _Publish a PWA to the Microsoft Store_.

Expand All @@ -276,19 +274,31 @@ The Stable release of Edge 137 will be available on May 29, 2025. If you'd like

1. Click the **Download** button.

1. Unzip your download archive. Then you can [publish your PWA to the Microsoft Store](./microsoft-store.md) and install the app from the Store, or install it directly by running `install.ps1`.
1. Unzip your download archive. Install it by running `install.ps1`.

1. Launch your PWA by clicking the PWA icon.

1. Test your PWA actions locally by following [Test App Actions for a PWA](#test-app-actions-for-a-pwa), below, to validate the functionality.

1. Open the action definition manifest file (such as `ActionsManifest.json`) that you used when packaging in PWAbuilder.com.

1. Set the initial availability of each of the app actions to `false`, as described in [Set initial availability](/windows/ai/app-actions/actions-availability#set-initial-availability) in _Toggle availability of an App Action for Windows_.

Before publishing your package, we recommend the above step. If you don't set the initial availability of the app action to `false`, your action will only work if the user manually goes to `edge://flags` in Microsoft Edge and then enables the feature flag `#edge-app-actions-on-windows-for-web-apps`.

Setting the initial availability to `false` is needed because Microsoft Edge's support of App Actions on Windows in PWAs is controlled by the feature flag `#edge-app-actions-on-windows-for-web-apps`, and is disabled by default, because this is a new feature in the Edge browser and is currently in Developer Trial<!-- not Origin Trial--> stage, as of June 26, 2025.

When the feature flag `#edge-app-actions-on-windows-for-web-apps` is officially rolled out (later in 2025),<!-- todo: update after rolled out --> Microsoft Edge will automatically switch the actions that you defined in the action definition manifest file from `Disabled` to `Enabled`, allowing end users to utilize your app's actions without requiring any further changes on your part.

1. Publish your PWA, as described in [Publish a PWA to the Microsoft Store](/microsoft-edge/progressive-web-apps-chromium/how-to/microsoft-store).


<!-- ====================================================================== -->
## Package a store PWA in Edge Canary

The Stable release of Edge 137 will be available on May 29, 2025; see [Package a store PWA in Edge Stable](#package-a-store-pwa-in-edge-stable), above.

Edge Canary gives a preview of the functionalities that's not available in stable yet.

If you want to try out App Actions for PWAs before May 29, 2025, you can package your PWA in Edge Canary, as follows:
If you want to try out the latest capabilities of App Actions in Edge Canary, you can package your PWA in Edge Canary, as follows:

1. Install [Edge Canary](https://www.microsoft.com/edge/download/insider) and upgrade to the latest version.

Expand Down
6 changes: 5 additions & 1 deletion microsoft-edge/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,13 @@
href: ./web-platform/release-notes/index.md
displayName: what's new, announcements

- name: Microsoft Edge 139
href: ./web-platform/release-notes/139.md
displayName: Microsoft Edge 139 web platform release notes (Aug. 2025) # page title

- name: Microsoft Edge 138
href: ./web-platform/release-notes/138.md
displayName: Microsoft Edge 137 web platform release notes (Jun. 2025) # page title
displayName: Microsoft Edge 138 web platform release notes (Jun. 2025) # page title

- name: Microsoft Edge 137
href: ./web-platform/release-notes/137.md
Expand Down
2 changes: 1 addition & 1 deletion microsoft-edge/web-platform/release-notes/133.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ See [What's New in DevTools (Microsoft Edge 133)](../../devtools/whats-new/2025/
<!-- ====================================================================== -->
## WebView2

See [1.0.3065.39](../../webview2/release-notes/index.md#10306539) in _Release Notes for the WebView2 SDK_ (Feb. 2025).
See [1.0.3065.39](../../webview2/release-notes/archive.md#10306539) in _Archived Release Notes for the WebView2 SDK_ (Feb. 2025).


<!-- ====================================================================== -->
Expand Down
8 changes: 3 additions & 5 deletions microsoft-edge/webview2/concepts/versioning.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,17 +30,15 @@ New APIs are introduced in phases as follows:

| API status | Description |
|---|---|
| _Experimental_ | 1. First an API is Experimental in a Prerelease SDK. You can test these APIs and provide feedback. The API isn't in a Release SDK yet. |
| _Experimental in a Prerelease SDK_ | 1. First an API is Experimental in a Prerelease SDK. You can test these APIs and provide feedback. The API isn't in a Release SDK yet. |
| _Stable in a Prerelease SDK_ | 2. Then the API is promoted to Stable in the Prerelease SDK. The API isn't in a Release SDK yet. |
| _Stable in a Release SDK_ | 3. Then the Stable API is promoted to be included in the Release SDK. This typically happens 1 month after the API is promoted to Stable in a Prerelease SDK. The API also remains in the Prerelease SDK. |

![Diagram of phases of introducing new APIs](./versioning-images/phases-of-adding-apis.png)
<!-- .png is used by webview2/release-notes/about.md and webview2/concepts/versioning.md -->

<!-- terminology:
APIs are Experimental or Stable
SDKs/packages are Prerelease or Release
-->
See also:
* [Phases of adding APIs](../release-notes/about.md#phases-of-adding-apis) in _About Release Notes for the WebView2 SDK_.


<!-- ------------------------------ -->
Expand Down
25 changes: 21 additions & 4 deletions microsoft-edge/webview2/release-notes/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,14 +25,31 @@ See also:
<!-- ====================================================================== -->
## Phases of adding APIs

New APIs are added in phases, as follows:
1. APIs are initially introduced as Experimental APIs in a Prerelease SDK package.
1. Then they become Stable APIs in a Prerelease SDK package.
1. Soon after, they become Stable APIs in a Release SDK package. Sometimes, APIs are simultaneously promoted to Stable in a Prerelease SDK and Stable in a Release SDK.
New APIs are added in three phases, as follows:

1. APIs are initially introduced as Experimental APIs in a Prerelease SDK package. In Win32, the type name includes the word "Experimental".

1. Then the APIs become Stable APIs in a Prerelease SDK package. In Win32, the type name omits the word "Experimental".

1. Soon after, the APIs become Stable APIs in a Release SDK package. Sometimes, APIs are simultaneously promoted to Stable in a Prerelease SDK and Stable in a Release SDK.

![Diagram of phases of introducing new APIs](./about-images/phases-of-adding-apis.png)
<!-- .png is used by webview2/release-notes/about.md and webview2/concepts/versioning.md -->

Shorthand names of the phases:

1. Experimental in Prerelease
1. Stable in Prerelease
1. Stable in Release

Release Notes sections use this wording for the phases:

* The following APIs are in Phase 1: Experimental in Prerelease, and have been added in this Prerelease SDK.

* The following APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, and are included in this Prerelease SDK.

* The following APIs have been promoted from Phase 2: Stable in Prerelease, to Phase 3: Stable in Release, and are now included in this Release SDK.

See also:
* [Phases of introducing APIs](../concepts/versioning.md#phases-of-introducing-apis) in _Prerelease and Release SDKs for WebView2_.

Expand Down
100 changes: 95 additions & 5 deletions microsoft-edge/webview2/release-notes/archive.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,100 @@ ms.author: msedgedevrel
ms.topic: conceptual
ms.service: microsoft-edge
ms.subservice: devtools
ms.date: 06/03/2025
ms.date: 06/30/2025
---
# Archived Release Notes for the WebView2 SDK

These Release Notes provide information about added features and bug fixes that are included in the WebView2 Release SDK and the WebView2 Prerelease SDK, for older releases.


<!-- Feb 2025 Release SDK -->
<!-- ====================================================================== -->
## 1.0.3065.39

Release Date: February 10, 2025

[NuGet package for WebView2 SDK 1.0.3065.39](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3065.39)

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 133.0.3065.39 or higher.


<!-- ------------------------------ -->
#### Promotions

No additional APIs have been promoted to Stable and added in this Release SDK.


<!-- ------------------------------ -->
#### Bug fixes


<!-- ---------- -->
###### Runtime-only

* Added the missing **Close** button in the **Download** flyout.
* Fixed a race condition that occurred when the Web Request Response event never occurs.

<!-- end of Feb 2025 Release SDK -->


<!-- Feb 2025 Prerelease SDK -->
<!-- ====================================================================== -->
## 1.0.3116-prerelease

Release Date: February 10, 2025

[NuGet package for WebView2 SDK 1.0.3116-prerelease](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3116-prerelease)

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 134.0.3116.0 or higher.


<!-- ------------------------------ -->
#### Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.


<!-- ------------------------------ -->
#### Promotions

No APIs have been promoted from Experimental to Stable in this Prerelease SDK.



<!-- ------------------------------ -->
#### Bug fixes


<!-- ---------- -->
###### Runtime-only

* Added the missing **Close** button in the **Download** flyout.
* Fixed a race condition that occurred when the Web Request Response event never occurs.


<!-- ---------- -->
###### SDK-only

* Fixed .NET and Win32 documentation of the `CoreWebView2Find.FindNext` method that incorrectly mentioned `FindPrevious`. The method summary now mentions `FindNext` instead. ([Issue #5059](https://github.com/MicrosoftEdge/WebView2Feedback/issues/5059))

##### [.NET/C#](#tab/dotnetcsharp)

* [CoreWebView2Find.FindNext Method](/dotnet/api/microsoft.web.webview2.core.corewebview2find.findnext?view=webview2-dotnet-1.0.3116-prerelease&preserve-view=true)

##### [WinRT/C#](#tab/winrtcsharp)

* [CoreWebView2Find.FindNext Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2find?view=webview2-winrt-1.0.3116-prerelease&preserve-view=true#findnext)

##### [Win32/C++](#tab/win32cpp)

* [ICoreWebView2ExperimentalFind::FindNext](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalfind?view=webview2-1.0.3116-prerelease&preserve-view=true#findnext)

---

<!-- end of Feb 2025 Prerelease SDK -->


<!-- Jan 2025 Release SDK -->
<!-- ====================================================================== -->
## 1.0.2957.106
Expand Down Expand Up @@ -109,9 +196,11 @@ There are known issues with the Find API for PDF documents. When you view a PDF

##### [.NET/C#](#tab/dotnetcsharp)

* [CoreWebView2.Find Property](/dotnet/api/microsoft.web.webview2.core.corewebview2.find?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
* `CoreWebView2` Class:
* [CoreWebView2.Find Property](/dotnet/api/microsoft.web.webview2.core.corewebview2.find?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)

* [CoreWebView2Environment.CreateFindOptions Method](/dotnet/api/microsoft.web.webview2.core.corewebview2environment.createfindoptions?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
* `CoreWebView2Environment` Class:
* [CoreWebView2Environment.CreateFindOptions Method](/dotnet/api/microsoft.web.webview2.core.corewebview2environment.createfindoptions?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)

* [CoreWebView2Find Class](/dotnet/api/microsoft.web.webview2.core.corewebview2find?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
* [CoreWebView2Find.ActiveMatchIndex Property](/dotnet/api/microsoft.web.webview2.core.corewebview2find.activematchindex?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
Expand All @@ -132,9 +221,10 @@ There are known issues with the Find API for PDF documents. When you view a PDF

##### [WinRT/C#](#tab/winrtcsharp)

* [CoreWebView2.Find Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true#find)
* `CoreWebView2` Class:
* [CoreWebView2.Find Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true#find)

* [CoreWebView2Environment Class](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2environment?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true)
* `CoreWebView2Environment` Class:
* [CoreWebView2Environment.CreateFindOptions Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2environment?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true#createfindoptions)

* [CoreWebView2Find Class](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2find?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true)
Expand Down
131 changes: 131 additions & 0 deletions microsoft-edge/webview2/release-notes/includes/templates.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,131 @@
<!-- Jul 2025 Release SDK -->
<!-- ====================================================================== -->
## 1.0.####.##

Release Date: Monthname nn, 2025

[NuGet package for WebView2 SDK 1.0.####.##](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.####.##)

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version ###.0.####.## or higher.


<!-- ------------------------------ -->
#### Promotions

No additional APIs have been promoted to Stable and added in this Release SDK.
The following APIs have been promoted from Phase 2: Stable in Prerelease, to Phase 3: Stable in Release, and are now included in this Release SDK.


<!-- ---------- -->
###### heading

description

##### [.NET/C#](#tab/dotnetcsharp)

##### [WinRT/C#](#tab/winrtcsharp)

##### [Win32/C++](#tab/win32cpp)

---


<!-- ------------------------------ -->
#### Bug fixes


<!-- ---------- -->
###### Runtime and SDK

* Fixed behavior. ([Issue #]())


<!-- ---------- -->
###### Runtime-only

* Fixed behavior. ([Issue #]())


<!-- ---------- -->
###### SDK-only

* Fixed behavior. ([Issue #]())

<!-- end of Jul 2025 Release SDK -->


<!-- Jul 2025 Prerelease SDK -->
<!-- ====================================================================== -->
## 1.0.####-prerelease

Release Date: Monthname nn, 2025

[NuGet package for WebView2 SDK 1.0.####-prerelease](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.####-prerelease)

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version ###.0.####.0 or higher.


<!-- ------------------------------ -->
#### Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.
The following APIs are in Phase 1: Experimental in Prerelease, and have been added in this Prerelease SDK.


<!-- ---------- -->
###### heading

description

##### [.NET/C#](#tab/dotnetcsharp)

##### [WinRT/C#](#tab/winrtcsharp)

##### [Win32/C++](#tab/win32cpp)

---


<!-- ------------------------------ -->
#### Promotions

No APIs have been promoted from Experimental to Stable in this Prerelease SDK.
The following APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, and are included in this Prerelease SDK.


<!-- ---------- -->
###### heading

description

##### [.NET/C#](#tab/dotnetcsharp)

##### [WinRT/C#](#tab/winrtcsharp)

##### [Win32/C++](#tab/win32cpp)

---


<!-- ------------------------------ -->
#### Bug fixes


<!-- ---------- -->
###### Runtime and SDK

* Fixed behavior. ([Issue #]())


<!-- ---------- -->
###### Runtime-only

* Fixed behavior. ([Issue #]())


<!-- ---------- -->
###### SDK-only

* Fixed behavior. ([Issue #]())

<!-- end of Jul 2025 Prerelease SDK -->
Loading
Loading