Brak .NET Desktop Runtime

Brak .NET Desktop Runtime uniemożliwia uruchomienie aplikacji z interfejsem WinForms lub WPF — jest to osobny, szerszy pakiet niż podstawowy .NET Runtime, wymagający oddzielnej instalacji.

Brak .NET Desktop Runtime — czym jest ten problem

Komunikat „Brak .NET Desktop Runtime” oznacza, że w systemie Windows nie znaleziono składnika potrzebnego do uruchomienia aplikacji korzystającej z bibliotek pulpitu platformy .NET. Dotyczy to przede wszystkim programów przygotowanych z użyciem technologii Windows Forms, określanej także jako WinForms, oraz Windows Presentation Foundation, czyli WPF. Tego rodzaju aplikacje mogą być poprawnie zapisane na dysku, a mimo to nie uruchomią się, jeśli wymagane środowisko wykonawcze nie zostało zainstalowane, zostało usunięte albo jego wersja nie odpowiada wymaganiom programu.

Desktop Runtime należy odróżnić od samego środowiska .NET Runtime przeznaczonego dla aplikacji działających bez graficznego interfejsu użytkownika. Program z oknem, przyciskami, formularzami, menu lub elementami typowymi dla aplikacji Windows wymaga dodatkowych bibliotek pulpitu. Nie wystarczy więc obecność innego komponentu .NET, nawet jeśli w nazwie pojawia się ta sama główna platforma. W praktyce system może zawierać kilka różnych wersji .NET, lecz nadal nie mieć tej konkretnej odmiany środowiska, której oczekuje uruchamiany program.

Wymagana wersja jest zwykle określona przez twórcę aplikacji. Może chodzić na przykład o jedną z rodzin .NET 6, .NET 7, .NET 8 albo inną wersję wskazaną w komunikacie. Numer główny ma znaczenie, ponieważ aplikacja skompilowana dla określonej generacji platformy nie zawsze korzysta automatycznie z dowolnego, nowszego środowiska. Z tego powodu przypadkowa instalacja pierwszego znalezionego pakietu może nie rozwiązać problemu. Konieczne jest ustalenie, czego dokładnie wymaga konkretny program i czy używany jest system 64-bitowy, 32-bitowy lub środowisko zgodne z architekturą aplikacji.

Rola środowiska .NET Desktop Runtime i różnice między pakietami

.NET Desktop Runtime można porównać do zestawu gotowych składników, z których aplikacja korzysta podczas pracy. Program nie musi zawierać w swoim katalogu wszystkich bibliotek odpowiedzialnych za obsługę okien, kontrolek, renderowanie interfejsu i komunikację z systemem Windows, ponieważ część tych elementów jest udostępniana przez środowisko zainstalowane w systemie. Gdy brakuje odpowiedniego pakietu, plik wykonywalny nie ma dostępu do wymaganych zależności i zatrzymuje się jeszcze przed wyświetleniem głównego okna.

Najczęściej spotykane są trzy pojęcia, które bywają mylone:

• .NET SDK — zestaw przeznaczony głównie do tworzenia, budowania i testowania programów;
• .NET Runtime — środowisko umożliwiające uruchamianie aplikacji, które nie potrzebują komponentów pulpitu;
• .NET Desktop Runtime — środowisko rozszerzone o biblioteki wymagane przez aplikacje WinForms i WPF.

Obecność pakietu SDK nie zawsze oznacza prawidłową konfigurację do uruchamiania gotowego programu. Podobnie instalacja podstawowego Runtime może nie wystarczyć dla aplikacji z graficznym interfejsem. Znaczenie ma również wersja architektury. Aplikacja 32-bitowa może wymagać komponentów x86, natomiast program 64-bitowy zwykle korzysta z pakietu x64. W niektórych przypadkach instalowane są oba warianty, ponieważ na jednym komputerze używa się programów o różnej architekturze.

Na działanie instalacji wpływają także uprawnienia systemowe, zasady kontroli konta użytkownika, dostęp do aktualizacji oraz sposób, w jaki dany program został opublikowany. Aplikacja może oczekiwać środowiska zainstalowanego globalnie dla wszystkich użytkowników albo korzystać z plików umieszczonych w swoim własnym katalogu. Dlatego identyczny komunikat nie zawsze oznacza dokładnie tę samą przyczynę.

Typowe objawy, błędy i przyczyny braku uruchomienia aplikacji

