ما خوشحالیم که انتشار GroupDocs.Conversion for Java 26.10 را که از اکتبر 2026 در دسترس است، اعلام کنیم. این نسخه پشتیبانی از تبدیل آرشیوهای ISO و UUE (uuencode)، تبدیل تصویر HEIC از طریق یک کانکتور رمزگشای قابل پیکربندی، و امکان حذف متادیتای داخلی و سفارشی اسناد هنگام تبدیل اسناد WordProcessing، Spreadsheet، Presentation و PDF را معرفی می‌کند. همچنین شامل بهبودهایی در تشخیص نوع فایل، اندازه‌گذاری صفحه، حفظ حاشیه‌ها و رفع چندین باگ است—از جمله یک رگرسیون بحرانی در نسخه 26.9 که اولین فراخوانی License.setLicense() با خطا مواجه می‌شد.

چه چیزهای جدیدی در این نسخه وجود دارد

  • [Feature] تبدیل آرشیوهای ZIP، 7z، TAR و CPIO به ISO (CONVERSIONNET-7079)
  • [Feature] تبدیل آرشیوهای ISO به ZIP، 7z، TAR و CPIO (CONVERSIONNET-7078)
  • [Feature] تبدیل UUE به Bzip2، Gzip، Lzip، LZMA، XZ، Unix Z، Zstandard، UUE و فرمت‌های آرشیوی پشتیبانی‌شده (CONVERSIONNET-7154)
  • [Feature] تبدیل Bzip2، Gzip، LZMA، XZ، Unix Z و Zstandard به UUE (CONVERSIONNET-7155)
  • [Feature] پشتیبانی از تبدیل تصاویر HEIC از طریق یک کانکتور رمزگشا (CONVERSIONNET-7140)
  • [Enhancement] بهبود تشخیص نوع فایل زمانی که LoadOptions فرمت را مشخص نمی‌کند (CONVERSIONNET-7161)
  • [Enhancement] حذف متادیتا هنگام تبدیل از اسناد PDF (CONVERSIONNET-7131)
  • [Enhancement] حذف متادیتا هنگام تبدیل از اسناد Presentation (CONVERSIONNET-7130)
  • [Enhancement] حذف متادیتا هنگام تبدیل از اسناد Spreadsheet (CONVERSIONNET-7129)
  • [Enhancement] حذف متادیتا هنگام تبدیل از اسناد WordProcessing (CONVERSIONNET-7128)
  • [Bug] رعایت نوع فایلی که در LoadOptions مشخص شده است هنگام تبدیل بر اساس نام فایل (CONVERSIONNET-7089)
  • [Bug] رفع مشکل تبدیل نمودار به تصویر در macOS و Linux (CONVERSIONNET-7088)
  • [Bug] اعمال صحیح اندازه صفحه درخواست‌شده (CONVERSIONNET-7080)
  • [Bug] گنجاندن ستون‌های سفارشی MPP در خروجی تبدیل (CONVERSIONNET-6905)
  • [Bug] رفع تبدیل HTML به RTF از طریق PDF (CONVERSIONNET-6969)
  • [Bug] رفع استخراج فایل‌های متنی بومی و تبدیل‌شده که در اسناد Word جاسازی شده‌اند (CONVERSIONNET-7138)
  • [Bug] رفع بازیابی اطلاعات سند PDF (CONVERSIONNET-7183)
  • [Task] پیاده‌سازی توکن‌های لغو در عملیات تبدیل و ذخیره‌کننده‌ها (CONVERSIONJAVA-3265)
  • [Task] امکان لغو تبدیل (CONVERSIONJAVA-3266)
  • [Bug] رفع IllegalAccessError در اولین فراخوانی License.setLicense() که کتابخانه را در حالت ارزیابی باقی می‌گذاشت (رگرسیون در 26.9) (CONVERSIONJAVA-3300)

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

پشتیبانی از تبدیل ISO و UUE

از CompressionConvertOptions.setFormat(...) همراه با CompressionFileType.Iso یا CompressionFileType.Uue استفاده کنید.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.CompressionFileType;
import com.groupdocs.conversion.options.convert.CompressionConvertOptions;

CompressionConvertOptions options = new CompressionConvertOptions();
options.setFormat(CompressionFileType.Iso);

try (Converter converter = new Converter("input.zip")) {
    converter.convert("converted.iso", options);
}

ISO از تبدیل به و از ZIP، 7z، TAR و CPIO و همچنین تبدیل ISO به ISO پشتیبانی می‌کند.
UUE می‌تواند به Bzip2، Gzip، Lzip، LZMA، XZ، Unix Z، Zstandard، UUE، ZIP، 7z، TAR، CPIO و ISO تبدیل شود.
تبدیل به UUE از Bzip2، Gzip، LZMA، XZ، Unix Z و Zstandard پشتیبانی می‌شود. تبدیل Lzip به UUE پشتیبانی نمی‌شود.

پشتیبانی از تبدیل HEIC

