Instalação

Sobre o que é esta página

Instale o Aspose.Slides para Node.js via Java a partir do npm no Windows, Linux e macOS: o JDK, Python e as ferramentas de compilação C++ que ele precisa, o comando npm e um primeiro script para verificar a instalação.

Visão geral

Este artigo explica como instalar o Aspose.Slides for Node.js via Java no Windows, Linux e macOS, e como verificar se a instalação funciona.

O Aspose.Slides for Node.js via Java é distribuído como o pacote aspose.slides.via.java no npm. Ele executa o Aspose.Slides em uma máquina virtual Java através do pacote java, um addon nativo do Node.js que o npm compila no seu computador durante a instalação. Por isso a instalação necessita, além do Node.js:

Um Kit de Desenvolvimento Java (JDK) 8 ou posterior. Apenas o runtime Java não é suficiente: a compilação precisa dos arquivos de cabeçalho do JDK.
Python 3, que a ferramenta de compilação node-gyp usa.
Uma cadeia de ferramentas de compilação C++ para o seu sistema operacional.

Instalar os pré‑requisitos

Windows

Instale o Node.js 20 ou posterior.
Instale um JDK, por exemplo o Eclipse Temurin, e configure a variável de ambiente JAVA_HOME apontando para sua pasta de instalação. A compilação usa o JDK ao qual JAVA_HOME aponta.
Instale o Python 3.
Instale o Build Tools for Visual Studio 2022 com a carga de trabalho Desktop development with C++. Mantenha os componentes padrão da carga de trabalho, que incluem MSVC v143 - VS 2022 C++ x64/x86 build tools e o Windows 11 SDK. O Visual Studio 2026 não funciona: a versão do node-gyp que o pacote java compila não o reconhece.

Linux

Instale o Node.js 20 ou posterior a partir de nodejs.org ou da fonte de pacotes da sua distribuição. Em seguida, instale um JDK, Python 3 e as ferramentas de compilação C++. No Debian e Ubuntu:

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

No Linux, a compilação encontra o JDK instalado sem necessidade de configuração adicional. Se vários JDKs estiverem instalados, defina JAVA_HOME para aquele que deseja usar.

macOS

Instale o Node.js 20 ou posterior, um JDK e as Ferramentas de Linha de Comando do Xcode, que incluem Python 3 e o compilador C++. Veja Troubleshooting Installation para notas específicas do macOS.

Instalar via npm

Crie uma pasta de projeto e instale o pacote:

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

npm baixa o Aspose.Slides e compila a ponte java, o que pode levar alguns minutos. Se a compilação falhar, consulte Troubleshooting Installation.

Verificar a instalação

Crie um arquivo chamado hello.js na pasta do projeto com o seguinte código. Ele cria uma apresentação, adiciona uma caixa de texto ao seu primeiro slide e salva o resultado como 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 executa em uma máquina virtual Java que mantém o Node.js em execução, portanto encerre o processo explicitamente.
process.exit(0);

Execute o script:

node hello.js

Se hello.pptx aparecer na pasta do projeto, a instalação funciona. A máquina virtual Java que executa o Aspose.Slides impede que o Node.js encerre por conta própria, por isso o script termina com process.exit(0). Create Presentations explica o código.

Instalar a partir de um arquivo ZIP

O pacote também está disponível como um arquivo ZIP com o mesmo conteúdo do pacote npm. Para instalá‑lo a partir do arquivo:

Instale os pré‑requisitos para o seu sistema operacional, conforme descrito acima.
Baixe o arquivo da Aspose.Slides for Node.js via Java download page.

Crie uma pasta de projeto:

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

Extraia o arquivo para uma subpasta chamada aspose.slides.via.java dentro da pasta do projeto, de modo que o package.json do arquivo fique em hello-slides/aspose.slides.via.java/package.json.
Instale o pacote a partir dessa pasta:
```
npm install ./aspose.slides.via.java
```
npm instala a ponte java da qual o pacote depende e a compila, como faz para o pacote npm.
Verifique a instalação conforme descrito em Check the Installation.

FAQ

Existe uma versão gratuita ou limitação de avaliação?

Sim. Sem uma licença, o Aspose.Slides funciona em modo de avaliação: ele adiciona uma marca d’água de avaliação a cada slide que salva e trunca o texto lido das apresentações. Para remover essas limitações, aplique uma license válida.

Por que meu script não sai depois de terminar?

O pacote java inicia uma máquina virtual Java dentro do processo Node.js, e essa máquina virtual mantém o processo em execução. Chame process.exit quando seu script terminar o trabalho.

Suporte a TypeScript Instalar Aspose.Slides para Node.js via Java usando Docker