Teknik Rehber15 dakika

Açılışta kilitlenen Mikro Sorunu veya Mikro ERP “Could Not Initialize Edge Chromium” Hatası: Kalıcı Çözüm

Mikro Fly açılmıyor, açılışta donuyor ya da e-Fatura ekranı yüklenmiyorsa sorun çoğunlukla Edge değil, uygulamanın kullandığı Microsoft Edge WebView2 Runtime’dır.

Kısa cevap

Edge’i kaldırmadan veya ortak Runtime’ı bozmadan, Mikro’ya Microsoft’un resmi Fixed Versionmodelini kullanan izole bir WebView2 kopyası tanımlayın.

Mikro Edge Chromium hatası neden olur?

“Could not initialize Edge Chromium” mesajı, Mikro’nun gömülü web içeriklerini açmak için ihtiyaç duyduğu WebView2 ortamını başlatamadığını gösterir. Mikro programının açılışta takılması, e-Fatura görüntüleme ekranının boş kalması veya GİB gönderim sayfasının yüklenmemesi aynı kökten gelebilir.

Fixed Version yaklaşımında seçtiğiniz Runtime otomatik güncellenmez. Bu, çalışan sürümü sabit tutar; ancak güvenlik ve uyumluluk için sürümü planlı biçimde yenilemeniz gerekir.

Başlamadan önce üç değeri belirleyin

DeğişkenAçıklamaÖrnek
EXE_ADIGörev Yöneticisi > Ayrıntılar’daki Mikro exe adıMikroFly.exe
RUNTIME_KLASORUİzole Runtime’ın çıkarılacağı yerel klasörC:\WV2Fixed
SURUMİndireceğiniz sabit WebView2 sürümüİndirme sayfasındaki uygun x64 sürüm
Komutları Yönetici olarak açılmış Komut İstemi’nde (CMD) çalıştırın. Kurumsal bilgisayarda kayıt defteri ilkelerini değiştirmeden önce sistem yöneticinizin onayını alın.

Adım 1

Kurulu WebView2 sürümünü öğrenin

reg query "HKLM\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}" /v pv

Dönen pv değeri kurulu sürümdür. Fixed Version indirme sayfasında aynı sürüm yoksa Microsoft’un sunduğu en yakın desteklenen x64 sürümü seçin ve bundan sonraki adımlarda indirdiğiniz paketin sürümünü kullanın.

Adım 2

WebView2 Fixed Version Runtime’ı indirin

Microsoft’un resmi WebView2 indirme sayfasını açın. “Fixed Version / Sabit Sürüm” bölümünden uygun sürüm ve x64 mimarisini seçip CAB paketini indirin.

Adım 3

CAB paketini ayrı klasöre çıkarın

Hedef yolun içinde \Edge\Application\ dizisi geçmemeli. Dosya adındaki sürümü indirdiğiniz paketle değiştirin:

expand "%USERPROFILE%\Downloads\Microsoft.WebView2.FixedVersionRuntime.<SURUM>.x64.cab" -F:* "C:\WV2Fixed"

Yukarıdaki örnek sürüm için düzenlenmiş komut şu şekilde görünür:

expand "%USERPROFILE%\Downloads\Microsoft.WebView2.FixedVersionRuntime.151.0.4129.78.x64.cab" -F:* "C:\WV2Fixed"

İkinci yöntem

CAB dosyasını WinRAR veya WinZip ile çıkarma

Komut kullanmak istemiyorsanız CAB paketini bir arşiv programıyla da çıkarabilirsiniz.

  1. 1

    İndirilenler klasörüne gidin ve indirdiğiniz Microsoft.WebView2.FixedVersionRuntime....x64.cab dosyasını bulun.

  2. 2

    Dosyaya sağ tıklayın ve kullandığınız programa göre şu seçeneklerden birini seçin:

    • WinRAR: “Dosyaları ayıkla…” veya “Klasöre çıkart…”
    • WinZip: “Ayıkla / Unzip to…” veya “Buraya ayıkla”
  3. 3

    Dosyaları önce masaüstünde veya İndirilenler içinde yeni ve boş bir klasöre çıkarın. Arşiv programı kendiliğinden uzun sürüm adlı bir klasör oluşturursa o klasörü kullanabilirsiniz.

  4. 4

    Çıkan ana klasörün adını WV2Fixed olarak değiştirin. Ardından klasörü kesip C sürücüsünün ana dizinine yapıştırın. Son konum C:\WV2Fixed olmalıdır.

  5. 5

    C:\WV2Fixed klasörünü açın ve içinde msedgewebview2.exe dosyasını arayın. Dosya doğrudan görünmüyorsa alt klasörlere girin; gerçek Runtime klasörü bu dosyanın bulunduğu klasördür.

