Kurulum

Bu sayfa ne hakkında

Windows, Linux ve macOS üzerinde npm’den Java aracılığıyla Node.js için Aspose.Slides’i kurun: ihtiyaç duyduğu JDK, Python ve C++ derleme araçları, npm komutu ve kurulumu kontrol etmek için ilk betik.

Genel Bakış

Bu makale, Aspose.Slides for Node.js via Java’nin Windows, Linux ve macOS üzerinde nasıl kurulacağını ve kurulumun çalıştığını nasıl kontrol edeceğinizi açıklar.

Aspose.Slides for Node.js via Java, npm üzerinde aspose.slides.via.java paketi olarak dağıtılır. java paketi aracılığıyla Aspose.Slides’i bir Java sanal makinesinde çalıştırır; bu, npm’nin kurulum sırasında bilgisayarınızda derlediği yerel bir Node.js eklentisidir. Bu nedenle kurulum, Node.js’in yanı sıra şunları da gerektirir:

Java Development Kit (JDK) 8 veya üzeri. Tek bir Java çalışma zamanı yeterli değildir: derleme JDK’nin başlık dosyalarına ihtiyaç duyar.
Python 3, derleme aracı node-gyp tarafından kullanılır.
İşletim sisteminiz için bir C++ derleme araç zinciri.

Gereksinimleri Yükleyin

Windows

Node.js 20 veya üzerini Node.js sitesinden yükleyin.
Örneğin Eclipse Temurin gibi bir JDK yükleyin ve JAVA_HOME ortam değişkenini kurulum klasörüne ayarlayın. Derleme, JAVA_HOME‘un işaret ettiği JDK’yi kullanır.
Python 3 yükleyin.
Build Tools for Visual Studio 2022 paketini Desktop development with C++ iş yüküyle yükleyin. İş yükünün varsayılan bileşenlerini (örneğin MSVC v143 - VS 2022 C++ x64/x86 build tools ve Windows 11 SDK) koruyun. Visual Studio 2026 çalışmaz: java paketinin derlediği node-gyp sürümü bunu tanımaz.

Linux

Node.js 20 veya üzerini nodejs.org adresinden ya da dağıtımınızın paket kaynağından yükleyin. Ardından bir JDK, Python 3 ve C++ derleme araçlarını kurun. Debian ve Ubuntu için:

sudo apt-get update
sudo apt-get install -y default-jdk python3 build-essential

Linux’ta, derleme kurulu JDK’yı ek bir yapılandırma olmadan bulur. Birden fazla JDK yüklüyse, kullanmak istediğiniz JDK’yı JAVA_HOME değişkenine ayarlayın.

macOS

Node.js 20 veya üzerini, bir JDK’yı ve Python 3 ile C++ derleyicisini içeren Xcode Command Line Tools’u kurun. macOS’a özgü notlar için Troubleshooting Installation sayfasına bakın.

npm’den Yükleme

Bir proje klasörü oluşturun ve paketi kurun:

mkdir hello-slides
cd hello-slides
npm init -y
npm install aspose.slides.via.java

npm, Aspose.Slides’ı indirir ve birkaç dakika sürebilen java köprüsünü derler. Derleme başarısız olursa, Troubleshooting Installation sayfasına bakın.

Kurulumu Kontrol Et

Proje klasöründe hello.js adlı bir dosya oluşturun ve aşağıdaki kodu ekleyin. Bu kod bir sunum oluşturur, ilk slaytına bir metin kutusu ekler ve sonucu hello.pptx olarak kaydeder:

const asposeSlides = require("aspose.slides.via.java");

const presentation = new asposeSlides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    const shape = slide.getShapes().addAutoShape(asposeSlides.ShapeType.Rectangle, 50, 50, 400, 100);
    shape.getTextFrame().setText("Hello, Aspose.Slides!");
    presentation.save("hello.pptx", asposeSlides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

// Aspose.Slides, Node.js'in çalışmasını sürdüren bir Java sanal makinesinde çalışır, bu yüzden süreci açıkça sonlandırın.
process.exit(0);

Betik çalıştırın:

node hello.js

hello.pptx proje klasöründe görünüyorsa kurulum çalışıyor demektir. Aspose.Slides’ı çalıştıran Java sanal makinesi, Node.js’in kendi kendine çıkmasını engeller; bu yüzden betik process.exit(0) ile sonlandırılır. Kodu açıklayan sayfaya bakın: Create Presentations.

ZIP Arşivinden Yükleme

Paket ayrıca npm paketiyle aynı içeriğe sahip bir ZIP arşivi olarak da sunulur. Arşivden yüklemek için:

Yukarıda açıklandığı gibi işletim sisteminiz için gereksinimleri kurun.
Arşivi Aspose.Slides for Node.js via Java indirme sayfasından indirin.

Bir proje klasörü oluşturun:

mkdir hello-slides
cd hello-slides
npm init -y

Arşivi proje klasörünün içinde aspose.slides.via.java adlı bir alt klasöre çıkarın; böylece arşivin package.json dosyası hello-slides/aspose.slides.via.java/package.json yolunda olur.
Paketi o klasörden kurun:
```
npm install ./aspose.slides.via.java
```
npm, paketin bağımlı olduğu java köprüsünü kurar ve npm paketinde olduğu gibi derler.
Kurulumu Kontrol Et bölümünde açıklandığı gibi kurulumu kontrol edin.

FAQ

Ücretsiz bir sürüm veya deneme sınırlaması var mı?

Evet. Lisans olmadan Aspose.Slides değerlendirme modunda çalışır: kaydettiği her slayta bir değerlendirme filigranı ekler ve sunumlardan okunan metni kısaltır. Bu sınırlamaları kaldırmak için geçerli bir license uygulayın.

Betik tamamlandıktan sonra neden çıkmıyor?

java paketi, Node.js süreci içinde bir Java sanal makinesi başlatır ve bu sanal makine sürecin çalışmasını sürdürür. Betiğiniz işi bittiğinde process.exit çağırın.

TypeScript Desteği Node.js için Aspose.Slides'ı Java Kullanarak Docker ile Kurun