Instalação
Visão geral
Este artigo explica como adicionar o Aspose.Slides for Java a um projeto. O Aspose.Slides for Java é publicado no repositório Maven próprio da Aspose, não no Maven Central, portanto um projeto Maven deve declarar esse repositório. Você também pode baixar o arquivo JAR e colocá‑lo no classpath manualmente. Ambas as rotas terminam com um pequeno programa que confirma que a biblioteca funciona.
O Aspose.Slides for Java não requer o Microsoft PowerPoint. Ele gera programaticamente os arquivos de apresentação necessários. No entanto, para visualizar as apresentações geradas, pode ser necessário o Microsoft PowerPoint ou outro visualizador de apresentações.
Pré-requisitos
- Um Kit de Desenvolvimento Java (JDK). O projeto e os comandos neste artigo requerem JDK 11 ou posterior. No JDK 11, o programa que verifica a instalação exibe um aviso que começa com “WARNING: An illegal reflective access operation has occurred”; ele não afeta o resultado e pode ser ignorado.
- Apache Maven, se você usar a rota Maven.
- No Linux, a biblioteca fontconfig e ao menos uma fonte instalada. Consulte Linux.
Instalar a partir do repositório Maven
A Aspose hospeda suas bibliotecas Java em seu próprio repositório Maven. Para usar o Aspose.Slides for Java em um projeto Maven, adicione duas entradas ao seu pom.xml.
-
Declare o repositório Maven da Aspose.
<repositories> <repository> <id>AsposeJavaAPI</id> <name>Aspose Java API</name> <url>https://releases.aspose.com/java/repo/</url> </repository> </repositories> -
Adicione a dependência Aspose.Slides for Java.
<dependencies> <dependency> <groupId>com.aspose</groupId> <artifactId>aspose-slides</artifactId> <version>26.10</version> <classifier>jdk8</classifier> </dependency> </dependencies>
O classificador jdk8 é necessário: ele seleciona a compilação Java SE da biblioteca. Substitua 26.10 pela versão mais recente listada no repositório. O repositório publica um arquivo de soma de verificação SHA-1 ao lado de cada JAR, que o Maven verifica ao baixar a biblioteca.
Verificar a instalação
Para verificar a configuração com um novo projeto:
-
Crie uma pasta para o projeto e salve este pom.xml nela:
<project xmlns="http://maven.apache.org/POM/4.0.0"> <modelVersion>4.0.0</modelVersion> <groupId>com.example</groupId> <artifactId>hello-slides</artifactId> <version>1.0</version> <properties> <maven.compiler.release>11</maven.compiler.release> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <exec.mainClass>HelloSlides</exec.mainClass> </properties> <repositories> <repository> <id>AsposeJavaAPI</id> <name>Aspose Java API</name> <url>https://releases.aspose.com/java/repo/</url> </repository> </repositories> <dependencies> <dependency> <groupId>com.aspose</groupId> <artifactId>aspose-slides</artifactId> <version>26.10</version> <classifier>jdk8</classifier> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.15.0</version> </plugin> </plugins> </build> </project>Além do repositório e da dependência, este pom.xml define a versão Java para compilar, nomeia a classe que
mvn exec:javaexecuta e fixa o plugin de compilação, porque o plugin mais antigo que algumas instalações Maven usam por padrão ignora a configuraçãomaven.compiler.release. -
Salve o primeiro exemplo em Criar apresentações como src/main/java/HelloSlides.java.
-
Na pasta do projeto, execute:
mvn compile exec:java
O Maven baixa o Aspose.Slides for Java, compila o programa e o executa. O programa salva new_presentation.pptx na pasta do projeto.
Usar o arquivo JAR sem Maven
-
Baixe aspose-slides-26.10-jdk8.jar da pasta de versão no repositório. Para outra versão, abra sua pasta no repositório e baixe o arquivo que termina em -jdk8.jar.
-
Salve o primeiro exemplo em Criar apresentações como HelloSlides.java na mesma pasta do arquivo JAR.
-
Nessa pasta, execute:
java -cp aspose-slides-26.10-jdk8.jar HelloSlides.java
O JDK compila e executa o arquivo fonte único, e o programa salva new_presentation.pptx na pasta. Em sua própria aplicação, adicione o arquivo JAR ao classpath em sua ferramenta de construção ou IDE.
Linux
O Aspose.Slides for Java usa o suporte a fontes do Java, que no Linux requer a biblioteca fontconfig e ao menos uma fonte instalada. Sem eles, salvar uma apresentação falha com o erro “Fontconfig head is null, check your fonts or fonts configuration”. Imagens mínimas de servidor e contêiner podem não ter nenhum dos dois; a imagem oficial do contêiner Ubuntu, por exemplo, não tem nenhum.
No Debian e Ubuntu, este comando instala um JDK, Maven, fontconfig e as fontes DejaVu:
sudo apt-get update && sudo apt-get install -y default-jdk maven fontconfig fonts-dejavu-core
As fontes usadas nas suas apresentações, ou substitutas adequadas, também devem estar instaladas para que o texto seja renderizado corretamente.
FAQ
Como posso verificar se o Aspose.Slides está integrado corretamente?
Compile seu projeto, instancie uma Presentation em branco e salve-a com um novo nome. Se o arquivo for criado sem lançar exceções, a biblioteca foi integrada com sucesso.
Como posso limitar o consumo de memória ao processar apresentações grandes?
Aumente os limites de memória da JVM somente tanto quanto necessário, e chame dispose em cada instância de Presentation dentro de um bloco finally para liberar o cache rapidamente. Isso evita erros de falta de memória e mantém o uso geral de memória previsível durante operações em lote.
Posso excluir formatos de exportação indesejados para reduzir o tamanho final do JAR?
As versões atuais do Aspose.Slides são distribuídas como uma única biblioteca monolítica, portanto não é possível desativar exportadores específicos como PDF ou SVG no momento da compilação.