Microsoft Edge WebView2 Runtime

Od verze systému ABRA Gen 26.2 je původně používaná interní komponenta Chromium nahrazena komponentou založenou na Microsoft Edge WebView2 Runtime.

WebView2 Runtime slouží k zobrazování webového a HTML obsahu přímo v desktopové aplikaci. V systému se používá všude tam, kde aplikace zobrazuje webový obsah, HTML obsah, náhledy nebo části rozhraní postavené na webových technologiích.

Výhody WebView2 Runtime

Microsoft Edge WebView2 Runtime poskytuje moderní, bezpečné a průběžně aktualizované webové jádro, které je oddělené od jednotlivých verzí systému.

Oproti původnímu integrovanému Chromiu již webové jádro není pevnou součástí instalace systému ABRA Gen. Aktualizace WebView2 Runtime probíhají samostatně prostřednictvím aktualizačního mechanismu Microsoft Edge Update, případně mohou být ve firemním prostředí řízeny správcem systému. Díky tomu nejsou opravy a aktualizace webového jádra závislé pouze na vydání nové verze systému.

Proč dochází ke změně

Původní řešení využívalo interně dodávané Chromium knihovny jako součást instalace systému. Nově je využíván Microsoft Edge WebView2 Runtime, tedy systémová komponenta určená pro aplikace ve Windows.

Změna přináší zejména:

moderní webové jádro používané v aktuálních aplikacích pro Windows,
průběžné aktualizace webového jádra nezávislé na vydávání nových verzí systému,
rychlejší dostupnost bezpečnostních oprav webového jádra,
jednodušší údržbu aplikace,
menší závislost systému na vlastních Chromium knihovnách,
menší instalační balíček a menší velikost nainstalované aplikace díky odstranění původních Chromium souborů.

Došlo také k výraznému zrychlení spuštění aplikace při síťové instalaci.

Kde se WebView2 používá

Změna se projeví na místech, kde systém zobrazuje webový nebo HTML obsah, zejména:

hlavní okno aplikace, Úvod, Aktuality a rozcestník agend,
doplněk Internetový prohlížeč v definovatelných formulářích,
HTML editor a CKEditor,
OAuth a autentizační průvodci,
náhledy dokumentů, XML a ISDOC obsahu,
zobrazení a tisk obsahu e-mailů,
wiki prohlížeč,
helpdesk, licenční a autorizační obrazovky,
další zakázková nebo skriptová místa používající původní webový prohlížeč.

Zpětná kompatibilita

Přechod na WebView2 Runtime je navržen tak, aby byla zachována zpětná kompatibilita v běžných scénářích používání systému.

Uživatelé se mohou setkat s drobnými rozdíly v detailech zobrazení nebo chování webového obsahu, protože WebView2 používá jiné webové jádro než původní Chromium komponenta dodávaná se systémem.

Může jít například o:

vzhled scrollbarů,
chování nebo vzhled kontextové nabídky,
zobrazení URL odkazu při najetí myší,
rozdíly v tisku webového nebo HTML obsahu,
odlišné zpracování některých JavaScript chyb,
drobné rozdíly ve vzhledu nebo umístění některých oken a prvků.

Pokud byla v původním prohlížeči uložená hesla, cookies nebo automatická přihlášení, například v HTML prohlížeči ve formulářích nebo při OAuth přihlášení, bude po změně potřeba přihlásit se znovu.

Součástí instalace systému již nejsou původní Chromium/CEF knihovny. Po přechodu na Microsoft Edge WebView2 Runtime se již nedistribuuje složka cef ani soubory původních komponent CEF4Delphi a NALChromium. Při aktualizaci jsou staré soubory z instalace odstraňovány. Místo nich je součástí instalace pouze potřebný WebView2Loader.dll

Parametr konfiguračního souboru NEXUS.CFG - ChromiumCacheInMemory již není podporován. Souvisel s původní interní Chromium komponentou a po přechodu na Microsoft Edge WebView2 Runtime se nepoužívá. Pokud je v souboru nexus.cfg uveden, nemá na nové WebView2 zobrazení vliv a lze jej z konfigurace odstranit.

Skriptování

Ve skriptování je pro nové realizace určena komponenta TEdgeBrowser. Původní komponenta TChromium zůstává kvůli zpětné kompatibilitě dostupná, ale je označena jako zastaralá.

Pro nové úpravy a nové realizace používejte TEdgeBrowser. Komponenta má stejné rozhraní jako původní TChromium, ale využívá nové webové jádro WebView2.

Stávající skripty používající TChromium by měly zůstat funkční, doporučujeme však jejich postupnou úpravu na TEdgeBrowser, zejména u nových nebo dále rozvíjených zákaznických řešení.

U skriptů a zakázkových úprav, které přímo pracují s webovým obsahem, JavaScriptem, událostmi prohlížeče, tiskem nebo přihlašováním, doporučujeme po přechodu na verzi 26.2 provést ověření chování v konkrétním zákaznickém prostředí.

Aby části aplikace používající WebView2 fungovaly správně, musí být na příslušném počítači dostupný Microsoft Edge WebView2 Runtime.

Instalace WebView2 Runtime

Požadavky na instalaci

U běžné lokální instalace musí být WebView2 Runtime nainstalovaný na počítači uživatele.

U terminálového provozu nebo RemoteApp musí být WebView2 Runtime nainstalovaný na terminálovém serveru, kde běží klient systému ABRA Gen.

