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.

Como o uso do Engine muda a forma como você programa com o IronPDF

Ao usar a configuração do Engine, recomendamos instalar o pacote IronPdf.Slim em vez do pacote completo IronPdf do NuGet, pois o Engine gerencia todo o volume extra incluído no pacote Native.

Install-Package IronPdf.Slim

Após instalar o IronPdf.Slim, configure as definições de conexão apontando o IronPDF para a sua instância do IronPdfEngine. Adicione o seguinte código na inicialização da sua aplicação (ou antes de chamar qualquer método do IronPDF ) :

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.Co/nnectToIronPdfHost(
    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.Co/nnectToIronPdfHost(
    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 application

Como 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 .

Outros esclarecimentos para o IronPdfEngine

O IronPDF .NET não requer o IronPdfEngine para funcionar. IronPdfEngine é apenas uma forma opcional de usar o IronPDF. Por padrão, o IronPDF for .NET não utiliza o IronPdfEngine.

Install-Package IronPdf.Slim

// Connect to the remote IronPdfEngine
Installation.Co/nnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Connect to the remote IronPdfEngine
Installation.Co/nnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

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.
• O IronPdfEngine Docker executado no Linux x64 (Debian) usando imagens oficiais baseadas no Ubuntu 22.04 pode produzir PDFs com resultados ligeiramente diferentes daqueles obtidos com o IronPDF executado localmente, devido ao comportamento distinto do sistema operacional.
• Como o IronPdfEngine Docker é baseado em Linux, ele requer o daemon de contêineres do Linux (selecione Switch to Linux Containers se estiver usando o 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.