Instalace

O čem je tato stránka

Instalujte Aspose.Slides pro Node.js prostřednictvím Java z npm na Windows, Linuxu a macOS: JDK, Python a nástroje pro sestavení C++, které jsou potřeba, příkaz npm a první skript pro ověření instalace.

Přehled

Tento článek vysvětluje, jak nainstalovat Aspose.Slides pro Node.js prostřednictvím Java na Windows, Linux a macOS a jak ověřit, že instalace funguje.

Aspose.Slides pro Node.js prostřednictvím Java je distribuováno jako balíček aspose.slides.via.java na npm. Spouští Aspose.Slides ve virtuálním stroji Java pomocí balíčkujava, nativního doplňku Node.js, který npm během instalace zkompiluje ve vašem počítači. Proto instalace kromě Node.js vyžaduje:

Java Development Kit (JDK) 8 nebo novější. Pouze Java runtime nestačí: kompilace vyžaduje hlavičkové soubory JDK.
Python 3, který používá nástroj pro sestavení node-gyp.
Sada nástrojů pro sestavení C++ pro váš operační systém.

Instalace předpokladů

Windows

Nainstalujte Node.js 20 nebo novější.
Nainstalujte JDK, například Eclipse Temurin, a nastavte proměnnou prostředí JAVA_HOME na jeho instalační složku. Kompilace používá JDK, na kterou ukazuje JAVA_HOME.
Nainstalujte Python 3.
Nainstalujte Build Tools for Visual Studio 2022 s pracovním zatížením Desktop development with C++. Zachovejte výchozí komponenty pracovního zatížení, které zahrnují MSVC v143 – VS 2022 C++ x64/x86 build tools a Windows 11 SDK. Visual Studio 2026 nefunguje: verze node-gyp, kterou kompiluje balíček java, ji nepozná.

Linux

Nainstalujte Node.js 20 nebo novější z nodejs.org nebo z repozitáře vaší distribuce. Poté nainstalujte JDK, Python 3 a nástroje pro sestavení C++. Na Debianu a Ubuntu:

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

Na Linuxu kompilace najde nainstalované JDK bez další konfigurace. Pokud je nainstalováno více JDK, nastavte JAVA_HOME na to, které chcete použít.

macOS

Nainstalujte Node.js 20 nebo novější, JDK a Xcode Command Line Tools, které obsahují Python 3 a kompilátor C++. Podívejte se na Troubleshooting Installation pro specifické poznámky k macOS.

Instalace z npm

Vytvořte projektovou složku a nainstalujte balíček:

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

npm stáhne Aspose.Slides a zkompiluje most java, což může trvat několik minut. Pokud kompilace selže, podívejte se na Troubleshooting Installation.

Ověření instalace

Vytvořte soubor s názvem hello.js v projektové složce s následujícím kódem. Vytvoří prezentaci, přidá textové pole na první snímek a výsledek uloží jako hello.pptx:

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 běží ve virtuálním stroji Java, který udržuje Node.js běžet, takže proces ukončete explicitně.
process.exit(0);

Spusťte skript:

node hello.js

Pokud se soubor hello.pptx objeví v projektové složce, instalace funguje. Virtuální stroj Java, který spouští Aspose.Slides, zabraňuje Node.js ukončit se samostatně, proto skript končí process.exit(0). Create Presentations vysvětluje kód.

Instalace ze ZIP archivu

Balíček je také k dispozici jako ZIP archiv se stejným obsahem jako npm balíček. Pro instalaci z archivu:

Nainstalujte předpoklady pro svůj operační systém, jak je popsáno výše.
Stáhněte archiv ze Aspose.Slides for Node.js via Java download page.

Vytvořte projektovou složku:

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

Rozbalte archiv do podsložky pojmenované aspose.slides.via.java uvnitř projektové složky, aby soubor package.json z archivu byl v hello-slides/aspose.slides.via.java/package.json.
Nainstalujte balíček z této složky:
```
npm install ./aspose.slides.via.java
```
npm nainstaluje most java, na kterém balíček závisí, a zkompiluje jej, stejně jako u npm balíčku.
Ověřte instalaci podle popisu v Check the Installation.

FAQ

Existuje bezplatná verze nebo omezení zkušební verze?

Ano. Bez licence běží Aspose.Slides v evaluačním režimu: přidává na každý uložený snímek vodoznak hodnocení a ořezává text načtený z prezentací. Pro odstranění těchto omezení použijte platnou licenci.

Proč se můj skript neukončí po dokončení?

Balíček java spustí ve procesu Node.js virtuální stroj Java a tento stroj udržuje proces v chodu. Zavolejte process.exit, až skript dokončí svou práci.

Podpora TypeScriptu Instalace Aspose.Slides pro Node.js pomocí Javy s Dockerem