Como começar com Aspose.Slides FOSS para Java

aspose-slides-foss para Java é uma biblioteca livre, licenciada pelo MIT para criar e editar PowerPoint .pptx arquivos não é necessário Microsoft Office, disponível no Maven Central.

Guia passo a passo

Passo 1: Adicionar a dependência Maven

Adicione a dependência ao seu pom.xml (requer Java 21 ou posterior):

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

Verifique se o pacote resolve corretamente ao construir o projeto:

mvn dependency:resolve

Passo 2: Importar as classes necessárias

Importar as classes que você precisa para carregar apresentações e salvar:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;

Passo 3: Faça uma apresentação

Construir um Presentation Sem argumentos para começar com um slide em branco. Teste de recursos para assegurar a liberação dos recursos internos:

import org.aspose.slides.foss.Presentation;

try (Presentation prs = new Presentation()) {
    System.out.println("Slides: " + prs.getSlides().size());
    prs.save("new_presentation.pptx");
}

Passo 4: Adicionar um formato com texto

Utilização: slide.getShapes().addAutoShape() para inserir um retângulo, em seguida, chamar addTextFrame() para adicionar conteúdo de texto:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.NullableBool;

try (Presentation prs = new Presentation()) {
    ISlideCollection slides = prs.getSlides();
    ISlide slide = slides.get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 400, 150
    );
    ITextFrame tf = shape.addTextFrame("Hello from Aspose.Slides FOSS!");
    IPortionFormat fmt = tf.getParagraphs().get(0).getPortions().get(0).getPortionFormat();
    fmt.setFontHeight(24);
    fmt.setFontBold(NullableBool.TRUE);
    prs.save("with_shape.pptx");
}

Passo 5: Aplicar um preenchimento e salvar

Defina uma cor de preenchimento sólido na forma antes de salvar:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    ISlideCollection slides = prs.getSlides();
    ISlide slide = slides.get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 100, 100, 400, 200
    );
    shape.getFillFormat().setFillType(FillType.SOLID);
    shape.getFillFormat().getSolidFillColor().setColor(new Color(70, 130, 180));
    shape.addTextFrame("Styled shape");
    prs.save("styled.pptx");
}

Problemas comuns e soluções

ClassNotFoundException para o org.aspose.slides.foss.Presentation A dependência de Maven não foi resolvida. mvn dependency:resolve e verificar que o O artefato está disponível na Maven Central. Verifique a versão em pom.xml.

UnsupportedOperationException quando se invocam certos métodos Alguns recursos (gráficos, animações, exportação PDF) lançar UnsupportedOperationException Verifique a seção de limitações conhecidas da referência API antes de usar o código-fonte. características avançadas.

Coordenadas de forma parecem desvinculadas. As coordenadas e as dimensões são em UEM (Unidades métricas inglesas). 12700 EMU. The default slide is 9144000 × 6858000 EMU.

Arquivo não encontrado ao carregar um PPTX existente Passar um caminho absoluto ou assegurar que o diretório de trabalho está corretamente definido:

import java.nio.file.Paths;
String path = Paths.get("presentations", "existing.pptx").toAbsolutePath().toString();
try (Presentation prs = new Presentation(path)) { }

Perguntas Frequentes

O aspose-slides-foss requer o Microsoft Office?

A biblioteca cria e lê. .pptx arquivos nativos em Java puro sem dependência Em Microsoft Office, na automação COM ou nas APIs do Windows.

Quais versões do Java são suportadas?

Java 21 ou posterior. A biblioteca é executada em contêineres do Windows, macOS, Linux e Docker.

A biblioteca é gratuita para uso comercial?

Sim, é lançado sob a licença MIT. Você pode usá-lo, modificá -lo e redistribuí -la para qualquer finalidade, incluindo aplicações comerciais.

Posso carregar um ficheiro PPTX existente?

Passe o caminho do ficheiro para a página de acesso. Presentation constructor para carregar o ficheiro existente na memória:

try (Presentation prs = new Presentation("existing.pptx")) {
    System.out.println("Loaded " + prs.getSlides().size() + " slides");
    prs.save("copy.pptx");
}

Preciso de fechar a apresentação explicitamente?

Sim, é verdade. Presentation instrumentos de trabalho AutoCloseable.Sempre use recursos de prova . (try (Presentation prs = new Presentation()) { ... }) para garantir a limpeza.