تثبيت Aspose.Slides for Android via Java
نظرة عامة
تصف هذه المقالة طريقة إضافة Aspose.Slides for Android via Java إلى مشروع Android. الطريقة المفضلة هي السماح لـ Gradle بتحميل المكتبة من مستودع Maven الخاص بـ Aspose. يمكنك أيضًا تحميل ملف JAR وإضافته إلى مشروعك يدويًا.
المكتبة غير منشورة في Maven Central أو مستودع Maven الخاص بجوجل. وهي متوفرة من مستودع Aspose الخاص، كحزمة aspose-slides مع المصنف android.via.java.
التثبيت من مستودع Maven الخاص بـ Aspose
الخطوة 1: إضافة المستودع
تعلن مشاريع Android Studio الجديدة عن مستودعاتها في كتلة dependencyResolutionManagement داخل settings.gradle.kts، ويقوم Gradle برفض المستودعات التي يضيفها ملف بناء الوحدة. أضف سطر maven الموضح أدناه إلى كتلة repositories داخل تلك الكتلة الموجودة، بدلاً من لصق كتلة dependencyResolutionManagement ثانية:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
maven { url = uri("https://releases.aspose.com/java/repo/") }
}
}
الخطوة 2: إضافة التبعية
أضف المكتبة إلى كتلة dependencies في ملف بناء وحدة التطبيق، app/build.gradle.kts:
dependencies {
implementation("com.aspose:aspose-slides:26.9:android.via.java")
}
الجزء الأخير من الإحداثيات، android.via.java، هو المصنف الذي يختار بناء Android من المكتبة. بدون هذا المصنف، لا يستطيع Gradle العثور على الحزمة.
ثم قم بمزامنة المشروع مع ملفات Gradle، حتى يقوم Gradle بتحميل المكتبة.
اختر إصدارًا
لا يتم بناء Aspose.Slides for Android via Java لكل إصدار في المستودع. يتم نشر بناءاته لبعض إصدارات Aspose.Slides for Java فقط، والإصدار الذي لا يحتوي على بناء Android يفشل في الحل. اختر إصدارًا مدرجًا في صفحة Aspose.Slides for Android via Java download page.
سكربتات بناء Groovy
إذا كان مشروعك يستخدم سكربتات بناء Groovy، أضف سطر maven إلى كتلة repositories داخل كتلة dependencyResolutionManagement الموجودة في settings.gradle:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
maven { url = 'https://releases.aspose.com/java/repo/' }
}
}
وأضف التبعية إلى app/build.gradle:
dependencies {
implementation 'com.aspose:aspose-slides:26.9:android.via.java'
}
إضافة ملف JAR يدويًا
إذا لم تتمكن من استخدام مستودع Maven، أضف ملف JAR إلى مشروعك:
- حمّل ملف JAR من مجلد الإصدار في Aspose’s Maven repository. بالنسبة للإصدار 26.9، الملف هو aspose-slides-26.9-android.via.java.jar في مجلد 26.9.
- انسخ الملف إلى مجلد app/libs في مشروعك. أنشئ المجلد إذا لم يكن موجودًا.
- أضف الملف إلى كتلة
dependenciesفي app/build.gradle.kts، ثم قم بمزامنة المشروع:
dependencies {
implementation(files("libs/aspose-slides-26.9-android.via.java.jar"))
}
إنشاء العرض التقديمي الأول
بعد مزامنة المشروع، استمر مع Create Presentations. يضيف المثال الأول مربع نص إلى شريحة ويحفظ العرض التقديمي في التخزين الخاص لتطبيقك، دون الحاجة إلى صلاحية التخزين. بدون ترخيص، يضيف Aspose.Slides علامة مائية تقييم إلى كل شريحة يتم حفظها؛ راجع Licensing.
الإصدار
منذ عام 2018، يتطابق إصدار Aspose.Slides for Android via Java مع Aspose.Slides for Java. لا يتم نشر إصدارات Android لكل نسخة Java؛ راجع Choose a Version.
الأسئلة المتكررة
كيف يمكنني التحقق من أن Aspose.Slides تم دمجه بشكل صحيح؟
قم ببناء مشروعك، أنشئ كائنًا فارغًا من نوع Presentation واحفظه باسم جديد. إذا تم إنشاء الملف دون رمي استثناءات، فقد تم دمج المكتبة بنجاح.
كيف يمكنني الحد من استهلاك الذاكرة عند معالجة عروض تقديمية كبيرة؟
استدعِ طريقة dispose لكل كائن Presentation داخل كتلة finally لتحرير موارده فورًا، ومعالجة عرض تقديمي كبير واحد في كل مرة. يساعد ذلك في منع أخطاء نفاد الذاكرة ويجعل استهلاك الذاكرة الكلي قابلًا للتنبؤ أثناء عمليات الدفعات.
هل يمكنني استبعاد تنسيقات تصدير غير مرغوب فيها لتقليل حجم ملف JAR النهائي؟
الإصدارات الحالية من Aspose.Slides يتم توزيعها كمكتبة أحادية ضخمة، لذا لا يمكنك تعطيل مُصدِّرات معينة مثل PDF أو SVG أثناء عملية البناء.