Najbardziej charakterystycznym objawem jest okno informujące o konieczności zainstalowania platformy .NET Desktop Runtime. Czasem komunikat zawiera także numer wersji, architekturę oraz odsyłacz do strony pobierania. Innym razem wyświetlany jest ogólny błąd dotyczący braku pliku DLL, niezgodnej wersji frameworka albo niemożności załadowania wymaganej biblioteki. W systemowym Podglądzie zdarzeń mogą pojawić się dodatkowe wpisy wskazujące na nieudaną inicjalizację procesu, konflikt zależności lub zamknięcie aplikacji zaraz po uruchomieniu.

Do częstych przyczyn należą:

• brak zainstalowanego Desktop Runtime w wymaganej wersji;
• zainstalowanie podstawowego .NET Runtime zamiast wariantu desktopowego;
• pobranie pakietu dla niewłaściwej architektury systemu lub programu;
• usunięcie składnika podczas porządkowania systemu albo odinstalowywania innej aplikacji;
• niepełna instalacja po przerwaniu aktualizacji lub utracie połączenia z internetem;
• uszkodzone wpisy instalacyjne i pozostałości po kilku wersjach platformy;
• uruchamianie programu z niekompletnego archiwum, kopii zapasowej albo przenośnego nośnika;
• brak uprawnień do odczytu bibliotek lub ograniczenia narzucone przez oprogramowanie ochronne;
• niezgodność programu z wersją systemu Windows albo zainstalowanymi składnikami.

Nie każdy błąd pojawiający się po instalacji oznacza, że pakiet został dobrany prawidłowo. Aplikacja może nadal odmawiać działania, jeśli potrzebuje innej gałęzi .NET, określonego wariantu x86 lub x64 albo dodatkowych bibliotek systemowych. Warto zwrócić uwagę na pełną treść komunikatu, nazwę aplikacji i moment wystąpienia problemu. Jeżeli błąd pojawia się tylko na jednym koncie użytkownika, przyczyny można szukać również w profilu użytkownika, uprawnieniach i ustawieniach środowiska.

Samodzielne usuwanie wszystkich wersji .NET nie jest dobrym sposobem na rozpoczęcie naprawy. Inne programy mogą korzystać z istniejących składników, a pochopna deinstalacja może spowodować kolejne problemy. Bezpieczniejsze jest ustalenie wymaganej wersji, sprawdzenie listy zainstalowanych komponentów, pobranie właściwego instalatora z wiarygodnego źródła i ponowne uruchomienie komputera, jeżeli instalator tego wymaga.

Kiedy warto zgłosić brak .NET Desktop Runtime do serwisu

Zgłoszenie do serwisu jest uzasadnione, gdy instalacja właściwego pakietu kończy się błędem, komunikat powraca mimo poprawnego pobrania środowiska albo nie wiadomo, która wersja jest wymagana przez używany program. Pomoc może być potrzebna także wtedy, gdy aplikacja uruchamia się na innym komputerze, lecz na danym urządzeniu występują konflikty między wersjami, uszkodzone składniki systemu, problemy z aktualizacjami lub ograniczenia uprawnień.

W Warszawie takie przypadki obsługuje między innymi Warszawskie Pogotowie Komputerowe 24/7, gdzie można zlecić sprawdzenie konfiguracji Windows, identyfikację wymaganej wersji .NET oraz bezpieczne odtworzenie brakujących składników. Podczas diagnozy analizowany jest pełny komunikat, architektura systemu, lista zainstalowanych środowisk, historia aktualizacji i sposób instalacji problematycznej aplikacji. Pozwala to odróżnić zwykły brak Desktop Runtime od sytuacji, w której przyczyną jest uszkodzenie systemu, niezgodność programu albo problem z jego plikami.

Przed przekazaniem sprzętu warto przygotować nazwę aplikacji, wersję programu, zrzut lub dokładną treść komunikatu oraz informację, czy problem pojawił się po aktualizacji, reinstalacji systemu albo zmianie ustawień zabezpieczeń. Jeżeli komputer jest wykorzystywany do pracy, należy również wskazać, czy błąd dotyczy jednego programu, czy większej liczby aplikacji opartych na .NET. Takie dane ułatwiają szybkie zawężenie przyczyny i dobranie właściwego środowiska bez instalowania przypadkowych, niepotrzebnych pakietów.

Po zakończeniu naprawy powinno zostać sprawdzone nie tylko samo otwarcie aplikacji, lecz także wykonywanie podstawowych operacji, zapis danych, działanie skrótów, komunikacja z urządzeniami oraz uruchamianie programu po ponownym zalogowaniu do systemu. Dzięki temu można potwierdzić, że problem dotyczył rzeczywiście brakującego .NET Desktop Runtime, a nie dodatkowej usterki ujawnionej przy okazji.