Win32Exception w systemie Linux i WSL bez klucza licencyjnego

Curtis Chau
Curtis Chau
Updated: 10 czerwca 2026

Gdy uruchamiasz IronPDF na Ubuntu, WSL lub w kontenerze Docker bez klucza licencyjnego, aplikacja wyrzuca wyjątek odnoszący się do xdg-open.

System.ComponentModel.Win32Exception: An error occurred trying to start process 'xdg-open' with working directory '/path/to/your/project/bin/Debug/net7.0'. No such file or directory
Text

Trzy warunki muszą wystąpić jednocześnie, aby ten błąd wystąpił: uruchamianie na Linux lub WSL, brak skonfigurowanego klucza licencyjnego IronPDF oraz xdg-open nie jest zainstalowany. Bez klucza licencyjnego, IronPDF próbuje otworzyć przeglądarkę, aby wyświetlić powiadomienie próbne za pomocą xdg-open. Narzędzie jest nieobecne w minimalistycznych środowiskach Linux, powodując Win32Exception.

Rozwiązanie

Krok 1: Ustaw klucz licencyjny

Skonfiguruj klucz licencyjny przed każdym wywołaniem renderowania PDF:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

Klucz próbny również rozwiązuje problem. Ustawienie prawidłowego klucza licencyjnego zapobiega próbom otwarcia przeglądarki przez IronPDF.

Krok 2: Zainstaluj xdg-utils

Jeśli musisz uruchomić bez klucza licencyjnego lub chcesz wyeliminować tę zależność:

sudo apt update
sudo apt install xdg-utils
SHELL

Dla pełnej konfiguracji Linux i WSL, zobacz przewodnik po wdrożeniu Linux.

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 21,739,885Wersja:2026.10właśnie wydany