1. IronPDF
  2. Solução de problemas
  3. Win32Exception no Linux e WSL sem uma chave de licença

Win32Exception no Linux e WSL Sem Chave de Licença

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Ao executar o IronPDF no Ubuntu, WSL ou em um contêiner Docker sem uma chave de licença, o aplicativo lança uma exceção referenciando 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

Três condições devem estar presentes simultaneamente para que este erro ocorra: rodando no Linux ou WSL, nenhuma chave de licença do IronPDF configurada e xdg-open não está instalado. Sem uma chave de licença, o IronPDF tenta abrir um navegador para exibir um aviso de teste usando xdg-open. A utilidade está ausente em ambientes Linux mínimos, causando o Win32Exception.

Solução

Passo 1: Defina a chave de licença

Configure a chave de licença antes de qualquer chamada de renderização de PDF:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
$vbLabelText   $csharpLabel

Uma chave de teste também resolve o problema. Definir uma chave de licença válida impede que o IronPDF tente abrir um navegador.

Passo 2: Instale xdg-utils

Se você precisar executar sem uma chave de licença ou quiser eliminar a dependência:

sudo apt update
sudo apt install xdg-utils
sudo apt update
sudo apt install xdg-utils
SHELL

Para configuração completa do Linux e WSL, veja o guia de implantação do Linux.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 20,088,359 | Versão: 2026.7 recém-lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.