Aplikacja ładuje nieprawidłową wersję .NET

Aplikacja ładująca nieprawidłową wersję .NET wskazuje na konflikt kilku zainstalowanych wersji tego środowiska — plik konfiguracyjny aplikacji (.runtimeconfig.json) określa, której wersji ma szukać.

Na czym polega problem z nieprawidłową wersją .NET

Komunikat „Aplikacja ładuje nieprawidłową wersję .NET” oznacza, że program podczas uruchamiania próbuje skorzystać z innej wersji środowiska .NET niż ta, która jest dostępna, wskazana w konfiguracji albo zgodna z plikami aplikacji. Samo zainstalowanie kilku wydań .NET nie musi być błędem, ponieważ różne programy mogą wymagać odmiennych bibliotek uruchomieniowych. Problem pojawia się wtedy, gdy aplikacja nie potrafi odnaleźć oczekiwanego środowiska, wybiera niewłaściwe wydanie lub korzysta z plików pochodzących z niepasującej generacji platformy.

W nowszych aplikacjach informacja o wymaganym środowisku może znajdować się w pliku .runtimeconfig.json. Zawarte są tam między innymi dane dotyczące platformy docelowej oraz oczekiwanej wersji środowiska uruchomieniowego. Jeżeli plik został zmieniony, uszkodzony, przeniesiony razem z programem albo nie odpowiada wersji bibliotek znajdujących się w katalogu aplikacji, uruchomienie może zakończyć się błędem. Podobny efekt występuje po aktualizacji programu bez równoczesnego uzupełnienia wymaganych składników .NET.

Nieprawidłowa wersja nie zawsze oznacza, że na komputerze brakuje całego środowiska. Czasem zainstalowano właściwą rodzinę .NET, lecz brakuje konkretnego komponentu uruchomieniowego, biblioteki zależności albo wersji przeznaczonej dla określonej architektury systemu. Dlatego komunikat warto traktować jako wskazówkę dotyczącą zgodności aplikacji, plików konfiguracyjnych i środowiska systemowego, a nie jako prostą informację o konieczności instalowania kolejnych pakietów.

Różnice między wersją uruchomieniową, SDK i bibliotekami aplikacji

Platforma .NET występuje w kilku rodzajach instalacji, które pełnią różne funkcje. Środowisko uruchomieniowe służy do pracy gotowych programów. Zestaw SDK jest przeznaczony przede wszystkim do tworzenia, kompilowania i testowania aplikacji. Biblioteki współdzielone dostarczają kodu używanego przez wiele programów, ale ich obecność sama w sobie nie gwarantuje, że konkretna aplikacja będzie mogła się uruchomić. Zainstalowane narzędzia deweloperskie nie zawsze zastępują wymagane środowisko uruchomieniowe.

Znaczenie ma również generacja platformy. Program przygotowany dla jednej gałęzi .NET może nie działać z inną gałęzią tylko dlatego, że obie noszą podobne nazwy. Istotne bywają także różnice między środowiskiem wymaganym przez aplikację a wersją zainstalowaną w systemie. W niektórych przypadkach możliwe jest użycie zgodnej, nowszej wersji, ale zależy to od sposobu zbudowania programu oraz ustawień zapisanych w jego konfiguracji.

Weryfikacja powinna obejmować nazwę i wersję środowiska, a także architekturę aplikacji. Program 32-bitowy i program 64-bitowy mogą korzystać z odmiennych komponentów, szczególnie gdy używają dodatkowych bibliotek natywnych. Znaczenie ma też lokalizacja plików: aplikacja uruchamiana z kopii zapasowej, nośnika zewnętrznego lub katalogu po ręcznym przeniesieniu może nie odnajdywać zależności zapisanych w pierwotnej ścieżce.

Warto odróżnić problem z samym .NET od błędu konkretnej aplikacji. Jeżeli inne programy działają poprawnie, a komunikat pojawia się tylko przy jednym tytule, przyczyną może być niepełna aktualizacja, uszkodzenie plików programu albo nieprawidłowa konfiguracja jego katalogu. Jeżeli podobne błędy występują w wielu aplikacjach, większe znaczenie może mieć stan systemu, uszkodzone składniki środowiska lub nieudana aktualizacja systemowa.