یک پیاده‌سازی از com.groupdocs.conversion.integration.heic.IHeicConnector را با استفاده از
RasterImageLoadOptions.setHeicConnector(...) پیکربندی کنید و آن گزینه‌های بارگذاری را هنگام بارگذاری تصویر HEIC به Converter پاس دهید.
این کانکتور رمزگشای HEIC را فراهم می‌کند؛ برای تبدیل HEIC نیاز به یک پیاده‌سازی رمزگشا دارید.

IHeicConnector.getBitmapInfo(InputStream) یک بیت‌مپ رمزگشایی‌شده برمی‌گرداند. متد پیش‌فرض
getDecodedBitmapInfo(InputStream) آن بیت‌مپ را به com.groupdocs.conversion.contracts.BitmapInfo سازگار می‌کند.
کانکتورها می‌توانند این متد را بازنویسی کنند تا داده‌های پیکسل رمزگشایی‌شده را مستقیماً فراهم کنند.

حذف متادیتا

WordProcessingLoadOptions، SpreadsheetLoadOptions، PresentationLoadOptions و PdfLoadOptions پیاده‌سازی IMetadataLoadOptions را دارند و متدهای setClearBuiltInDocumentProperties(boolean) و setClearCustomDocumentProperties(boolean) را در اختیار می‌گذارند، به همراه گترهای متناظر. هر دو گزینه به‌صورت پیش‌فرض false هستند.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setClearBuiltInDocumentProperties(true);
loadOptions.setClearCustomDocumentProperties(true);

try (Converter converter = new Converter("input.docx", () -> loadOptions)) {
    converter.convert("converted.pdf", new PdfConvertOptions());
}

حاشیه‌های صفحه nullable و پیش‌فرض‌های Spreadsheet

گترهای حاشیه در IPageMarginConvertOptions، PdfConvertOptions و WordProcessingConvertOptions اکنون Float برمی‌گردانند نه float. حاشیه‌ها به‌صورت پیش‌فرض null هستند که در صورت امکان حاشیه‌های سند منبع را حفظ می‌کند.
ست‌کننده‌ها مقادیر nullable Float را می‌پذیرند؛ overloadهای float همچنان موجود هستند.

برنامه‌ها را در مقابل کتابخانه به‌روزشده بازکامپایل کنید. کدی که نتیجه گتر حاشیه را از‌جعبه‌برداری می‌کند باید null را مدیریت کند. برای حفظ یک طرح ثابت‑حاشیه، حاشیه‌های صریح تنظیم کنید.

SpreadsheetLoadOptions.getAllColumnsInOnePagePerSheet() و getSkipEmptyRowsAndColumns() اکنون به‌صورت پیش‌فرض false هستند. اگر برنامه شما نیاز به تمام ستون‌ها در یک صفحه یا حذف ردیف‌ها و ستون‌های خالی دارد، آن‌ها را صریحاً به true تنظیم کنید.

گزینه‌های بارگذاری ایمیل

متدهای منسوخ‌شده EmailLoadOptions.getDisplayEmailAddress() و setDisplayEmailAddress(boolean) حذف شدند. به جای آن از getDisplayFromEmailAddress() و setDisplayFromEmailAddress(boolean) استفاده کنید.

تشخیص فرمت گزینه‌های بارگذاری

گزینه‌های بارگذاری که چندین نوع فایل را پوشش می‌دهند دیگر فرمت پیش‌فرضی اختصاص نمی‌دهند. وقتی Format مشخص نشده باشد، فرمت منبع از ورودی تشخیص داده می‌شود. وقتی فرمت به‌صورت صریح مشخص شده باشد، هنگام بارگذاری بر اساس نام فایل رعایت می‌شود.

ویژگی‌های جدید

این انتشار فرمت‌های جدید، کنترل‌های متادیتا و اصلاحات تبدیل را معرفی می‌کند:

  • افزودن تبدیل به و از آرشیوهای ISO.
  • افزودن تبدیل به و از UUE (uuencode) با جفت‌های فرمت ذکرشده در زیر.
  • افزودن تبدیل تصویر HEIC از طریق یک کانکتور رمزگشای قابل پیکربندی.
  • افزودن گزینه‌ها برای حذف ویژگی‌های داخلی و سفارشی سند هنگام تبدیل اسناد WordProcessing، Spreadsheet، Presentation و PDF.
  • بهبود تشخیص نوع فایل، اندازه‌گذاری صفحه و حفظ حاشیه‌های سند منبع.
  • رفع مشکلات تبدیل نمودار به تصویر در macOS و Linux، ستون‌های سفارشی MPP، استخراج متن جاسازی‌شده و انتخاب صفحه PDF.
  • رفع رگرسیونی در 26.9 که اولین فراخوانی License.setLicense() IllegalAccessError می‌انداخت و کتابخانه را در حالت ارزیابی می‌گذاشت.

مثال کد

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.CompressionFileType;
import com.groupdocs.conversion.options.convert.CompressionConvertOptions;

CompressionConvertOptions options = new CompressionConvertOptions();
options.setFormat(CompressionFileType.Iso);

try (Converter converter = new Converter("input.zip")) {
    converter.convert("converted.iso", options);
}

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

Maven

پکیج آخرین GroupDocs.Conversion را از طریق Maven ارتقا دهید:

GroupDocs.Conversion for Java 26.10

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-conversion</artifactId>
    <version>26.10</version>
</dependency>

منابع