استثناها و خطاهای رایج مرتبط با قلم‌ها در لینوکس

مروری کلی

هنگامی که Aspose.Slides در لینوکس استفاده می‌شود، ممکن است مشکلات مربوط به قلم‌ها رخ دهد اگر فرآیند جاوا نتواند به پوشه‌های قلم مورد نیاز یا پوشه موقت دسترسی پیدا کند، اگر هیچ قلمی بر روی سیستم نصب نشود، یا اگر کتابخانه‌های سیستمی مورد نیاز مانند fontconfig یا libfreetype وجود نداشته باشند.

این مقاله خطاها و استثناهای رایج مرتبط با قلم‌ها در لینوکس را توصیف می‌کند و راه‌حل‌هایی برای رفع آن‌ها ارائه می‌دهد. همچنین نحوه بررسی دسترسی به پوشه‌های قلم و TEMP، نصب قلم‌ها و کتابخانه‌های مورد نیاز، و استفاده از FontsLoader برای بارگذاری قلم‌ها بدون نصب سیستم-wide را توضیح می‌دهد.

متن یا تصویر (EMF یا WMF) گمشده هنگام اجرای کد در لینوکس

این مشکل در سیستم‌هایی که دارای محدودیت‌های زیر هستند، رخ می‌دهد:

هنگامی که هیچ قلمی نصب نشده باشد یا پوشه قلم برای فرآیند جاوا قابل دسترسی نباشد
هنگامی که پوشه TEMP قابل دسترسی نباشد.

راه‌حل

دسترسی به پوشه TEMP و پوشه قلم‌ها را بررسی و تأیید کنید که اعطا شده است.

در برخی موارد، ممکن است به دلیل محدودیت‌های محیط یا سیاست امنیتی نتوانید دسترسی به پوشه‌ها را اعطا کنید. راه‌حل‌های زیر را امتحان کنید:

راه‌حل جایگزین

از FontsLoader برای بارگذاری قلم‌های مورد نیاز بدون نصب آن‌ها استفاده کنید:

FontsLoader.loadExternalFonts(pathToFontsFolders);

اگر پوشه TEMP قابل دسترسی نیست، از این کد برای تعیین پوشه دیگری به عنوان TEMP برای جاوا استفاده کنید:

String newTempFolder = "pathToTmpFolder";
String oldValue = System.getProperty("java.io.tmpdir");
java.io.File file = new java.io.File(newTempFolder);
if (!file.exists())
    file.mkdir();
System.setProperty("java.io.tmpdir", newTempFolder);
try {

    FontsLoader.loadExternalFonts(pathToFontsFolders);

    Presentation pres = ...
    // ....

} finally {
    System.setProperty("java.io.tmpdir", oldValue);
}

استثنا: InvalidOperationException: عدم یافتن قلم‌های نصب شده بر روی سیستم

این استثنا زمانی رخ می‌دهد که

فرآیند جاوا نتواند به پوشه قلم‌ها دسترسی پیدا کند
هیچ قلمی نصب نشده باشد.

راه‌حل

دسترسی به پوشه قلم برای فرآیند جاوا را بررسی و تأیید کنید.
برخی قلم‌ها را نصب کنید یا از FontsLoader استفاده کنید.

قلم‌ها را نصب کنید.

Ubuntu:

sudo apt-get update
sudo apt-get install -y fonts-dejavu-core
fc-cache -fv

CentOS:

sudo yum makecache
sudo yum -y install dejavu-sans-fonts
fc-cache -fv

با استفاده از FontsLoader:

FontsLoader.loadExternalFonts(pathToFontsFolders);

استثنا: NoClassDefFoundError: عدم توانایی در مقداردهی اولیه کلاس com.aspose.slides.internal.ey.this

این استثنا بر روی سیستم لینوکسی رخ می‌دهد که فاقد fontconfig و قلم‌ها است.

راه‌حل

fontconfig را نصب کنید:

Ubuntu:

sudo apt-get update
sudo apt-get -y install fontconfig

CentOS:

sudo yum makecache
sudo yum -y install fontconfig

به‌علاوه، برخی نسخه‌های open‑jdk (به عنوان مثال alpine JDK) نیز به نصب قلم‌ها نیاز دارند.

Ubuntu:

sudo apt-get install -y fonts-dejavu-core
fc-cache -fv

CentOS:

sudo yum -y install dejavu-sans-fonts
fc-cache -fv

استثنا: UnsatisfiedLinkError: libfreetype.so.6: نمی‌تواند فایل شیء به‌اشتراک‌گذاری شده را باز کند: چنین فایلی یا چنین دایرکتوری وجود ندارد

این استثنا بر روی سیستم لینوکسی رخ می‌دهد که فاقد کتابخانه libfreetype است.

راه‌حل

libfreetype و fontconfig را نصب کنید:

Ubuntu:

sudo apt-get update
sudo apt-get install libfreetype6
sudo apt-get -y install fontconfig

CentOS:

sudo yum makecache
sudo yum install libfreetype6
sudo yum -y install fontconfig

نکته

فراموش نکنید قلم‌ها را نصب کنید یا از FontsLoader استفاده کنید.

پشتیبانی از کتابخانه قابل قطع کار چندرشته‌ای در Aspose.Slides برای جاوا