Use o IronPDF com o Modo integrado ao mecanismo.
Diferença entre Native e Engine
O IronPDF possui algumas funções que exigem alto desempenho e que você pode optar por executar remotamente. Embora o IronPDF não exija o IronPDFEngine para funcionar, configurar o IronPDFEngine como um serviço remoto é uma maneira opcional de evitar problemas de compatibilidade com o Chrome em sistemas operacionais mais antigos e ambientes móveis.
Comece a usar o IronPDF
Start using IronPDF in your project today with a free trial.
Como o uso do Engine muda a forma como você programa com o IronPDF
Ao usar a configuração Engine, recomendamos instalar IronPdf.Slim em vez do pacote completo IronPdf do NuGet, pois o Engine gerencia todo o volume extra incluído no pacote Native.
Após instalar IronPdf.Slim, configure as definições de conexão apontando o IronPDF para a sua instância de IronPdfEngine. Adicione o seguinte código na inicialização da sua aplicação (ou antes de chamar qualquer método do IronPDF) :
Linha Extra de Código de Configuração para adicionar ao seu código C#
Assumindo que o IronPdfEngine seja executado remotamente em 123.456.7.8:33350:
// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Additional code for your application' Establish a connection with the remote IronPdfEngine
' Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
' Additional code for your applicationComo funciona o IronPDFEngine?
O IronPDFEngine é um servidor conteinerizado projetado para gerenciar várias operações do IronPDF, incluindo a criação, gravação, edição e leitura de PDFs, tudo usando o protocolo gRPC. Construído como um aplicativo C# .NET independente, o IronPDFEngine opera de forma autônoma, eliminando a necessidade do ambiente de execução .NET durante a execução. Nós cuidamos da conexão gRPC para você, para que você possa se concentrar na programação!
Para um tutorial rápido sobre como executar o IronPDF como um contêiner independente, consulte este tutorial . O contêiner Docker suporta 16 parâmetros de configuração de tempo de execução para porta, registro de logs, limites do Chrome e muito mais — consulte a referência completa de parâmetros .
Como usar o IronPDFEngine como um servidor remoto
- Instale a biblioteca C# para utilizar o IronPDFEngine.
- Instale o pacote IronPDF.slim do NuGet.
- Utilize a classe IronPDFConnectionConfiguration para configurar as definições de conexão.
- Use o IronPDFEngine para renderizar HTML em PDF com um renderizador idêntico ao do Chrome.
Outros esclarecimentos para o IronPDFEngine
IronPDF .NET não requer IronPdfEngine para executar. IronPdfEngine é apenas uma maneira opcional de usar o IronPDF. Por padrão, o IronPDF for .NET não usará IronPdfEngine.
" )}]
IronPDF .NET com IronPdfEngine Remoto
O pacote NuGet IronPdf.slim é o único necessário para usar o IronPDF for .NET com IronPdfEngine Remoto.
IronPdf ou IronPdf.Linux, pode usar IronPdf.slim para reduzir o tamanho da sua aplicação.Assumindo que o IronPdfEngine seja executado remotamente em 123.456.7.8:33350.
Instale o IronPDF usando o NuGet:
Após instalar IronPdf.slim, você só precisa informar ao IronPDF onde o IronPdfEngine está (por favor, certifique-se de que o endereço é acessível, não bloqueado por firewall). Utilize a classe IronPDFConnectionConfiguration para configurar as definições de conexão. Adicione o código abaixo à fase inicial de sua aplicação (ou logo antes de chamar qualquer método do IronPDF).
// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);Imports IronPdf
' Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)Simples assim! Após isso, seu aplicativo será conectado ao IronPDFEngine remoto!
Limitações do IronPDFEngine
- Atualmente, o IronPdfEngine em si não suporta escalonamento horizontal (balanceamento de carga entre várias instâncias do mecanismo) porque o mecanismo mantém os binários PDF em andamento na memória do servidor e usa o PdfDocumentId para coordenar a comunicação entre o servidor e o cliente. Este projeto minimiza o uso de largura de banda e aumenta a velocidade de processamento. Note que essa limitação se aplica apenas ao serviço IronPdfEngine; aplicativos que usam a biblioteca IronPDF (com ou sem IronPdfEngine) ainda podem ser escalados horizontalmente implantando várias instâncias do aplicativo. Para executar o IronPDFEngine em Docker remotamente, você precisa garantir que a porta do IronPDFEngine esteja acessível.
- A execução do IronPdfEngine Docker no Linux x64 (Debian) usando imagens baseadas no ubuntu:22.04 oficial pode produzir uma saída PDF ligeiramente diferente do que você obteria executando o IronPDF localmente devido ao comportamento diferente do sistema operacional.
- Como o IronPdfEngine Docker é baseado em Linux, ele requer o daemon de Contêineres Linux (selecione
Switch to Linux Containersse você estiver usando Windows). - Os binários do IronPDFEngine não são multiplataforma, por isso os compilamos especificamente para cada plataforma.
- Não há suporte disponível entre versões diferentes.
Perguntas frequentes
Como posso configurar o IronPDFEngine para geração remota de PDFs?
Para configurar o IronPDFEngine para geração remota de PDFs, instale o pacote IronPdf.Slim do NuGet e configure as definições de conexão usando a classe IronPDFConnectionConfiguration . Essa configuração permite que você conecte seu aplicativo à instância do IronPDFEngine remotamente.
Quais são os principais benefícios de usar o IronPDFEngine com minha aplicação?
Utilizar o IronPDFEngine com sua aplicação permite a execução remota de tarefas em PDF, ajudando a evitar problemas de compatibilidade específicos da plataforma, especialmente em sistemas mais antigos e plataformas móveis. Também elimina a necessidade do runtime do .NET durante a execução.
Por que eu optaria por usar o IronPDFEngine em vez da biblioteca PDF nativa?
Você pode optar pelo IronPDFEngine para executar remotamente funções de PDF que exigem alto desempenho, reduzindo problemas de compatibilidade com diferentes sistemas operacionais e melhorando o desempenho ao utilizar um renderizador idêntico ao do Chrome para conversão de HTML em PDF.
O IronPDFEngine suporta escalonamento horizontal?
Não, o IronPDFEngine atualmente não suporta escalonamento horizontal, o que significa que não pode ser balanceado em várias instâncias devido à forma como os binários de arquivos PDF são gerenciados na memória do servidor.
O IronPDFEngine pode ser executado em diferentes sistemas operacionais?
O IronPDFEngine foi projetado para ser executado em sistemas Linux usando contêineres Docker. No entanto, os binários são específicos da plataforma, portanto, você precisa garantir que está usando a versão correta para o seu sistema operacional.
O que devo fazer se meus PDFs gerados estiverem diferentes ao usar o IronPDFEngine?
Os resultados em PDF podem variar ligeiramente devido a diferentes comportamentos do sistema operacional. Para minimizar essas diferenças, certifique-se de estar usando a imagem Docker correta e verifique se há alguma configuração específica do sistema operacional que possa afetar a renderização.
Como posso garantir que meu aplicativo esteja usando a versão correta do IronPDFEngine?
Para garantir a compatibilidade, cada versão do IronPDF requer uma versão correspondente do IronPDFEngine. Certifique-se de atualizar ambos os componentes simultaneamente para evitar problemas de compatibilidade entre versões.
Quais são as limitações ao usar o IronPDFEngine no Windows?
Ao usar o IronPDFEngine no Windows, você precisa de contêineres Linux para Docker e deve garantir que a porta do servidor esteja acessível. Os binários são específicos da plataforma e a migração para contêineres Linux é necessária.
Como configuro o IronPDF para conectar-se a um servidor IronPDFEngine remoto?
Para configurar o IronPDF para um servidor remoto, use Installation.ConnectTo IronPDFHost com o método IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer , especificando o endereço IP e a porta do servidor.
Qual pacote devo usar para minimizar o tamanho do aplicativo ao usar o IronPDFEngine?
Você deve usar o pacote IronPdf.Slim do NuGet, pois ele inclui apenas os componentes necessários para executar o IronPDF com o IronPDFEngine, reduzindo assim o tamanho do aplicativo.
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.
