Solução de problemas de dependências do Chrome no IronPDF
O renderizador HTML do Google Chromium é uma parte essencial do processo de renderização "HTML para PDF" do IronPDF. O binário essencial para este renderizador pode ser facilmente encontrado dentro do pacote NuGet do IronPDF . A ausência deste binário na pasta do projeto resultará no seguinte erro:
Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'.Caso o IronPDF não consiga implantar as dependências do Chrome automaticamente, talvez seja necessário adicioná-las manualmente ao projeto por meio do NuGet. É possível adicionar múltiplas dependências:
No Windows, é uma boa ideia garantir que o sistema operacional de destino tenha o Visual C++ Runtime instalado. Muitos aplicativos modernos não funcionam sem esse componente essencial do sistema operacional.
Também temos guias de compatibilidade para Linux e Docker .
Linux
-
Certifique-se de que o arquivo Docker correto esteja sendo usado.
-
Use o pacote NuGet IronPdf.Linux em vez de IronPDF.
-
Desative o modo GPU para renderização no Chrome:
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled -
Desative a configuração automática para dependências do Linux e do Docker:
csharp Installation.LinuxAndDockerDependenciesAutoConfig = false;csharp Installation.LinuxAndDockerDependenciesAutoConfig = False
MacOS
- Verifique se o ambiente de execução do .NET está configurado para a arquitetura correta: x64 ou arm64.
O que fazer se isso não resolver o problema?
Se isso não resolver o problema, estamos aqui para ajudar. A compatibilidade é uma prioridade para nossa equipe de engenharia. Por favor, envie um e-mail relatando o erro parasupport@ironsoftware.com . Todas as questões de compatibilidade serão analisadas cuidadosamente por um engenheiro sênior.
Não se esqueça de nos informar sobre o sistema operacional/plataforma em que será feita a implantação, especialmente se for uma plataforma em nuvem como AWS ou Azure.
Como habilitar o registro nativo no IronPDF
Anexar arquivos de log a um relatório de erros mais que dobra a probabilidade de conseguirmos isolar o problema e resolvê-lo rapidamente.
Coloque este trecho de código no início do seu arquivo, antes de executar qualquer método do IronPDF (todas as versões posteriores a 2021.3.1):
// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;' Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log"
' Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.AllOs arquivos de log criados pelo IronPDF são encontrados no diretório /bin do seu projeto, onde suas DLLs estão implantadas:
- default.log (Processo de implantação)
- cef.log (Renderização)
- IronSoftwareCefSubprocess.log (Renderização e Threading)
- IronSoftwareEngine.log (Útil para depurar exceções que começam com "Erro ao gerar PDF a partir de...")
Os servidores em nuvem geralmente possuem locais específicos para arquivos de log. Temos guias para gerar arquivos de log no Azure e na AWS .
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 bem estruturados e visualmente atraentes.
