Skip to content
Open
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
7 changes: 0 additions & 7 deletions microsoft-edge/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2356,10 +2356,6 @@
- name: Distribute your app and the WebView2 Runtime
href: ./webview2/concepts/distribution.md

- name: Enterprise management of WebView2 Runtimes
href: ./webview2/concepts/enterprise.md
displayName: Manage WebView2 applications # old title

- name: Distribute an app as a single executable file
href: ./webview2/how-to/static.md
displayName: Statically link the WebView2 loader library, single-file app # old title
Expand All @@ -2378,9 +2374,6 @@

- name: Develop secure WebView2 apps
href: ./webview2/concepts/security.md

- name: Prevent security tools from blocking WebView2-hosted apps
href: ./webview2/concepts/measures.md
# -----------------------------------------------------------------------------
- name: Test and automation for WebView2 apps
items:
Expand Down
43 changes: 31 additions & 12 deletions microsoft-edge/webview2/concepts/distribution.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,15 +19,28 @@ When distributing your WebView2 app, make sure that the WebView2 Runtime is pres

For introductory information, see [Evergreen vs. fixed version of the WebView2 Runtime](./evergreen-vs-fixed-version.md).


<!-- ------------------------------ -->
#### Servicing the WebView2 Runtime through Windows Server Update Services (WSUS)<!-- todo: deprecated -->

