موارد جدید در این نسخه

GroupDocs.Viewer for Java 25.12 سه ویژگی جدید که بر API عمومی تأثیر می‌گذارند، دو بهبود و هشت رفع باگ معرفی می‌کند.

شناسه دسته‌بندی خلاصه
VIEWERNET‑5239 ویژگی جدید به‌صورت اختیاری، غیرفعال کردن حفظ جاوااسکریپت هنگام تبدیل اسناد به HTML.
VIEWERNET‑5486 ویژگی جدید معرفی نوع قلم متمایز برای هر خانواده فرمت‌ها.
VIEWERNET‑5484 ویژگی جدید فهرست قلم‌های جایگزین هنگام دریافت تمام قلم‌ها برای فرمت‌های خانواده WordProcessing.
VIEWERNET‑5490 بهبود جاسازی قلم‌ها هنگام تبدیل اسناد Spreadsheet به HTML جاسازی‌شده.
VIEWERNET‑5475 بهبود پشتیبانی از «سفت کردن سطر بالایی» هنگام رندر اسناد Spreadsheet به HTML.

API جدید مرتبط با قلم‌ها

این نسخه یک مدل قلم مخصوص به هر خانواده اضافه می‌کند:

  • com.groupdocs.viewer.fonts.IFontInfo – رابط پایه.
  • پیاده‌سازی‌ها: WordProcessingFontInfo, WordProcessingSubstitutedFontInfo, PdfFontInfo, SpreadsheetFontInfo, PresentationFontInfo.

کلاس قبلی com.groupdocs.viewer.fonts.UsedFontInfo حذف شده است و FontStyles از یک enum به یک کلاس کامل‌ویژگی‌دار تغییر یافته است.

نکته: مقالهٔ مستندات دریافت تمام قلم‌های استفاده‑شده در سند بارگذاری‌شده بازنویسی شد تا این تغییرات را پوشش دهد.

قلم‌های جاسازی‌شده برای Spreadsheet → HTML

هنگام رندر یک Spreadsheet (.xls, .xlsx و غیره) به HTML جاسازی‌شده با استفاده از متد کارخانه‌ای HtmlViewOptions.forEmbeddedResources()، قلم‌ها اکنون به‌صورت خودکار (با کدگذاری base‑64) جاسازی می‌شوند مگر اینکه پرچم isExcludeFonts() صراحتاً به true تنظیم شود.

// Example: Convert a Spreadsheet to embedded HTML with fonts embedded
HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources("output.html")
options.setExcludeFonts(false); // default is false

Viewer viewer = new Viewer("sample.xlsx");
viewer.view(options);

اگر خروجی HTML بدون قلم‌های جاسازی‌شده می‌خواهید، متد options.setExcludeFonts(true) را فراخوانی کنید.

رفع باگ‌ها و بهبودها

شناسه دسته‌بندی خلاصه
VIEWERNET‑5060 باگ پوشه CustomTempFonts به‌صورت مداوم رشد می‌کرد در .NET Framework 4.6.2 (برای جاوا نامرتبط است اما مستند شده).
VIEWERNET‑5145 باگ حروف ترکیب‌شده هنگام ذخیره PPTX به HTML همراه با تصاویر ظاهر می‌شوند.
VIEWERNET‑5379 باگ لوگو در گوشهٔ راست‑پایینی هنگام تبدیل PPTX به HTML گم می‌شود.
VIEWERNET‑5417 باگ تبدیل JPEG → PDF فایل‌های PDF خراب تولید می‌کرد که در Adobe Acrobat با خطا باز می‌شدند.
VIEWERNET‑5378 باگ استثنا در هنگام تبدیل PDF → HTML پرتاب می‌شد.
VIEWERNET‑5374 باگ پیوست‌های PDF هنگام رندر به HTML به‌درستی فرم نیافته بودند.
VIEWERNET‑5345 باگ گرادیان پس‌زمینه به‌درستی رندر نمی‌شد در تبدیل PDF → HTML.
VIEWERNET‑3780 باگ عدم توانایی در بارگذاری برخی فایل‌های PSD.
VIEWERNET‑5475 بهبود پشتیبانی از «سفت کردن سطر بالایی» افزوده شد هنگام رندر اسناد Spreadsheet به HTML.
VIEWERNET‑5490 بهبود قلم‌های جاسازی‌شده برای Spreadsheet → HTML جاسازی‌شده (نمونه کد بالا را ببینید).

تغییرات API عمومی

افزودنی‌ها

  • com.groupdocs.viewer.fonts.IFontInfo – رابط پایه.
  • کلاس‌های اطلاعات قلم خاص:
    • WordProcessingFontInfo
    • WordProcessingSubstitutedFontInfo
    • PdfFontInfo
    • SpreadsheetFontInfo
    • PresentationFontInfo
  • com.groupdocs.viewer.fonts.FontStyles – اکنون یک کلاس کامل با ویژگی‌های متعدد است (قبلاً یک enum بود).

حذف‌شده

  • com.groupdocs.viewer.fonts.UsedFontInfo – جایگزین شده توسط سلسله مراتب IFontInfo.
  • enum com.groupdocs.viewer.fonts.FontStyles – جایگزین شده توسط کلاس جدید.

این تغییرات در Javadoc به‌روزشده در https://reference.groupdocs.com/viewer/java/ منعکس شده است.

نحوه دریافت به‌روزرسانی

این کتابخانه از طریق Maven Central توزیع می‌شود. pom.xml خود (یا فایل ساخت Gradle) را به جدیدترین نسخه به‌روزرسانی کنید:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-viewer</artifactId>
    <version>25.12.0</version>
</dependency>

هم‌چنین می‌توانید JARهای کامپایل‌شده را از صفحه رسمی انتشار دانلود کنید:
https://releases.groupdocs.com/viewer/java/new-releases/groupdocs-viewer-for-java-25-12/

منابع