Instalação

Instalação do Aspose.Slides FOSS para Java

Aspose.Slides FOSS for Java is distributed as a standard Maven artifact. It has no native extensions, no system libraries to install, and no Microsoft Office or other proprietary runtime required.


Pré-requisitos

RequisitoDetalhe
Java versão21 or later
Ferramenta de compilaçãoMaven 3.8+ ou Gradle 7+
Sistema operacionalWindows, macOS, Linux (qualquer plataforma que execute um JDK)
Compilador / ferramentas de compilaçãoJDK 21+ (para compilação)

1. Install via Maven (Recommended)

Adicione a seguinte dependência ao seu pom.xml:

<dependency>
    <groupId>org.aspose.slides.foss</groupId>
    <artifactId>aspose-slides-foss</artifactId>
    <version>1.0.0</version>
</dependency>

O Maven baixa e instala o pacote junto com todas as dependências transitivas. Nenhuma configuração pós-instalação é necessária.


2. Install via Gradle

Adicione o seguinte ao seu build.gradle:

dependencies {
    implementation 'org.aspose.slides.foss:aspose-slides-foss:1.0.0'
}

Ou em Kotlin DSL (build.gradle.kts):

dependencies {
    implementation("org.aspose.slides.foss:aspose-slides-foss:1.0.0")
}

3. Verify the Installation

Depois de adicionar a dependência, verifique se a biblioteca carrega corretamente e um Presentation pode ser criado:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;

public class VerifyInstall {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            System.out.println("Aspose.Slides FOSS installed successfully");
            System.out.println("Slides in empty presentation: " + prs.getSlides().size());
        }
    }
}

Saída esperada:

Aspose.Slides FOSS installed successfully
Slides in empty presentation: 1

Início Rápido: Criar uma Apresentação com uma Forma

O programa a seguir cria uma nova apresentação, adiciona um retângulo com texto e a salva como um .pptx arquivo:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

public class QuickStart {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            var slide = prs.getSlides().get(0);

            // Add a rectangle shape and set its text
            var shape = slide.getShapes().addAutoShape(ShapeType.RECTANGLE, 50, 50, 400, 150);
            shape.addTextFrame("Hello from Aspose.Slides FOSS!");

            prs.save("hello.pptx", SaveFormat.PPTX);
        }
        System.out.println("Saved hello.pptx");
    }
}

Importante: Sempre use Presentation dentro de um bloco try-with-resources. Isso garante a limpeza adequada dos recursos internos quando o bloco é finalizado.


Notas da Plataforma

Windows, macOS, Linux: A biblioteca é idêntica em todas as plataformas. É puro Java sem código nativo específico de plataforma.

Docker / serverless: A biblioteca funciona dentro de imagens Docker slim (como eclipse-temurin:21-jre-alpine). Nenhum pacote de sistema adicional é necessário.

CI/CD: Adicione a dependência Maven ao seu pom.xml e seu pipeline CI a resolverá automaticamente.


Recursos Adicionais

 Português