Node.js ile IronPdfEngine Nasıl Kullanılır
IronPdfEngine, PDF işlemlerinin tamamını — oluşturma, düzenleme ve okuma — Node.js istemcisi adına ele alan bir gRPC sunucusudur. @ironsoftware/ironpdf paketi, gRPC üzerinden IronPdfEngine ile iletişim kuran ince bir API sarmalayıcısıdır; Node.js kodunuzda yapılan her yöntem çağrısı bu sunucu işlemi içinde gerçekleştirilir. Varsayılan olarak, Node.js için IronPDF, IronPdfEngine'i yerel bir alt işlem olarak başlatır, ancak ayrıca paylaşılan veya konteynerleştirilmiş dağıtımlar için uzaktan barındırılan bir örneğe yönlendirebilirsiniz.
Hızlı Başlangıç: IronPdfEngine Ayarlarını Node.js için Yapın
Paketi yükleyin ve IronPdfEngine, ilk PDF işlemiyle otomatik olarak çalışır:
//:path=shell
npm install @ironsoftware/ironpdf//:path=shell
npm install @ironsoftware/ironpdfMinimal İş Akışı (5 Adım)
npm install @ironsoftware/ironpdfile IronPDF Node.js paketini yükleyin.- İlk çalıştırmada, IronPDF platformunuzu algılar ve doğru IronPdfEngine ikili dosyalarını indirir.
- Çevrimdışı veya daha hızlı başlangıç dağıtımları için,
@ironsoftware/ironpdf-engine-windows-x64gibi platforma özgü bir motor paketini yükleyin. - Bir uzak örneği dağıtmadan önce, gereksinim duyulan motor sürümünü kontrol etmek için
IronPdfGlobalConfig.ironPdfEngineVersionözelliğini kullanın. - Uzak bir motor için, ilk PDF işlemi öncesinde
IronPdfGlobalConfig.setConfig({ ironPdfEngineDockerAddress: 'host:port' })çağrısında bulunun.
Node.js için IronPDF, IronPdfEngine Neden Gerektirir?
Node.js için IronPDF, bağımsız bir PDF oluşturucu içermez. Node.js paketi bir gRPC istemcisi olup, IronPdfEngine gerçek oluşturma, düzenleme ve okuma işlerini gerçekleştiren sunucudur. Uygulamanız herhangi bir IronPDF yöntemini çağırdığında, istek gRPC üzerinden motor işlemi yoluyla gider ve sonuç Node.js kodunuza geri döner.
Bu mimari, Node.js paketini hafif tutar ve işlem ortamını izole eder. Aynı zamanda, motor sürümünün paket sürümüyle tam olarak eşleşmesi gerektiği anlamına gelir — çapraz sürüm kombinasyonları desteklenmez.
@ironsoftware/ironpdf'nin her sürümü, aynı sürümdeki IronPdfEngine'i gerektirir. Herhangi bir motor güncellemesini dağıtmadan önce IronPdfGlobalConfig.ironPdfEngineVersion özelliğini okuyarak uyumluluğu doğrulayın.
IronPdfEngine Yerel Olarak Nasıl Çalıştırılır?
Yerel dağıtım varsayılan moddur. Node.js için IronPDF, başlatma sırasında IronPdfEngine'i bir alt işlem olarak başlatır ve uygulamanız kapanana kadar onunla iletişim kurar. Her biri farklı avantajlara sahip iki yükleme yaklaşımı mevcuttur.
Seçenek 1: IronPdfEngine'i Çalışma Zamanında İndir
@ironsoftware/ironpdf'yi yükledikten sonra ek paketlere gerek yoktur. İlk çalışma sırasında, IronPDF, ana platformu (örneğin, Windows x64) algılar ve internetten uyumlu IronPdfEngine ikili dosyalarını indirir.
//:path=shell
npm install @ironsoftware/ironpdf//:path=shell
npm install @ironsoftware/ironpdfAvantajları:
- Uygulama paketini küçük tutar.
- Platforma özgü yapılandırma olmaksızın birden çok platforma dağıtılır.
Dezavantajları:
- İlk birkaç çalıştırmada internet erişimi gerektirir.
- İlk yürütmede ikili dosyalar getirildiğinde daha yavaş başlangıç süresi.
Seçenek 2 (Tavsiye Edilir): IronPdfEngine Bağımlılık Olarak Yükleyin
Node.js için IronPDF, belirli bir platform için IronPdfEngine ikili dosyasını demetleyen özel motor paketlerini destekler. Bu paketlerden biri veya daha fazlasını ana kütüphane ile birlikte yükleyin, böylece çalışma zamanında indirme işleminden kaçınılır.
ironpdf ve ironpdf-engine-xxx-xxx paketleri aynı sürümde olmalıdır. Motor paketi sürüm numarası IronPDF sürümüne değil, dahili motor yapısına referans verir.Windows x64:
//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x64//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x64Windows x86:
//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x86//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x86Linux x64:
//:path=shell
npm install @ironsoftware/ironpdf-engine-linux-x64//:path=shell
npm install @ironsoftware/ironpdf-engine-linux-x64macOS x64:
//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-x64//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-x64macOS arm64:
//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-arm64//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-arm64Avantajları:
- Daha hızlı başlangıç — çalışma zamanında indirme gerekmez.
- Bağımlılık yüklendikten sonra internet erişimi gerekmez.
Dezavantajları:
- Daha büyük uygulama paketi boyutu.
- Hedef platformların yapı zamanında belirlenmesi gerekir.
Uzak IronPdfEngine'e Nasıl Bağlanılır?
PDF oluşturma, ortak bir hizmet olduğunda — örneğin, bir konteynerleşmiş mikro hizmet mimarisinde, bir Kubernetes kümesinde bir Node.js hizmetleri bir motor podunu paylaştığı veya merkezi hale getirilmiş bir render işlemi, hizmet başına yükü azaltıyorsa — uzak dağıtım uygun olur. Bağlantı kurmadan önce, IronPdfEngine Docker görüntüsünü Nasıl Çekilir ve Çalıştırılır kılavuzuna uyarak çekin ve başlatın.
Gerekli Motor Sürümü Nasıl Doğrulanır?
Motor sürümünün Node.js paket sürümüyle eşleşmesi gerekir. Hangi sürümü çekeceğinizi doğrulamak için ironPdfEngineVersion özelliğini okuyun:
//:path=get-started/use-ironpdfengine/check-version.js
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);//:path=get-started/use-ironpdfengine/check-version.js
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);Docker görüntü etiketi belirlenirken basılı sürüm numarasını kullanın. Uyumsuz bir sürüm çalıştırmak, gRPC iletişim hatalarına neden olur.
Uzak Bağlantı Nasıl Yapılandırılır?
IronPdfEngine'in 123.456.7.8:33350 adresinde çalıştığını varsayalım. Konfigürasyon çağrısını, uygulamanızın başında — herhangi bir IronPDF yöntemi çağırılmadan önce — yapın.
//:path=get-started/use-ironpdfengine/remote-config.js
IronPdfGlobalConfig.setConfig({
ironPdfEngineDockerAddress: "123.456.7.8:33350"
});//:path=get-started/use-ironpdfengine/remote-config.js
IronPdfGlobalConfig.setConfig({
ironPdfEngineDockerAddress: "123.456.7.8:33350"
});Adres, Node.js ana bilgisayarından erişilebilir olmalıdır. Uygulama sunucusu ile motor ana bilgisayarı arasındaki 33350 bağlantı noktasını engelleyen hiçbir güvenlik duvarı kuralı olmadığından emin olun.
ironpdf-engine-xxx-xxx bağımlılık paketi yüklemeniz gerekmez. ironPdfEngineDockerAddress ayarlandığında yerel motor tamamen atlanır.Bir Sonraki Adımlar Nelerdir?
IronPdfEngine'i kurmak, Node.js'deki tüm PDF çalışmaları için temeldir. Motor çalışır durumda olduğunda — yerel veya uzaktan — tam IronPDF API'si mevcuttur: HTML'yi PDF'ye dönüştürme, belgeleri birleştirme, damgalar ve filigranlar ekleme, metin çıkarma ve daha fazlası.
- Su işaretlerini kaldırmadan tüm özelliklerin kilidini açmak için ücretsiz deneme lisansını başlatın.
- Üretim dağıtımları için bir lisans satın alın.
- Tam Node.js başlama kılavuzuna devam edin: IronPDF for Node.js — Başlarken.
Sıkça Sorulan Sorular
IronPdfEngine nedir ve neden Node.js için gereklidir?
IronPdfEngine, tüm PDF işlememe, düzenleme ve okuma işlemlerini ele alan bir gRPC sunucusudur. @ironsoftware/ironpdf Node.js paketi, IronPdfEngine ile gRPC üzerinde iletişim kuran bir istemci sarmalayıcıdır, bu nedenle herhangi bir PDF işleminin başarılı olması için motorun — yerel veya uzak olarak — çalışır durumda olması gereklidir.
Node.js için IronPDF nasıl yüklenir?
Proje dizininizde npm install @ironsoftware/ironpdf çalıştırın. İlk çalıştırmada, IronPDF ana bilgisayar platformunu algılar ve eş IronPdfEngine ikililerini otomatik olarak indirir.
Çalışma zamanı indirme ve paketlenmiş bağımlılık seçenekleri arasındaki fark nedir?
Çalışma zamanı indirme seçeneği ek paket gerektirmez ancak ilk çalıştırmada internet erişimi ve daha yavaş başlangıç gerektirir. Paketlenmiş bağımlılık seçeneği (Seçenek 2, önerilen) motorun ikili dosyasını pakete dahil eden @ironsoftware/ironpdf-engine-windows-x64 gibi platforma özgü bir paket yükler, böylece başlangıç daha hızlıdır ve kurulumdan sonra internet erişimi gerekmez — daha büyük bir paketin maliyetiyle birlikte.
IronPdfEngine sürümünün IronPDF paket sürümünüze uygun olduğunu nasıl sağlarım?
Gerekli tam sürüm dizisini almak için çalışma anında IronPdfGlobalConfig.ironPdfEngineVersion özelliğini okuyun. ironpdf paketi ve herhangi bir ironpdf-engine-xxx-xxx bağımlılığı aynı sürümde olmalıdır; çapraz sürüm kombinasyonları desteklenmez.
Yerel yerine uzak bir IronPdfEngine ne zaman kullanmalıyım?
Konteynerli mikro hizmet mimarileri, birçok Node.js hizmetinin tek bir işleme pod'unu paylaştığı Kubernetes dağıtımları veya PDF işlemenin hizmet başına kaynak yükünü azaltmanın merkezi hale getirdiği senaryolar için bir uzak IronPdfEngine uygundur.
Node.js'i bir uzak IronPdfEngine'a nasıl bağlarım?
Uygulamanızın başında, herhangi bir IronPDF yönteminden önce IronPdfGlobalConfig.setConfig({ ironPdfEngineDockerAddress: "host:port" }) çağrısında bulunun. host:port'u uzak motorun IP adresi ve portu (varsayılan 33350) ile değiştirin. Adresin erişilebilir olduğundan ve bir güvenlik duvarı tarafından engellenmediğinden emin olun.
Uzak bir IronPdfEngine kullanırken bir motor bağımlılığı paketi kurmam gerekir mi?
Hayır. ironPdfEngineDockerAddress ayarlandığında, IronPDF yerel motoru tamamen atlar. Uzak dağıtımlar için herhangi bir ironpdf-engine-xxx-xxx paketi kurmaya gerek yoktur.
IronPdfEngine hangi platformları destekliyor?
Windows x64, Windows x86, Linux x64, macOS x64 ve macOS arm64 için platforma özgü motor paketleri mevcuttur. Dağıtım hedefinize uygun paketi yükleyin veya tek bir kurulumla birden çok platformu desteklemek için çalışma zamanı indirme seçeneğini kullanın.
Aynı projede birden fazla platforma özgü motor paketi kurabilir miyim?
Evet. Aynı projede birden fazla ironpdf-engine-xxx-xxx paketi yükleyebilirsiniz. IronPDF, ana bilgisayar platformu için doğru ikili dosyayı çalıştırma anında seçer, bu, birden fazla işletim sistemine çapraz yapı ve dağıtımlar yapan projeler için faydalıdır.
IronPdfEngine gRPC iletişimi için hangi portu kullanıyor?
IronPdfEngine default olarak 33350 portunda dinler. Uzak bir bağlantıyı yapılandırırken, bu portu ironPdfEngineDockerAddress değerine dahil edin ve portun Node.js ana bilgisayarı ile motor ana bilgisayarı arasında açık olduğundan emin olun.
Hâlâ Kaydırıyor Musunuz?
Hızlıca kanıt ister misiniz?
bir örnek çalıştır HTML'nizi bir PDF'ye dönüştüğünü izleyin.
Ücretsiz Başlayın
Ücretsiz Başlayın
Ücretsiz Canlı Demo Rezervasyonu
Kredi kartı veya hesap oluşturma gerektirmez
