Aspose.Slides FOSS
Java
Cách Bắt Đầu với Aspose.Slides FOSS cho Java

Cách Bắt Đầu với Aspose.Slides FOSS cho Java

aspose-slides-foss cho Java là một thư viện miễn phí, có giấy phép MIT, dùng để tạo và chỉnh sửa các tệp PowerPoint .pptx — không cần Microsoft Office, có sẵn trên Maven Central.

Hướng Dẫn Từng Bước

Bước 1: Thêm phụ thuộc Maven

Thêm phụ thuộc vào pom.xml của bạn (yêu cầu Java 21 trở lên):

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

Xác minh gói được giải quyết đúng bằng cách biên dịch dự án:

mvn dependency:resolve

Bước 2: Nhập các lớp cần thiết

Nhập các lớp cần thiết để tải bản trình chiếu và lưu:

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;

Bước 3: Tạo bản trình chiếu

Tạo một Presentation không có đối số để bắt đầu với một slide trống. Luôn sử dụng try-with-resources để đảm bảo các tài nguyên nội bộ được giải phóng:

import org.aspose.slides.foss.Presentation;

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

Bước 4: Thêm một hình dạng có văn bản

Sử dụng slide.getShapes().addAutoShape() để chèn một hình chữ nhật, sau đó gọi addTextFrame() để thêm nội dung văn bản:

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");
}

Bước 5: Áp dụng tô màu và Lưu

Đặt màu tô đặc cho hình trước khi lưu:

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");
}

Các vấn đề thường gặp và cách khắc phục

ClassNotFoundException for org.aspose.slides.foss.Presentation
Phụ thuộc Maven không được giải quyết. Chạy mvn dependency:resolve và kiểm tra xem
artifact có sẵn trong Maven Central hay không. Xác minh phiên bản trong pom.xml.

UnsupportedOperationException khi gọi một số phương thức
Một số tính năng (biểu đồ, hoạt ảnh, xuất PDF) ném UnsupportedOperationException
trong phiên bản này. Kiểm tra phần các hạn chế đã biết của tài liệu tham chiếu API trước khi sử dụng
các tính năng nâng cao.

Tọa độ hình dạng có vẻ sai
Các tọa độ và kích thước được tính bằng EMU (English Metric Units). Một điểm xấp xỉ
12700 EMU. Slide mặc định là 9144000 × 6858000 EMU.

File not found when loading an existing PPTX
Truyền một đường dẫn tuyệt đối hoặc đảm bảo thư mục làm việc được đặt đúng cách:

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

Câu hỏi thường gặp

aspose-slides-foss có yêu cầu Microsoft Office không?

Không. Thư viện tạo và đọc các tệp .pptx một cách nguyên bản trong Java thuần mà không phụ thuộc vào Microsoft Office, tự động hoá COM, hoặc các API của Windows.

Các phiên bản Java nào được hỗ trợ?

Java 21 trở lên. Thư viện chạy trên Windows, macOS, Linux và các container Docker.

Thư viện có miễn phí cho việc sử dụng thương mại không?

Có. Nó được phát hành dưới giấy phép MIT. Bạn có thể sử dụng, sửa đổi và phân phối lại nó cho bất kỳ mục đích nào, bao gồm các ứng dụng thương mại.

Tôi có thể tải một tệp PPTX hiện có không?

Có. Truyền đường dẫn tệp tới hàm khởi tạo Presentation:

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

Tôi có cần phải đóng Presentation một cách rõ ràng không?

Vâng. Presentation implements AutoCloseable. Luôn sử dụng try-with-resources (try (Presentation prs = new Presentation()) { ... }) để đảm bảo dọn dẹp.

Xem thêm

 Tiếng Việt