Ardından çalıştırılabilir dosyanın gerçek yerini bulun:

dir /s /b "C:\WV2Fixed\msedgewebview2.exe"

Kayıt defterine yazacağınız yol, bu komutun döndürdüğü dosyanın bulunduğu klasördür; msedgewebview2.exe dosya adını yola eklemeyin.

Adım 4

Mikro’yu izole Runtime’a yönlendirin

<EXE_ADI> yerine kendi Mikro exe adınızı, <RUNTIME_KLASORU> yerine de önceki adımda bulduğunuz gerçek klasörü yazın:

reg add "HKCU\Software\Policies\Microsoft\Edge\WebView2\BrowserExecutableFolder" /v "<EXE_ADI>" /t REG_SZ /d "<RUNTIME_KLASORU>" /f

MikroFly.exe ve C:\WV2Fixed kullanan örnek bir bilgisayarda komut şöyledir:

reg add "HKCU\Software\Policies\Microsoft\Edge\WebView2\BrowserExecutableFolder" /v "MikroFly.exe" /t REG_SZ /d "C:\WV2Fixed" /f

Kaydı doğrulayın:

reg query "HKCU\Software\Policies\Microsoft\Edge\WebView2\BrowserExecutableFolder" /v "MikroFly.exe"

Adım 5

Mikro, e-Fatura ve GİB ekranlarını test edin

Mikro’yu tamamen kapatıp yeniden açın. Sadece ana ekranı değil, WebView2 kullanan e-Fatura görüntüleme ve GİB gönderim ekranlarını da deneyin. İçerik yükleniyorsa çözüm tamamdır.

Değişikliği geri alma

Yalnızca eklediğiniz Mikro uygulaması değerini silmek için:

reg delete "HKCU\Software\Policies\Microsoft\Edge\WebView2\BrowserExecutableFolder" /v "<EXE_ADI>" /f

Hata devam ederse kontrol listesi

  • EXE adı Görev Yöneticisi’ndeki adla, uzantısı dahil, aynı mı?
  • Kayıttaki Data yolu doğrudan msedgewebview2.exe bulunan klasörü mü gösteriyor?
  • Runtime klasörü yerel diskte mi? Fixed Version ağ/UNC konumundan çalıştırılmamalı.
  • Windows 10 ve Fixed Version 120+ kullanıyorsanız klasörün uygulama paketleri için okuma/çalıştırma izinleri tanımlı mı?
  • Mikro arka plandaki tüm işlemleriyle kapatılıp yeniden başlatıldı mı?

Runtime klasörünü sonradan silmeyin veya taşımayın. Sabit sürüm otomatik güncellenmediği için Mikro güncellemesinden sonra gerekirse aynı işlemi güncel bir Fixed Version ile tekrarlayın.

Sık sorulan sorular

Could not initialize Edge Chromium hatası neden olur?

Mikro'nun kullandığı WebView2 bileşeni başlatılamadığında görülür. Sorun çoğu zaman Edge tarayıcısının kendisinden değil, paylaşılan WebView2 Runtime sürümü veya yolundan kaynaklanır.

Microsoft Edge'i kaldırmak gerekir mi?

Hayır. Bu çözüm Edge'e dokunmadan yalnızca Mikro uygulamasını ayrı bir Fixed Version WebView2 klasörüne yönlendirir.

Mikro Fly açılıyor ama e-Fatura ekranı boşsa ne yapmalıyım?

msedgewebview2.exe dosyasının bulunduğu gerçek klasör ile kayıt defterindeki Data değerinin birebir aynı olduğunu kontrol edin; ardından Mikro'yu tamamen kapatıp yeniden açın.

Bu işlem diğer programları etkiler mi?

Değer adı olarak yalnızca Mikro'nun exe adı kullanıldığında ayar o uygulamaya özeldir; Edge, Office ve diğer WebView2 uygulamaları mevcut Runtime'ı kullanmaya devam eder.