Cara Memulai dengan Aspose.Slides FOSS untuk Java

aspose-slides-foss untuk Java adalah perpustakaan gratis berlisensi MIT untuk membuat dan mengedit file PowerPoint .pptx — tidak memerlukan Microsoft Office, tersedia di Maven Central.

Panduan Langkah-demi-Langkah

Langkah 1: Tambahkan Dependensi Maven

Tambahkan dependensi ke pom.xml Anda (Java 21 atau lebih baru diperlukan):

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

Verifikasi paket terresolusi dengan benar dengan membangun proyek:

mvn dependency:resolve

Langkah 2: Impor Kelas yang Diperlukan

Impor kelas yang Anda perlukan untuk memuat presentasi dan menyimpan:

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;

Langkah 3: Buat Presentasi

Buat sebuah Presentation tanpa argumen untuk memulai dengan satu slide kosong. Selalu gunakan try-with-resources untuk memastikan sumber daya internal dibebaskan:

import org.aspose.slides.foss.Presentation;

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

Langkah 4: Tambahkan Bentuk dengan Teks

Gunakan slide.getShapes().addAutoShape() untuk menyisipkan persegi panjang, lalu panggil addTextFrame() untuk menambahkan konten teks:

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()) {
    ISlide slide = prs.getSlides().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");
}

Langkah 5: Terapkan Isian dan Simpan

Tetapkan warna isi padat pada bentuk sebelum menyimpan:

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()) {
    IAutoShape shape = prs.getSlides().get(0).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");
}

Masalah Umum dan Solusi

ClassNotFoundException untuk org.aspose.slides.foss.Presentation Dependensi Maven tidak terpecahkan. Jalankan mvn dependency:resolve dan periksa bahwa artefak tersedia di Maven Central. Verifikasi versi di pom.xml.

UnsupportedOperationException saat memanggil metode tertentu Beberapa fitur (grafik, animasi, ekspor PDF) melempar UnsupportedOperationException pada rilis ini. Periksa bagian keterbatasan yang diketahui dalam referensi API sebelum menggunakan fitur lanjutan.

Koordinat bentuk tampak salah
Koordinat dan dimensi dalam EMU (English Metric Units). Satu poin kira‑kira
12700 EMU. Slide default adalah 9144000 × 6858000 EMU.

File tidak ditemukan saat memuat PPTX yang ada
Berikan jalur absolut atau pastikan direktori kerja sudah diatur dengan benar:

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

Pertanyaan yang Sering Diajukan

Apakah aspose-slides-foss memerlukan Microsoft Office?

Tidak. Perpustakaan ini membuat dan membaca file .pptx secara native dalam Java murni tanpa ketergantungan pada Microsoft Office, otomasi COM, atau API Windows.

Versi Java mana yang didukung?

Java 21 atau lebih baru. Perpustakaan berjalan di Windows, macOS, Linux, dan kontainer Docker.

Apakah perpustakaan ini gratis untuk penggunaan komersial?

Ya. Itu dirilis di bawah Lisensi MIT. Anda dapat menggunakan, memodifikasi, dan mendistribusikannya untuk tujuan apa pun, termasuk aplikasi komersial.

Apakah saya dapat memuat file PPTX yang sudah ada?

Ya. Berikan jalur file ke konstruktor Presentation:

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

Apakah saya perlu menutup Presentation secara eksplisit?

Ya. Presentation mengimplementasikan AutoCloseable. Selalu gunakan try-with-resources (try (Presentation prs = new Presentation()) { ... }) untuk menjamin pembersihan.