Z przyjemnością ogłaszamy wydanie GroupDocs.Conversion for Java 26.10, dostępne od października 2026. To wydanie wprowadza obsługę konwersji archiwów ISO i UUE (uuencode), konwersję obrazów HEIC za pomocą konfigurowalnego łącznika dekodera oraz możliwość usuwania wbudowanych i niestandardowych metadanych dokumentu podczas konwersji dokumentów WordProcessing, Spreadsheet, Presentation i PDF. Zawiera także ulepszenia wykrywania typów plików, rozmiaru stron, zachowywania marginesów oraz naprawia kilka błędów — w tym krytyczną regresję w wersji 26.9, gdzie pierwsze wywołanie License.setLicense() nie powiodło się.
Co nowego w tym wydaniu
- [Feature] Konwertuj archiwa ZIP, 7z, TAR i CPIO do ISO (CONVERSIONNET-7079)
- [Feature] Konwertuj archiwa ISO do ZIP, 7z, TAR i CPIO (CONVERSIONNET-7078)
- [Feature] Konwertuj UUE do Bzip2, Gzip, Lzip, LZMA, XZ, Unix Z, Zstandard, UUE oraz obsługiwanych formatów archiwów (CONVERSIONNET-7154)
- [Feature] Konwertuj Bzip2, Gzip, LZMA, XZ, Unix Z i Zstandard do UUE (CONVERSIONNET-7155)
- [Feature] Obsługa konwersji obrazów HEIC za pomocą łącznika dekodera (CONVERSIONNET-7140)
- [Enhancement] Ulepszone wykrywanie typu pliku, gdy LoadOptions nie określają formatu (CONVERSIONNET-7161)
- [Enhancement] Usuwanie metadanych przy konwersji z dokumentów PDF (CONVERSIONNET-7131)
- [Enhancement] Usuwanie metadanych przy konwersji z dokumentów Presentation (CONVERSIONNET-7130)
- [Enhancement] Usuwanie metadanych przy konwersji z dokumentów Spreadsheet (CONVERSIONNET-7129)
- [Enhancement] Usuwanie metadanych przy konwersji z dokumentów WordProcessing (CONVERSIONNET-7128)
- [Bug] Respektowanie typu pliku określonego w LoadOptions przy konwersji po nazwie pliku (CONVERSIONNET-7089)
- [Bug] Naprawiono konwersję diagramu na obraz na macOS i Linux (CONVERSIONNET-7088)
- [Bug] Poprawne stosowanie żądanego rozmiaru strony (CONVERSIONNET-7080)
- [Bug] Dołączanie niestandardowych kolumn MPP w wyniku konwersji (CONVERSIONNET-6905)
- [Bug] Naprawiono konwersję HTML do RTF przez PDF (CONVERSIONNET-6969)
- [Bug] Naprawiono wyodrębnianie natywnych i konwertowanych plików tekstowych osadzonych w dokumentach Word (CONVERSIONNET-7138)
- [Bug] Naprawiono pobieranie informacji o dokumencie PDF (CONVERSIONNET-7183)
- [Task] Implementacja tokenów anulowania w operacjach konwersji i saverach (CONVERSIONJAVA-3265)
- [Task] Umożliwienie anulowania konwersji (CONVERSIONJAVA-3266)
- [Bug] Naprawiono IllegalAccessError przy pierwszym wywołaniu License.setLicense(), które pozostawiało bibliotekę w trybie ewaluacyjnym (regresja w 26.9) (CONVERSIONJAVA-3300)
Zmiany w publicznym API
Obsługa konwersji ISO i UUE
Użyj CompressionConvertOptions.setFormat(...) z CompressionFileType.Iso lub 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 obsługuje konwersję do i z ZIP, 7z, TAR i CPIO oraz konwersję ISO do ISO.
UUE może być konwertowane do Bzip2, Gzip, Lzip, LZMA, XZ, Unix Z, Zstandard, UUE, ZIP, 7z, TAR, CPIO i ISO.
Konwersja do UUE jest wspierana z Bzip2, Gzip, LZMA, XZ, Unix Z i Zstandard. Lzip do UUE nie jest obsługiwane.
Obsługa konwersji HEIC
Skonfiguruj implementację com.groupdocs.conversion.integration.heic.IHeicConnector używając RasterImageLoadOptions.setHeicConnector(...) i przekaż te opcje ładowania do Converter przy ładowaniu obrazu HEIC. Łącznik dostarcza dekoder HEIC; wymagana jest implementacja dekodera do konwersji HEIC.
IHeicConnector.getBitmapInfo(InputStream) zwraca zdekodowany bitmap. Jego domyślna metoda getDecodedBitmapInfo(InputStream) dostosowuje ten bitmap do com.groupdocs.conversion.contracts.BitmapInfo. Łączniki mogą nadpisać tę metodę, aby bezpośrednio dostarczyć zdekodowane dane pikseli.
Usuwanie metadanych
WordProcessingLoadOptions, SpreadsheetLoadOptions, PresentationLoadOptions i PdfLoadOptions implementują IMetadataLoadOptions i udostępniają setClearBuiltInDocumentProperties(boolean) oraz setClearCustomDocumentProperties(boolean) wraz z odpowiednimi getterami. Obie opcje domyślnie mają wartość 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 marginesy stron i domyślne ustawienia arkusza kalkulacyjnego
Gettery marginesów w IPageMarginConvertOptions, PdfConvertOptions i WordProcessingConvertOptions teraz zwracają Float zamiast float. Marginesy domyślnie mają wartość null, co zachowuje marginesy dokumentu źródłowego, gdy to możliwe. Settery akceptują nullable Float; przeciążenia setterów przyjmujące prymitywny float pozostają dostępne.
Przekompiluj aplikacje względem zaktualizowanej biblioteki. Kod, który odpakowuje wynik gettera marginesu, musi obsługiwać null. Ustaw explicite marginesy, aby zachować układ o stałych marginesach.
SpreadsheetLoadOptions.getAllColumnsInOnePagePerSheet() oraz getSkipEmptyRowsAndColumns() domyślnie mają wartość false. Ustaw je explicite na true, jeśli Twoja aplikacja wymaga wszystkich kolumn na jednej stronie lub pomijania pustych wierszy i kolumn.
Opcje ładowania e‑mail
Usunięto przestarzałe metody EmailLoadOptions.getDisplayEmailAddress() i setDisplayEmailAddress(boolean). Zamiast nich użyj getDisplayFromEmailAddress() i setDisplayFromEmailAddress(boolean).
Wykrywanie formatu w opcjach ładowania
Opcje ładowania obejmujące wiele typów plików nie przypisują już domyślnego formatu. Gdy Format nie jest określony, format źródłowy jest wykrywany z wejścia. Jawnie określony format jest respektowany przy ładowaniu po nazwie pliku.
Nowe funkcje
To wydanie wprowadza nowe formaty, kontrolę metadanych oraz poprawki konwersji:
- Dodano konwersję z i do archiwów ISO.
- Dodano konwersję z i do UUE (uuencode), z parami formatów wymienionymi poniżej.
- Dodano konwersję obrazów HEIC za pomocą konfigurowalnego łącznika dekodera.
- Dodano opcje usuwania wbudowanych i niestandardowych właściwości dokumentu przy konwersji dokumentów WordProcessing, Spreadsheet, Presentation i PDF.
- Ulepszono wykrywanie typu pliku, rozmiar stron oraz zachowywanie marginesów dokumentu źródłowego.
- Naprawiono konwersję diagramu na obraz na macOS i Linux, niestandardowe kolumny MPP, wyodrębnianie osadzonych tekstów oraz wybór stron PDF.
- Naprawiono regresję w wersji 26.9, gdzie pierwsze wywołanie License.setLicense() rzucało IllegalAccessError i pozostawiało bibliotekę w trybie ewaluacyjnym.
Przykład kodu
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);
}
Jak uzyskać aktualizację
Maven
Uaktualnij do najnowszego pakietu GroupDocs.Conversion za pomocą Maven:
GroupDocs.Conversion for Java 26.10
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion</artifactId>
<version>26.10</version>
</dependency>