Cara Memulakan dengan Aspose.Slides FOSS untuk Java

aspose-slides-foss untuk Java ialah perpustakaan percuma berlesen MIT untuk membuat dan menyunting fail PowerPoint .pptx — tidak memerlukan Microsoft Office, tersedia di Maven Central.

Panduan Langkah demi Langkah

Langkah 1: Tambah Kebergantungan Maven

Tambah kebergantungan 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>

Sahkan pakej diselesaikan dengan betul dengan membina projek:

mvn dependency:resolve

Langkah 2: Import Kelas yang Diperlukan

Import kelas yang anda perlukan untuk memuatkan persembahan 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 Persembahan

Bina Presentation tanpa argumen untuk memulakan dengan satu slaid kosong. Sentiasa gunakan
try-with-resources untuk memastikan sumber dalaman 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: Tambah Bentuk dengan Teks

Gunakan slide.getShapes().addAutoShape() untuk menyisipkan segi empat tepat, kemudian panggil addTextFrame() untuk menambah kandungan 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 pepejal 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");
}

Isu Umum dan Penyelesaian

ClassNotFoundException for org.aspose.slides.foss.Presentation Kebergantungan Maven tidak dapat diselesaikan. Jalankan mvn dependency:resolve dan periksa bahawa artifak tersedia di Maven Central. Sahkan versi dalam pom.xml.

UnsupportedOperationException apabila memanggil kaedah tertentu
Beberapa ciri (carta, animasi, eksport PDF) melempar UnsupportedOperationException
dalam keluaran ini. Semak bahagian batasan yang diketahui dalam rujukan API sebelum menggunakan
ciri lanjutan.

Koordinat bentuk nampak tidak betul
Koordinat dan dimensi berada dalam EMU (English Metric Units). Satu titik kira‑kira 12700 EMU. Slaid lalai ialah 9144000 × 6858000 EMU.

Fail tidak dijumpai semasa memuatkan PPTX sedia ada
Berikan laluan mutlak atau pastikan direktori kerja ditetapkan dengan betul:

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

Soalan Lazim

Adakah aspose-slides-foss memerlukan Microsoft Office?

Tidak. Perpustakaan ini mencipta dan membaca fail .pptx secara asli dalam Java tulen tanpa kebergantungan pada Microsoft Office, automasi COM, atau API Windows.

Versi Java mana yang disokong?

Java 21 atau lebih baru. Perpustakaan ini berjalan pada Windows, macOS, Linux, dan kontena Docker.

Adakah perpustakaan ini percuma untuk kegunaan komersial?

Ya. Ia dikeluarkan di bawah Lesen MIT. Anda boleh menggunakan, mengubah suai, dan mengedar semula ia untuk sebarang tujuan, termasuk aplikasi komersial.

Bolehkah saya memuatkan fail PPTX yang sedia ada?

Ya. Hantar laluan fail kepada konstruktor Presentation:

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

Adakah saya perlu menutup Presentation secara eksplisit?

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