Na Windows 11 je WebView2 Runtime součástí systému. Na většině zařízení s Windows 10 již bývá nainstalovaný, přesto doporučujeme jeho přítomnost ověřit. Na Windows Serveru nelze jeho dostupnost po čisté instalaci automaticky předpokládat, proto je potřeba ji zkontrolovat a v případě potřeby WebView2 Runtime doinstalovat.

Instalace

WebView2 Runtime lze stáhnout z oficiální stránky Microsoftu - Microsoft Edge WebView2 Runtime. Pro běžné nasazení doporučujeme použít variantu Evergreen.

Microsoft poskytuje dvě hlavní varianty instalátoru:

Varianta	Použití
Evergreen Bootstrapper	Malý online instalátor, který stáhne a nainstaluje odpovídající WebView2 Runtime podle architektury zařízení. Odkaz ke stažení zde.
Evergreen Standalone Installer	Úplný offline instalátor vhodný pro servery, offline prostředí nebo hromadné nasazení ve firmě.

Pro spravovaná a serverová prostředí doporučujeme instalaci zajistit centrálně správcem systému.

Při spuštění instalátoru se zvýšenými oprávněními proběhne instalace pro celý počítač. Bez zvýšených oprávnění může být WebView2 Runtime nainstalovaný pouze pro aktuálního uživatele.

Doporučení pro správce systému

Před nasazením systému ABRA Gen verze 26.2 doporučujeme:

ověřit přítomnost Microsoft Edge WebView2 Runtime na cílových počítačích nebo terminálových serverech,
v případě potřeby WebView2 Runtime nainstalovat,
pro serverová a offline prostředí použít Evergreen Standalone Installer,
neblokovat aktualizace WebView2 Runtime, pokud tomu nebrání interní bezpečnostní politika,
otestovat části systému, které zobrazují webový nebo HTML obsah,
u zakázkových úprav ověřit použití původní komponenty TChromium a zvážit přechod na TEdgeBrowser.

Podporované operační systémy

WebView2 Runtime se řídí podporou Microsoft Edge / WebView2 pro dané operační systémy Windows.

Obecně jsou podporovány aktuální podporované verze Windows 10, Windows 11 a podporované verze Windows Server, zejména:

Windows 10,
Windows 11,
Windows Server 2016,
Windows Server 2019,
Windows Server 2022,
Windows Server 2025.

Doporučujeme používat operační systém s aktuálními kumulativními aktualizacemi.

Starší systémy jako Windows 7, Windows 8, Windows 8.1, Windows Server 2008 R2, Windows Server 2012 a Windows Server 2012 R2 nejsou pro aktuální verze Microsoft Edge WebView2 Runtime podporovanou platformou, ale můžou být pro ně dostupné jeho starší verze.

Hlášení při chybějícím WebView2 Runtime

Pokud WebView2 Runtime není nainstalovaný nebo není dostupný, zobrazí se v aplikaci informační panel s textem, viz níže.

Jak ověřit instalaci

Přítomnost WebView2 Runtime lze ověřit několika způsoby.

Ověření ve Windows

Ve Windows lze ověřit, zda je v systému nainstalovaná položka Microsoft Edge WebView2 Runtime.

Zkontrolovat ji lze například v:
- Nastavení → Aplikace → Nainstalované aplikace,
- Ovládací panely → Programy a funkce.
Při otevřené části systému ABRA, která používá webový obsah, lze ve Správci úloh zkontrolovat také běžící proces msedgewebview2.exe.
Ověření přímo v systému ABRA Gen

Ověření lze provést také otevřením části aplikace, která používá webový nebo HTML obsah, například:
- Úvod / Aktuality,
- doplněk Internetový prohlížeč,
- náhled dokumentu,
- OAuth nebo jiný autentizační průvodce.
Systém dostupnost runtime ověřuje při vytvoření WebView2 komponenty. Pokud komponenta není dostupná, aplikace místo webového obsahu zobrazí informační panel s odkazem do nápovědy.
Technické ověření v registrech

Přítomnost WebView2 Runtime lze dle doporučení Microsoftu ověřit kontrolou hodnoty v registrech Microsoft Edge Update pro komponentu {F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}.

Pokud v příslušném klíči existuje hodnota pv a obsahuje verzi vyšší než 0.0.0.0, je WebView2 Runtime v systému nainstalovaný.

Pro 64bitové Windows se kontrolují zejména tyto klíče:
- HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
- HKEY_CURRENT_USER\Software\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
Pro 32bitové Windows se kontrolují tyto klíče:
- HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
- HKEY_CURRENT_USER\Software\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}

Proxy a síťové nastavení

Komponenta Microsoft Edge WebView2 Runtime nepoužívá proxy nastavení zadané v systému ABRA Gen. Pokud je pro přístup k internetu vyžadována proxy, je nutné ji nastavit v operačním systému Windows tak, aby ji mohl WebView2 Runtime použít. Nastavení proxy v systému ABRA Gen se na obsah zobrazovaný ve WebView2 nevztahuje.

Uživatelská data WebView2 profilu

Data WebView2 profilu nejsou ukládána do jednoho společného adresáře.

Při startu se vybírá samostatný adresář v uživatelských datech ABRA Gen ve tvaru:

WebView2_0
WebView2_1
WebView2_2
...

Obsazení adresáře se hlídá pomocí PID lock souboru, aby paralelně spuštěné instance systému ABRA Gen nekolidovaly. Pokud se nepodaří najít použitelný adresář, použije se unikátní adresář v dočasné složce systému.

Související odkazy

Microsoft Edge WebView2 Runtime

Dokumentace Microsoft Edge WebView2

Distribuce WebView2 Runtime