Visão geral da instalação
Guia completo para instalar e configurar o IronPDF em todas as plataformas.
-
1Install IronPDF with NuGet Package Manager
-
2Copie e execute este trecho de código.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf");C# -
3Implante para testar em seu ambiente de produção.
Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita
1. Requisitos da plataforma
| Plataforma | Versão .NET | Hardware | Requisitos adicionais, compatibilidade |
|---|---|---|---|
 | .NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard e .NET Framework. |
|
|
 |
| ||
 | Todas as versões do macOS desde 2020 |
2. Métodos de Instalação
Existem duas maneiras de instalar o IronPDF: modo nativo e mecanismo remoto. Por padrão, o modo nativo é recomendado. Para implantação em servidores de produção usando Docker/Kubernetes, utilize o modo de mecanismo remoto.
- Ideal para: Implantações em nuvem e conteinerizadas, suporte a sistemas operacionais legados.
- Pacote: IronPdf.Slim
- Tamanho: Mais leve, ocupando alguns MB.
- Requisitos: Requer a configuração da conexão com o host.
- Ideal para: Implementações modernas em Windows, macOS e Linux.
- Pacote: Pacote completo do IronPDF NuGet.
- Tamanho: Arquivo de tamanho considerável (centenas de MB), incluindo os binários do Chrome e do Pdfium.
- Requisitos: Funciona em sistemas operacionais modernos.
3. Opções de Instalação
A instalação da biblioteca C# PDF leva menos de 5 minutos. Obtenha-o gratuitamente via NuGet ou faça o download direto e comece a usá-lo no Visual Studio imediatamente.
Vá para a biblioteca IronPDF NuGet (ou Console do Gerenciador de Pacotes no Visual Studio)
- No Explorador de Soluções, clique com o botão direito do mouse em Referências.
- Selecione 'Gerenciar Pacotes NuGet' > 'Procurar' > Pesquisar IronPDF
- Selecione o pacote e instale.
- Baixe o pacote DLL do IronPDF para sua plataforma: Windows, Linux, macOS
- Descompacte o arquivo ZIP correspondente ao seu sistema operacional em um local dentro do diretório da sua solução.
- No Solution Explorer do Visual Studio, clique com o botão direito do mouse em 'Dependências'.
- 'Adicionar Referência de Projeto' > Selecione 'Procurar' para incluir todas as DLLs extraídas do arquivo zip.
Instale o IronPDF usando o NuGet.
4. Configurações adicionais
Após adquirir ou se inscrever para um período de avaliação de 30 dias do IronPDF, localize a chave de licença enviada para o seu e-mail.
Adicione sua chave de licença no início da sua inscrição.
IronPdf.License.LicenseKey = "KEY";Imports IronPdf
IronPdf.License.LicenseKey = "KEY"Verifique o status da licença.
bool valid = IronPdf.License.IsLicensed;Imports IronPdf
Dim valid As Boolean = License.IsLicensedDefina a propriedade TempFolderPath do objeto IronPdf.Installation.
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"Certifique-se de limpar todas as pastas temporárias e de cache em seus servidores de desenvolvimento e, em seguida, reimplemente uma versão limpa do seu aplicativo após atualizar o caminho.
Definindo a variável de ambiente da pasta temporária no escopo do aplicativo.
using IronPdf;
// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);
// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");
// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");Imports IronPdf
' Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
Dim MyTempPath As String = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)
' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")
' Your PDF Generation and editing code
Dim Renderer As New IronPdf.ChromePdfRenderer()
Using Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
Doc.SaveAs("example.pdf")
End UsingEm um servidor com segurança reforçada, conceda ao usuário do IIS (IUSER) permissões de leitura e gravação para a pasta de instalação, bem como para as pastas do Windows e Temp.
[IronPDFEngine remoto] Após instalar o pacote IronPdf.Slim, conecte-se ao contêiner do mecanismo e configure a conexão na inicialização do aplicativo ou antes de chamar qualquer método do IronPDF.
Supondo que o IronPDFEngine esteja sendo executado remotamente em 123.456.7.8:33350:
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);Imports IronPdf
Installation.ConnectToIronPdfHost(
GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)[Linux] Ative o IronPDF para instalar automaticamente todas as dependências necessárias do Linux. A primeira conversão de HTML para PDF pode demorar mais do que o normal.
Installation.LinuxAndDockerDependenciesAutoConfig = true;Installation.LinuxAndDockerDependenciesAutoConfig = True[Docker] Pré-inicializar o mecanismo do Chrome para pré-carregar os pré-requisitos e acelerar o primeiro uso no Docker.
IronPdf.Installation.Initialize();IronPdf.Installation.Initialize()5. Cenários de Implantação
Execute e implemente o IronPDF .NET em
Função do Azure
Execute e implemente o IronPDF .NET em
AWS (EC2, Lambda)
Execute o IronPDF em
Contêiner Docker Linux
Execute o IronPDF como um
Contêiner remotoPróximos passos
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.