Najczęstsze przyczyny błędnego wyboru środowiska

Jedną z typowych przyczyn jest obecność kilku wersji .NET, przy czym aplikacja została skonfigurowana tak, aby szukać konkretnego wydania. Menedżer uruchomieniowy może wtedy nie znaleźć wymaganej wersji albo zastosować regułę zgodności, która nie pasuje do używanych bibliotek. Do błędu może dojść także po usunięciu starszego środowiska, które wcześniej było potrzebne mniej oczywistemu składnikowi programu.

Problematyczny bywa plik .runtimeconfig.json. Jego ręczna edycja, zapisanie z nieprawidłową składnią, skopiowanie z innej instalacji lub pozostawienie starej konfiguracji po aktualizacji może spowodować żądanie niewłaściwej wersji. Błąd mogą wywołać również pliki bibliotek znajdujące się obok programu, gdy pochodzą z innego wydania niż główny plik wykonywalny.

Do częstych źródeł problemu należą ponadto:

• przerwana instalacja lub aktualizacja aplikacji;
• usunięcie części plików przez program ochronny albo narzędzie czyszczące;
• uruchamianie programu bezpośrednio z archiwum zamiast z poprawnie rozpakowanego katalogu;
• pozostawienie starych bibliotek po zmianie wersji programu;
• pomylenie środowiska przeznaczonego do uruchamiania z pakietem służącym do tworzenia aplikacji;
• niezgodność architektury programu, środowiska i dodatkowych bibliotek;
• uszkodzenie wpisów systemowych lub komponentów instalatora;
• uruchamianie aplikacji przez skrót wskazujący na dawną lokalizację jej plików.

Bezpieczna diagnostyka powinna zacząć się od odczytania pełnego komunikatu, sprawdzenia wersji systemu i ustalenia, od kiedy problem występuje. Następnie można porównać wymagania programu z listą zainstalowanych środowisk, sprawdzić zawartość katalogu aplikacji oraz przeprowadzić naprawę lub ponowną instalację wyłącznie właściwego komponentu. Usuwanie wszystkich wersji .NET bez wcześniejszego rozpoznania zależności może doprowadzić do kolejnych problemów z innymi programami.

Kiedy najlepiej poprosić o ocenę stanu sprzętu - Aplikacja ładuje nieprawidłową wersję .NET

Zgłoszenie do serwisu jest uzasadnione, gdy aplikacja nadal odmawia uruchomienia po prawidłowej instalacji wymaganego środowiska, gdy nie da się ustalić, która wersja jest właściwa, albo gdy błąd pojawił się po aktualizacji systemu, zmianie dysku lub odzyskiwaniu danych. Pomoc może być potrzebna również wtedy, gdy komunikatowi towarzyszą inne objawy, takie jak samoczynne zamykanie programów, uszkodzone skróty, problemy z instalatorem lub powtarzające się błędy bibliotek.

W praktyce powinno się przekazać nazwę aplikacji, dokładną treść komunikatu, wersję systemu, moment wystąpienia usterki oraz informację o ostatnich aktualizacjach. Przydatne może być także wskazanie, czy problem dotyczy jednego programu, czy większej liczby aplikacji. Pozwala to odróżnić brak konkretnego środowiska od uszkodzenia plików programu, błędnej konfiguracji albo problemu systemowego.

W Warszawskim Pogotowiu Komputerowym 24/7 można zlecić sprawdzenie zgodności aplikacji z zainstalowanym środowiskiem, analizę plików konfiguracyjnych oraz uporządkowanie elementów potrzebnych do uruchomienia programu. Po ustaleniu przyczyny możliwe jest dobranie naprawy obejmującej właściwe komponenty .NET, odtworzenie uszkodzonych plików, poprawienie konfiguracji lub ponowne przygotowanie aplikacji do pracy. Takie podejście ogranicza ryzyko przypadkowego usunięcia potrzebnych wersji i pozwala zachować działanie pozostałych programów.