1. Developing Applications with Oracle ADF Desktop Integration
  2. The Embedded Browser
  3. Microsoft WebView2 Support

Microsoft WebView2 Support

Microsoft WebView2 is an embedded web browser based on Edge/Chromium. For ADF Desktop Integration to use WebView2, the WebView2 runtime must be installed on each computer where the add-in runs.

Download and Install WebView2 Runtime

You can download and install the runtime from here: https://developer.microsoft.com/en-us/microsoft-edge/webview2/consumer/.

Choose one of the "evergreen" installers. Do not choose the "Fixed Version" option.

Note:

The WebView2 runtime may already be present on your computer if you have Microsoft 365 Apps installed. See Microsoft Edge WebView2 and Microsoft 365 Apps.

Delete the WebView2 Browser Cache

The WebView2 browser control uses a user data folder on the local computer to store browser data, such as cookies, permissions, and cached resources. This folder can be found under %LocalAppData%\Oracle\ADF Desktop Integration\; for example, C:\Users\<user-name>\AppData\Local\Oracle\ADF Desktop Integration\EBWebView.

To clear the browser cache, simply delete the EBWebView folder.

Note:

You'll need the appropriate rights to access and delete the cache folder.

See Manage the User Data Folder in the Microsoft Edge documentation.

To delete the browser cache:

  1. Close all instances of Excel.
  2. Open Windows File Explorer.
  3. To navigate to the parent folder of the browser cache, paste %LocalAppData%\Oracle\ADF Desktop Integration\ in the Location area, then press Enter.

    If there is a browser cache, you'll see a EBWebView subfolder. If EBWebView does not exist, the cache has already been cleared.

    If the parent folder (ADF Desktop Integration) does not exist, no browser cache is present.

  4. If you see a EBWebView subfolder, select it and press Delete.

Technical Notes

If there is a problem displaying a web page—for example, if the page throws a JavaScript error—please contact the page owner. Such pages are outside the scope of ADF Desktop Integration. Let the page owner know that the page needs to be compatible with Edge/Chromium.

Workbook developers who are creating web pages to be displayed by the add-in should refer to Feature differences between Microsoft Edge and WebView2 on the Microsoft web site for more information.

When the add-in uses the WebView2 browser control, the browser's SmartScreen feature is disabled. See the Microsoft Defender SmartScreen Frequently Asked Questions or the documentation for more information.

When the add-in uses the WebView2 browser control, it enables some Microsoft capabilities relating to single sign-on (SSO) with Azure Active Directory, such as the AllowSingleSignOnUsingOSPrimaryAccount property. This feature is present in add-in versions 5.1.1.24317 or later. See the AllowSingleSignOnUsingOSPrimaryAccount property in the Microsoft API Reference.