Como usar o IronPdfEngine
O IronPdfEngine é um servidor gRPC desenvolvido para supervisionar uma série de tarefas do IronPDF , incluindo a criação, edição e leitura de documentos PDF.
Como usar o IronPdfEngine no Node.js
- Instale a biblioteca Node.js para utilizar o IronPdfEngine.
- Inclua a biblioteca instalando-a usando o npm.
- Obtenha o binário do Chrome através da mesma instalação.
- Check the version needed by accessing the `ironPdfEngineVersion` property.
- Utilize o IronPdfEngine para renderizar HTML em PDF com um renderizador idêntico ao do Chrome.
IronPDF Node.js e IronPdfEngine
O IronPDF for Node.js requer o IronPdfEngine para funcionar. O código Node.js é apenas uma interface de API sobre o gRPC do IronPdfEngine. Portanto, quando você chama qualquer método no IronPDF for Node.js, a mágica acontece dentro do IronPdfEngine!
Por padrão, o IronPDF for Node.js iniciará o IronPdfEngine como um subprocesso e se comunicará com ele até que seu aplicativo seja encerrado.
Observação: Cada versão do IronPDF for Node.js requer uma versão específica do IronPdfEngine. Versões diferentes não são suportadas.
IronPDF for Node.js com IronPdfEngine local
Opção 1: Baixar o IronPdfEngine em tempo de execução
Por padrão, após instalar o IronPDF em seu projeto JavaScript , na primeira execução, o IronPDF detectará sua plataforma (por exemplo, Windows x64) e baixará os binários corretos do IronPdfEngine da internet.
npm install @ironsoftware/ironpdfnpm install @ironsoftware/ironpdfPrós:
- Seu pacote de inscrição será pequeno.
- Pode ser implementado em diversas plataformas.
Contras:
- É necessário acesso à internet nas primeiras vezes que o jogo é executado.
- Tempo de inicialização lento.
Opção 2 (recomendada): Instale o IronPdfEngine como uma dependência.
O IronPDF for Node.js permite adicionar o IronPdfEngine como uma dependência. Essas dependências do IronPdfEngine agrupam o IronPdfEngine em um arquivo .zip e o extrairão e usarão automaticamente.
Você pode optar por instalar uma ou mais dessas dependências do IronPdfEngine.
Nota: As versões de dependência de ironpdf e ironpdf-engine-xxx-xxx devem ser as mesmas. A versão da dependência ironpdf-engine-xxx-xxx não se refere à versão do IronPdfEngine interna.
Instalação específica para cada plataforma:
-
Windows x64:
npm install @ironsoftware/ironpdf-engine-windows-x64npm install @ironsoftware/ironpdf-engine-windows-x64SHELL -
Windows x86:
npm install @ironsoftware/ironpdf-engine-windows-x86npm install @ironsoftware/ironpdf-engine-windows-x86SHELL -
Linux x64:
npm install @ironsoftware/ironpdf-engine-linux-x64npm install @ironsoftware/ironpdf-engine-linux-x64SHELL -
macOS x64:
npm install @ironsoftware/ironpdf-engine-macos-x64npm install @ironsoftware/ironpdf-engine-macos-x64SHELL - macOS arm:
npm install @ironsoftware/ironpdf-engine-macos-arm64npm install @ironsoftware/ironpdf-engine-macos-arm64SHELL
Prós:
- Tempo de inicialização mais rápido.
- Não é necessário acesso à internet após a instalação da dependência.
Contras:
- Seu pacote de inscrição será extenso.
- É necessário especificar as plataformas de destino.
IronPDF for Node.js com IronPdfEngine remoto
Para usar um IronPdfEngine remoto, é necessária uma versão específica do IronPdfEngine. Por exemplo, se o IronPDF for Node.js versão 2024.2.2 requer o IronPdfEngine versão 2024.2.2, não use o IronPdfEngine versão 2024.2.1. Acesse a propriedade ironPdfEngineVersion para verificar a versão necessária.
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;Como conectar
Suponha que o IronPdfEngine esteja sendo executado remotamente em 123.456.7.8:33350.
Consulte " Como baixar e executar o IronPdfEngine ".
Para conectar, basta especificar onde o IronPdfEngine está localizado (certifique-se de que o endereço esteja acessível e não bloqueado por um firewall). Adicione este código na fase inicial da sua aplicação, ou imediatamente antes de chamar qualquer método do IronPDF .
IronPdfGlobalConfig.setConfig({
ironPdfEngineDockerAddress: "123.456.7.8:33350"
});IronPdfGlobalConfig.setConfig({
ironPdfEngineDockerAddress: "123.456.7.8:33350"
});Simples assim! Após isso, seu aplicativo será conectado a um IronPdfEngine remoto!
Para o IronPdfEngine remoto, não é necessário instalar o IronPdfEngine como uma dependência. Você pode pular a seção intitulada " Opção 2 (recomendada): instalar o IronPdfEngine como uma dependência ".
Perguntas frequentes
Para que serve o IronPDFEngine no Node.js?
IronPDFEngine é um servidor gRPC usado em Node.js para gerenciar tarefas de PDF, como criação, edição e renderização, oferecendo uma experiência perfeita no manuseio de PDFs.
Como posso instalar o IronPDF for Node.js?
Você pode instalar o IronPDF for Node.js usando o npm com o comando npm install @ironsoftware/ironpdf .
Quais são as diferenças entre as configurações locais e remotas do IronPDFEngine?
Uma configuração local envolve o download do IronPDFEngine em tempo de execução ou sua instalação como uma dependência, oferecendo tempos de inicialização mais rápidos. Uma configuração remota conecta-se a um servidor IronPDFEngine hospedado remotamente, eliminando a necessidade de instalações locais.
Como posso garantir a compatibilidade entre as versões do IronPDF e do IronPDFEngine?
Cada versão do IronPDF for Node.js requer uma versão específica do IronPDFEngine. Use a propriedade ironPdfEngineVersion para verificar a versão necessária e garantir que ambas as versões sejam compatíveis.
Quais são os benefícios de instalar o IronPDFEngine como uma dependência?
A instalação do IronPDFEngine como dependência resulta em tempos de inicialização mais rápidos e elimina a necessidade de acesso à internet após a instalação, embora aumente o tamanho do pacote do aplicativo.
Como faço para me conectar a um IronPDFEngine remoto?
Para conectar-se a um IronPDFEngine remoto, use IronPDFGlobalConfig.setConfig para especificar o endereço do servidor, garantindo que ele esteja acessível e não seja bloqueado por um firewall.
É necessário acesso à internet para fazer o download do IronPDFEngine durante a execução?
Sim, o acesso à internet é necessário nas primeiras execuções ao baixar o IronPDFEngine em tempo de execução, o que também resulta em tempos de inicialização mais lentos.
Preciso instalar o IronPDFEngine para uso remoto?
Não, ao usar uma instância remota do IronPDFEngine, você não precisa instalá-la localmente como uma dependência.
O IronPDFEngine pode ser usado em diferentes plataformas?
Sim, o IronPDFEngine pode ser implementado em várias plataformas. Comandos npm específicos para cada plataforma estão disponíveis para instalações no Windows, Linux e macOS.
O IronPDF é compatível com o .NET 10 e quais ambientes ele suporta?
Sim, o IronPDF é totalmente compatível com o .NET 10 (assim como com o .NET 9, 8, 7, etc.). Ele suporta C#, VB.NET, F# e funciona em diversas plataformas, como Windows, Linux e macOS — incluindo Docker e ambientes em nuvem —, tornando-o adequado para projetos .NET 10 para web, desktop, console ou nuvem.
Ainda está rolando a tela?
Quer provas rápidas?
executar um exemplo Veja seu HTML se transformar em um PDF.
Comece GRATUITAMENTE
Comece GRATUITAMENTE
Agende uma demonstração ao vivo gratuita
Não é necessário cartão de crédito nem criação de conta.
