BREAKING CHANGES

[salvadordf]

Hi,

This will be a fixed thread with all the breaking changes in WebView4Delphi.

The WebView4Delphi update made on December 31st, 2021 had the following breaking changes :

• Added a aResourceID parameter to the TWVBrowserBase.OnWebResourceResponseViewGetContentCompleted event.
• Renamed TWVBrowserBase.doIgnoreCertificateErrorsCompleted to TWVBrowserBase.doOnIgnoreCertificateErrorsCompleted.

[salvadordf]

The update made on January 29th, 2022 separated the VCL and FMX packages.

WebView4Delphi_runtime is now split into WebView4DelphiVCLRTL and WebView4DelphiFMXRTL.

[salvadordf]

The update made in March 11th, 2022 renamed the "aWebView" parameter to "aFrame" in TWVBrowserBase.OnFrameNavigationStarting, TWVBrowserBase.OnFrameNavigationCompleted, TWVBrowserBase.OnFrameContentLoading, TWVBrowserBase.OnFrameDOMContentLoaded and
TWVBrowserBase.OnFrameWebMessageReceived.

[salvadordf]

The update made in April 16th, 2022 renamed the TWVBrowserBase.UIAProvider property to TWVBrowserBase.AutomationProvider.

[salvadordf]

The update made in June 4th, 2022 modified the Delphi packages.

If you install WebView4Delphi in Delphi you still have to open WebView4Delphi_group.groupproj but now you have two options :

• If you want to install the FMX and VCL components then select the "Build All" context menu option and then select "Install" in WebView4DelphiVCL_designtime.bpl and WebView4DelphiFMX_designtime.bpl
• If you just want to install the VCL components then build WebView4DelphiVCLRTL.bpl and install WebView4DelphiVCL_designtime.bpl.

Read the announcement for more details :
https://www.briskbard.com/forum/viewtopic.php?p=8212#p8212

[salvadordf]

The update made in January 17th, 2023 had the following breaking changes :

• Modified the parameters in the TWVBrowserBase.OnPrintCompleted event.

Read the announcement for more details :
https://www.briskbard.com/forum/viewtopic.php?p=8792#p8792

[salvadordf]

The update made in December 18th, 2023 had the following breaking changes :

• Changed the "aFrameID" argument type from integer to cardinal in all TWVBrowserBase events!!!
• Changed TCoreWebView2Frame.FrameId from integer to cardinal.
• Changed the parameters in TCoreWebView2Frame.Create.

Breaking Change: If you're developing an unpackaged Win32 app using Fixed Version Runtime v120 or above and targeting Windows 10 devices, you need to run a couple of ACL shell commands (icacls), to avoid crashing, because of a new security feature implemented in WebView2. See [Breaking Change] Unpackaged Win32 app using Fixed Version v120+ on Win10 need ACL. The fix is in the article Distribute your app and the WebView2 Runtime, section Details about the Fixed Version runtime distribution mode, step "On Windows 10 devices, starting with Fixed Version 120, developers of unpackaged Win32 applications using Fixed Version are required to run the following commands."

Read the announcement for more details :
https://www.briskbard.com/forum/viewtopic.php?p=9339#p9339

[salvadordf]

The update made in February 6th, 2024 had the following breaking change :

• Navigations to about:blank are now cancellable via the NavigationStarting event. To revert to the old behavior, disable the msWebView2CancellableAboutNavigations feature flag.

Read the announcement for more details :
https://www.briskbard.com/forum/viewtopic.php?p=9474#p9474

[salvadordf]

The update made in March 9th, 2024 had the following breaking changes :

• Removed TWVBrowserBase.CustomItemSelectedEventHandler.
• TCoreWebView2ContextMenuItem.AddCustomItemSelectedEvent is now protected.

Read the announcement for more details :
https://www.briskbard.com/forum/viewtopic.php?p=9575#p9575

[salvadordf]

The update made in April 23rd, 2024 had the following breaking change :

• Updated TCoreWebView2EnvironmentOptions.Create with two new arguments : aChannelSearchKind and aReleaseChannels.

Read the announcement for more details :
https://www.briskbard.com/forum/viewtopic.php?p=9689#p9689