See [Windows Server Update Services (WSUS)](./enterprise.md#windows-server-update-services-wsus) in _Enterprise management of WebView2 Runtimes_.
**Detailed contents:**
* [Runtime or browser support during development or production](#runtime-or-browser-support-during-development-or-production)
* [Microsoft Edge Stable channel isn't supported for WebView2](#microsoft-edge-stable-channel-isnt-supported-for-webview2)
* [The Evergreen Runtime distribution mode](#the-evergreen-runtime-distribution-mode)
* [Windows 11 devices and Windows 10 devices (details)](#windows-11-devices-and-windows-10-devices-details)
* [Deploying the Evergreen WebView2 Runtime](#deploying-the-evergreen-webview2-runtime)
* [Installing the Runtime as per-machine or per-user](#installing-the-runtime-as-per-machine-or-per-user)
* [Detect if a WebView2 Runtime is already installed](#detect-if-a-webview2-runtime-is-already-installed)
* [Online-only deployment](#online-only-deployment)
* [Offline deployment](#offline-deployment)
* [Handle Evergreen WebView2 Runtime updates](#handle-evergreen-webview2-runtime-updates)
* [Test your app for forward-compatibility](#test-your-app-for-forward-compatibility)
* [Feature-detect when using recent APIs](#feature-detect-when-using-recent-apis)
* [The Fixed Version runtime distribution mode](#the-fixed-version-runtime-distribution-mode)
* [Known issues for Fixed Version](#known-issues-for-fixed-version)
* [Files to ship with the app](#files-to-ship-with-the-app)
* [Servicing the WebView2 Runtime through Windows Server Update Services (WSUS)](#servicing-the-webview2-runtime-through-windows-server-update-services-wsus)
* [See also](#see-also)


<!-- ------------------------------ -->
#### Runtime or browser support during development or production
<!-- ====================================================================== -->
## Runtime or browser support during development or production

During development and testing, a WebView2 app can use either option as the backing web platform:

Expand All @@ -38,14 +51,14 @@ During development and testing, a WebView2 app can use either option as the back
A production release of a WebView2 app can only use the WebView2 Runtime as the backing web platform, not Microsoft Edge.


<!-- ---------- -->
###### Microsoft Edge Stable channel isn't supported for WebView2
<!-- ------------------------------ -->
#### Microsoft Edge Stable channel isn't supported for WebView2

WebView2 apps aren't permitted to use the Stable channel of Microsoft Edge as the backing web platform. This restriction prevents a production release of a WebView2 app from taking a dependency on the browser. A WebView2 app cannot take a dependency on the browser during production, for the following reasons:

* Microsoft Edge isn't guaranteed to be present on all user devices. Many devices in enterprises and in education are disconnected from Windows Update or aren't managed by Microsoft directly. Such devices might not have Microsoft Edge installed. Requiring the production version of WebView2 apps to use the WebView2 Runtime rather than Microsoft Edge avoids making Microsoft Edge a prerequisite for running a WebView2 app.

* Browsers and apps have different use cases. If a WebView2 app required the presence of Microsoft Edge on the client, that would potentially have unintended side-effects on the WebView2 app. For example, an IT admin can prevent the browser from being updated from a specific version, to keep the browser compatible with an internal website. Requiring the production version of a WebView2 app to use the WebView2 Runtime rather than the browser allows the WebView2 app to stay evergreen even if browser updates are prevented by the clients' admin.
* Browsers and apps have different use cases. If a WebView2 app required the presence of Microsoft Edge on the client, that would potentially have unintended side-effects on the WebView2 app. For example, an IT Admin can prevent the browser from being updated from a specific version, to keep the browser compatible with an internal website. Requiring the production version of a WebView2 app to use the WebView2 Runtime rather than the browser allows the WebView2 app to stay evergreen even if browser updates are prevented by the clients' admin.

* As opposed to the browser, the WebView2 Runtime is developed and tested for app scenarios, and in some cases the WebView2 Runtime might include bug fixes that aren't yet available in the browser.

Expand Down Expand Up @@ -350,6 +363,12 @@ Example managed app folder structure:
```


<!-- ====================================================================== -->
## Servicing the WebView2 Runtime through Windows Server Update Services (WSUS)<!-- todo: deprecated -->

See [Windows Server Update Services (WSUS)](/deployedge/webview2-enterprise#windows-server-update-services-wsus) in _Enterprise management of WebView2_.


<!-- ====================================================================== -->
## See also
<!-- all links in the article -->
Expand All @@ -359,16 +378,16 @@ Example managed app folder structure:
* [Prerelease and Release SDKs for WebView2](./versioning.md)<!-- toc bucket 6 leaf 2 -->
* [Feature-detecting to test whether the installed Runtime supports recently added APIs](./versioning.md#feature-detecting-to-test-whether-the-installed-runtime-supports-recently-added-apis) in _Prerelease and Release SDKs for WebView2_.
* [Evergreen vs. fixed version of the WebView2 Runtime](./evergreen-vs-fixed-version.md)<!-- toc bucket 6 leaf 3 -->
* [Windows Server Update Services (WSUS)](./enterprise.md#windows-server-update-services-wsus) in _Enterprise management of WebView2 Runtimes_.<!-- toc bucket 6 leaf 4 -->
* [Test upcoming APIs and features](../how-to/set-preview-channel.md)<!-- toc bucket 8 top -->
* [Prerelease testing using preview channels](../how-to/prerelease-testing.md)<!-- toc bucket 8 bottom -->
* [Self-host by deploying preview channels](../how-to/self-hosting.md)<!-- toc bucket 8 very bottom -->
* [Distribute a WebView2 app as a single executable file](../how-to/static.md) - statically linking the WebView2 loader library.

Enterprise docs:
Microsoft Edge Enterprise documentation:
* [Microsoft Edge release schedule](/deployedge/microsoft-edge-release-schedule)<!-- link not in article body -->
* [Release notes for Microsoft Edge Stable Channel](/deployedge/microsoft-edge-relnote-stable-channel)
* [Release notes for Microsoft Edge Security Updates](/deployedge/microsoft-edge-relnotes-security)
* [Windows Server Update Services (WSUS)](/deployedge/webview2-enterprise#windows-server-update-services-wsus) in _Enterprise management of WebView2_.

developer.microsoft.com:
* [Download the WebView2 Runtime](https://developer.microsoft.com/microsoft-edge/webview2#download) - Developers.
Expand Down
139 changes: 0 additions & 139 deletions microsoft-edge/webview2/concepts/enterprise.md

This file was deleted.

Loading