Aspose.Slides FOSS - Aspose.Slides البرمجيات الحرة ومفتوحة المصدر

كيفية البدء مع Aspose.Slides FOSS لـ Java

aspose-slides-foss لـ Java هي مكتبة مجانية مرخصة من MIT للإنشاء والتحرير. PowerPoint .pptx الملفات – لا يتطلب Microsoft Office، متوفرة على Maven Central.

خطوة بخطوة دليل

الخطوة 1: إضافة الاعتماد على Maven

إضافة الإدمان إلى الخاص بك pom.xml (المتطلبات من Java 21 أو أحدث):

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

تحقق من أن الحزمة يتم حلها بشكل صحيح عن طريق بناء المشروع:

mvn dependency:resolve

الخطوة 2: استيراد الدروس المطلوبة

استيراد الفصول التي تحتاجها لتحميل العروض التقديمية وتوفير المال:

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;

الخطوة الثالثة: إعداد عرض

بناء أ Presentation لا توجد حجة للبدء مع شريط واحد.استخدم دائما الموارد التي يحاولونها لضمان إطلاق المواد الداخلية:

import org.aspose.slides.foss.Presentation;

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

الخطوة 4: إضافة شكل مع النص

استخدام slide.getShapes().addAutoShape() إدخال مستطيل ثم الاتصال addTextFrame() إضافة محتوى النص:

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

الخطوة 5: قم بتطبيق ملء وتوفير

ضع لون ملء قوي على الشكل قبل حفظه:

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

مشكلات و تصحيحات مشتركة

ClassNotFoundException من أجل org.aspose.slides.foss.Presentation لا يمكن حل الإدمان الماين.السباق mvn dependency:resolve ثم تحقق من أن هذا يتوفر في Maven Central.تحقق من النسخة في pom.xml.

UnsupportedOperationException عند استدعاء بعض الأساليب بعض الميزات (الرسوم البيانية، الرسوم المتحركة، PDF export) رمي UnsupportedOperationException في هذا الإصدار، تحقق من قسم القيود المعروفة للمراجعة API قبل استخدامها. الخصائص المتقدمة .

يبدو أن إحداثيات الشكل وتتكون المنسوجات والأبعاد في EMU (الواحدات المتقاربة الإنجليزية). 12700 EMU. The default slide is 9144000 × 6858000 EMU.

ملف لم يتم العثور عليه عند تحميل PPTX الحالي اجتياز مسار مطلق أو تأكد من أن دليل العمل يتم تعيينه بشكل صحيح:

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

الأسئلة المتكررة

هل يتطلب تطبيق aspose-slides-foss Microsoft Office؟?

لا. تخلق المكتبة وتقرأ .pptx الملفات الأصلية في جاوا النقية مع لا تعتمد على على Microsoft Office أو COM Automation أو Windows APIs.

ما هي الإصدارات Java التي يتم دعمها؟?

يُنقل المكتبة على حاويات ويندوز و macOS و Linux و Docker.

هل المكتبة مجانية للاستخدام التجاري؟?

نعم يتم إصدارها بموجب ترخيص MIT. يمكنك استخدامها وتعديلها وإعادة توزيعها لأي غرض، بما في ذلك التطبيقات التجارية.

هل يمكنني تحميل ملف PPTX الحالي؟?

نعم.مر على مسار الملف إلى Presentation البناء :

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

هل يجب أن أختم العرض بشكل صريح؟?

نعم . Presentation التطبيق AutoCloseable.الاستفادة دائمًا من الموارد المحاولة (try (Presentation prs = new Presentation()) { ... }(لضمان التنظيف) لتوفير النظافة.