Skip to content

Commit 1df6421

Browse files
committed
Document the new Zip related dependency
1 parent 0986c50 commit 1df6421

File tree

19 files changed

+38
-75
lines changed

19 files changed

+38
-75
lines changed

getting-started/Installation/nuget-packages.md

+4-2
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,8 @@ If your workflow relies on NuGet for package management, you can take advantage
3737

3838
>important The .NET Standard packages are compatible with any .NET version (e.g .NET 9), even if there are no packages explicitly available for the specific versions. The same applies to the .NET Framework packages.
3939
40+
>note As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
41+
4042
## Packages for .NET Framework and {{site.dotnetversions}} for Windows
4143

4244
The following list represents the available NuGet packages for the Document Processing libraries that you can use with the .NET Framework or {{site.dotnetversions}} for Windows. Although we offer them as an addition to the Telerik UI components, you can use them without any UI components:
@@ -54,7 +56,7 @@ The following list represents the available NuGet packages for the Document Proc
5456
* __Telerik.Windows.Documents.Spreadsheet.FormatProviders.Xls:__ This package is required for the import/export of `XLS` documents.
5557
* __Telerik.Windows.Documents.Spreadsheet.FormatProviders.Pdf:__ Required for the export of RadSpreadProcessing documents to `PDF`.
5658
* __Telerik.Windows.Documents.SpreadsheetStreaming:__ The main package for generating huge spreadsheet files while using minimum resources.
57-
* __Telerik.Windows.Zip:__ The package is required when working with zipped formats, such as `DOCX` and `XLSX`. It can be used as a standalone library as well.
59+
* __Telerik.Windows.Zip:__ It can be used as a standalone library as well.
5860
* __Telerik.Windows.Zip.Extensions:__ The package provides methods for working with files and platform specific operations.
5961

6062
## Packages for .NET Standard 2.0 (Support for {{site.dotnetversions}})
@@ -75,7 +77,7 @@ The following list represents the available NuGet packages for the Document Proc
7577
* __Telerik.Documents.Spreadsheet.FormatProviders.Xls:__ This package is required for the import/export of `XLS` documents.
7678
* __Telerik.Documents.Spreadsheet.FormatProviders.Pdf:__ Required for the export of RadSpreadProcessing documents to `PDF`.
7779
* __Telerik.Documents.SpreadsheetStreaming:__ The main package for generating huge spreadsheet files while using minimum resources.
78-
* __Telerik.Zip:__ The package is required when working with zipped formats, such as `DOCX` and `XLSX`. It can be used as a standalone library as well.
80+
* __Telerik.Zip:__ It can be used as a standalone library as well.
7981

8082
## See Also
8183

getting-started/first-steps.md

+4-2
Original file line numberDiff line numberDiff line change
@@ -55,12 +55,14 @@ This sample application will use [RadWordsProcessing]({%slug radwordsprocessing-
5555
For .NET Framework project:
5656
* __Telerik.Windows.Documents.Core.dll__
5757
* __Telerik.Windows.Documents.Flow.dll__
58-
* __Telerik.Windows.Zip.dll__
58+
* ~~Telerik.Windows.Zip.dll~~*
5959

6060
For .NET Standard ({{site.dotnetversions}}) project:
6161
* __Telerik.Documents.Core.dll__
6262
* __Telerik.Documents.Flow.dll__
63-
* __Telerik.Zip.dll__
63+
* ~~Telerik.Zip.dll~~*
64+
65+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
6466

6567
1. Reference the assembly that allows you to export the content as a PDF file:
6668

getting-started/getting-started.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ The following tables list all Telerik Document Processing assemblies for the dif
3939
| **Telerik.Documents.Spreadsheet.FormatProviders.Pdf.dll** | This assembly is needed for exporting to PDF documents. |
4040
| **Telerik.Documents.Spreadsheet.FormatProviders.Xls.dll** | This assembly is needed for processing XLS documents. |
4141
| **Telerik.Documents.SpreadsheetStreaming.dll** | The main assembly for generating huge spreadsheet files using minimum resources. |
42-
| **Telerik.Zip.dll** | Needed for working with zipped formats (DOCX, XLSX) and PDF. It is the main assembly of the [Telerik Zip Library]({%slug radziplibrary-overview%}). |
42+
| **Telerik.Zip.dll** |It is the main assembly of the [Telerik Zip Library]({%slug radziplibrary-overview%}). |
4343

4444

4545
### Assemblies for .NET Framework
@@ -60,7 +60,7 @@ The following tables list all Telerik Document Processing assemblies for the dif
6060
| **Telerik.Windows.Documents.Fixed.FormatProviders.Ocr.dll** | This assembly is needed for the [Optical Character Recognition (OCR)]({%slug radpdfprocessing-formats-and-conversion-ocr-ocrformatprovider%}) functionality. |
6161
| **Telerik.Windows.Documents.Tesseract.Ocr.dll** | This assembly is needed for the [Optical Character Recognition (OCR)]({%slug radpdfprocessing-formats-and-conversion-ocr-ocrformatprovider%}) functionality. |
6262
| **Telerik.Windows.Documents.CMapUtils.dll** | Provides a default implementation for getting the data of a predefined CMap table by a given name. The assembly is optional and you will need to include a reference to it only if you need to process documents with [CMap tables]({%slug radpdfprocessing-concepts-cmap-tables%}). |
63-
| **Telerik.Windows.Zip.dll** | Needed for working with zipped formats (DOCX, XLSX) and PDF. It is the main assembly of the [Telerik Zip Library]({%slug radziplibrary-overview%}). |
63+
| **Telerik.Windows.Zip.dll** |It is the main assembly of the [Telerik Zip Library]({%slug radziplibrary-overview%}). |
6464
| **Telerik.Windows.Zip.Extensions.dll** | Extends **Telerik.Windows.Zip** assembly with additional helper methods ([Zip Extensions]({%slug radziplibrary-zipextensions%})). |
6565

6666

integration/integration-with-vs-code.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -48,10 +48,11 @@ The **Telerik Document Processing Configuration wizard** allows you to select wh
4848

4949
|Library |Packages |
5050
|---------|---------|
51-
|**RadPdfProcessing**|Documents.Core<br>Documents.Fixed<br>Zip<br>Documents.ImageUtils<br>Documents.Fixed.FormatProviders.Image.Skia<br>Documents.CMapUtils|
52-
|**RadSpreadProcessing**|Documents.Core<br>Documents.Fixed<br>Documents.Spreadsheet<br>Documents.SpreadSheet.FormatProviders.OpenXml<br>Documents.SpreadSheet.FormatProviders.Pdf<br>Documents.Spreadsheet.FormatProviders.Xls<br>Documents.ImageUtils<br>Zip|
53-
|**RadWordsProcessing**|Documents.Core<br>Documents.Fixed<br>Documents.Flow<br>Documents.Flow.FormatProviders.Pdf<br>Documents.ImageUtils<br>Documents.Flow.FormatProviders.Doc<br>Documents.DrawingML<br>Zip|
51+
|**RadPdfProcessing**|Documents.Core<br>Documents.Fixed<br>~~Zip~~*<br>Documents.ImageUtils<br>Documents.Fixed.FormatProviders.Image.Skia<br>Documents.CMapUtils|
52+
|**RadSpreadProcessing**|Documents.Core<br>Documents.Fixed<br>Documents.Spreadsheet<br>Documents.SpreadSheet.FormatProviders.OpenXml<br>Documents.SpreadSheet.FormatProviders.Pdf<br>Documents.Spreadsheet.FormatProviders.Xls<br>Documents.ImageUtils<br>~~Zip~~*|
53+
|**RadWordsProcessing**|Documents.Core<br>Documents.Fixed<br>Documents.Flow<br>Documents.Flow.FormatProviders.Pdf<br>Documents.ImageUtils<br>Documents.Flow.FormatProviders.Doc<br>Documents.DrawingML<br>~~Zip~~*|
5454

55+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
5556
5657
## See Also
5758

libraries/radpdfprocessing/cross-platform/overview.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,9 @@ In order to use the model of the **RadPdfProcessing** library in your cross-plat
2121

2222
* **Telerik.Documents.Core.dll**
2323
* **Telerik.Documents.Fixed.dll**
24-
* **Telerik.Zip.dll**
24+
* ~~Telerik.Zip.dll~~*
25+
26+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
2527
2628
To export images different than Jpeg and Jpeg2000 or ImageQuality different than High you will need to add references to the following **.Net Standard** assembly:
2729

libraries/radpdfprocessing/formats-and-conversion/ocr/prerequisites.md

-4
Original file line numberDiff line numberDiff line change
@@ -42,10 +42,6 @@ In order to use the **OcrFormatProvider** you need to add the following assembli
4242
<td><b>Telerik.Windows.Documents.Fixed.FormatProviders.Ocr</b></td>
4343
<td><b>Telerik.Documents.Fixed.FormatProviders.Ocr</b></td>
4444
</tr>
45-
<tr>
46-
<td><b>Telerik.Windows.Zip</b></td>
47-
<td><b>Telerik.Zip</b></td>
48-
</tr>
4945
</tr>
5046
<tr>
5147
<td colspan="2">&nbsp;</td>

libraries/radpdfprocessing/formats-and-conversion/pdf/pdfformatprovider/pdfformatprovider.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,9 @@ In order to use the format provider, you need to add references to the following
1818

1919
* Telerik.Windows.Documents.Core.dll
2020
* Telerik.Windows.Documents.Fixed.dll
21-
* Telerik.Windows.Zip.dll
21+
* ~~Telerik.Windows.Zip.dll~~*
2222

23+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
2324
2425
The PdfFormatProvider class of RadPdfProcessing is located in the **Telerik.Windows.Documents.Fixed.FormatProviders.Pdf** namespace.
2526

libraries/radpdfprocessing/getting-started.md

-4
Original file line numberDiff line numberDiff line change
@@ -36,10 +36,6 @@ In order to use the __RadPdfProcessing__ library in your project, you need to ad
3636
<td><b>Telerik.Windows.Documents.Fixed.dll</b></td>
3737
<td><b>Telerik.Documents.Fixed.dll</b></td>
3838
</tr>
39-
<tr>
40-
<td><b>Telerik.Windows.Zip.dll</b></td>
41-
<td><b>Telerik.Zip.dll</b></td>
42-
</tr>
4339
<tr>
4440
<td colspan="2">&nbsp;</td>
4541
</tr>

libraries/radspreadprocessing/cross-platform-support/cross-platform.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,11 @@ To use the model of **RadSpreadProcessing** in your cross-platform project, you
2828
| **Telerik.Documents.Spreadsheet.FormatProviders.Xls.dll** | Required for working with XLS files. |
2929
| **Telerik.Documents.Fixed.dll** | Required for exporting to PDF files. |
3030
| **Telerik.Documents.Spreadsheet.FormatProviders.Pdf.dll** | Required for exporting to PDF files. |
31-
| **Telerik.Zip.dll** | Required for working with XSLX, XLS and PDF files. |
31+
| ~~Telerik.Zip.dll~~* | ~~Required for working with XSLX, XLS and PDF files.~~ |
3232
| **Telerik.Documents.ImageUtils.dll** <br><sub>_This assembly is not available in UI for Xamarin._</sub> | Required when you need to export to PDF documents containing images different than **Jpeg** and **Jpeg2000** or **ImageQuality** different than High. |
3333

34+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
35+
3436
>note The **Telerik.Documents.ImageUtils.dll** assembly depends on **SkiaSharp**. In order to use this assembly, you will need to add a reference to [SkiaSharp](https://www.nuget.org/packages/SkiaSharp/). With the [R2 2023 changes](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/changes-and-backward-compatibility/backward-compatibility#whats-different-in-2023-r2) SkiaSharp replaced ImageSharp as the required dependency.
3537
3638
> Note that for .NET Framework, {{site.dotnetversions}} with Windows Compatibility Pack projects, the references contain "Windows" in their names (e.g. **Telerik.Windows.Documents.Core.dll**)

libraries/radspreadprocessing/formats-and-conversion/general-information.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,9 @@ Unlike the __CsvFormatProvider__, __TxtFormatProvider__ and __DataTableFormatPro
113113

114114
- **XlsxFormatProvider** and **XlsmFormatProvider** additional assembly references
115115
* Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.dll
116-
* Telerik.Windows.Zip.dll
116+
* ~~Telerik.Windows.Zip.dll~~*
117+
118+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
117119
118120
- **PdfFormatProvider**
119121
* Telerik.Windows.Documents.Spreadsheet.FormatProviders.Pdf.dll

libraries/radspreadprocessing/formats-and-conversion/import-and-export-to-excel-file-formats/xlsm/xlsmformatprovider.md

+2-5
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,10 @@ __XlsmFormatProvider__ makes it easy to import and export Xlsm (Excel Workbook t
1717
> Currently the Macros are only preserved during import and export. They cannot be executed or changed in the code.
1818
1919
>Unlike the CSV and TXT format providers, the __XlsmFormatProvider__ requires references to the following assemblies:
20-
21-
2220
>* Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.dll
21+
>* ~~Telerik.Windows.Zip.dll~~*
2322
24-
25-
>* Telerik.Windows.Zip.dll
26-
23+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
2724
2825
Once you reference the aforementioned assemblies, you need to create an instance of the __XlsmFormatProvider__ in order to import and export Xlsm (Excel Workbook) files. This provider appears in the Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.Xlsm namespace. __XlsmFormatProvider__ implements the __IWorkbookFormatProvider__ interface, which in turn appears in the Telerik.Windows.Documents.Spreadsheet.FormatProviders. Depending on the whether you would like to work with the concrete class or the interface, you would need to include either the first or both namespaces.
2926

libraries/radspreadprocessing/formats-and-conversion/import-and-export-to-excel-file-formats/xlsx/xlsxformatprovider.md

+4-7
Original file line numberDiff line numberDiff line change
@@ -15,14 +15,11 @@ position: 2
1515
__XlsxFormatProvider__ makes it easy to import and export XLSX (Excel Workbook) files. An XLSX file is a group of zipped files that conform to the Office Open XML schema. That said, the format allows you export all parts of a workbook: worksheets, formula values, formatting, hyperlinks, etc.
1616

1717

18-
>Unlike the CSV and TXT format providers, the __XlsxFormatProvider__ requires references to the following assemblies:
19-
20-
21-
>* Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.dll
22-
18+
>Unlike the CSV and TXT format providers, the __XlsxFormatProvider__ requires references to the following assemblies:
19+
>* Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.dll
20+
>* ~~Telerik.Windows.Zip.dll~~*
2321
24-
>* Telerik.Windows.Zip.dll
25-
22+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
2623
2724
Once you reference the aforementioned assemblies, you need to create an instance of the __XlsxFormatProvider__ in order to import and export XLSX (Excel Workbook) files. This provider appears in the Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.Xlsx namespace. __XlsxFormatProvider__ implements the __IWorkbookFormatProvider__ interface, which in turn appears in the Telerik.Windows.Documents.Spreadsheet.FormatProviders. Depending on the whether you would like to work with the concrete class or the interface, you would need to include either the first or both namespaces.
2825

libraries/radspreadprocessing/getting-started.md

-5
Original file line numberDiff line numberDiff line change
@@ -68,11 +68,6 @@ In order to use the model of the __RadSpreadProcessing__ library in your project
6868
<td><b>Telerik.Documents.Fixed.dll</b></td>
6969
<td>Required when exporting to PDF.</td>
7070
</tr>
71-
<tr>
72-
<td><b>Telerik.Windows.Zip.dll</b></td>
73-
<td><b>Telerik.Zip.dll</b></td>
74-
<td>Required for working with XLSX, XLS and PDF files.</td>
75-
</tr>
7671
<tr>
7772
<td><b>-</b></td>
7873
<td>

libraries/radspreadstreamprocessing/getting-started.md

-4
Original file line numberDiff line numberDiff line change
@@ -37,10 +37,6 @@ In order to use **RadSpreadStreamProcessing** in your project, you will need to
3737
<td><b>Telerik.Documents.SpreadsheetStreaming.dll</b></td>
3838
<td><b>Telerik.Documents.SpreadsheetStreaming.dll</b></td>
3939
</tr>
40-
<tr>
41-
<td><b>Telerik.Windows.Zip.dll</b></td>
42-
<td><b>Telerik.Zip.dll</b></td>
43-
</tr>
4440
<tr>
4541
<td colspan="2">&nbsp;</td>
4642
</tr>

libraries/radwordsprocessing/cross-platform.md

-4
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,6 @@ To use the model of the **RadWordsProcessing** library in your cross-platform pr
3434
<td><b>Telerik.Documents.Flow.dll</b></td>
3535
<td></td>
3636
</tr>
37-
<tr>
38-
<td><b>Telerik.Zip.dll</b></td>
39-
<td>Required when working with DOCX, DOC, DOT or PDF.</td>
40-
</tr>
4137
<tr>
4238
<td><b>Telerik.Documents.Flow.FormatProviders.Doc.dll</b></td>
4339
<td>Required when importing from DOC or DOT files.</td>

libraries/radwordsprocessing/formats-and-conversion/pdf/pdfformatprovider.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,12 @@ All you have to do in order to use __PdfFormatProvider__ is add references to th
1616

1717
* Telerik.Windows.Documents.Core.dll
1818
* Telerik.Windows.Documents.Flow.dll
19-
* Telerik.Windows.Zip.dll
19+
* ~~Telerik.Windows.Zip.dll~~*
2020
* Telerik.Windows.Documents.Flow.FormatProviders.Pdf.dll
2121
* Telerik.Windows.Documents.Fixed.dll
2222

23+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
24+
2325
## Export
2426

2527
In order to export a document to PDF you need to use the __Export()__ method of __PdfFormatProvider__.

libraries/radwordsprocessing/formats-and-conversion/word-file-formats/docx/docxformatprovider.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,9 @@ All you have to do in order to use __DocxFormatProvider__ is add references to t
2323

2424
* Telerik.Windows.Documents.Core.dll
2525
* Telerik.Windows.Documents.Flow.dll
26-
* Telerik.Windows.Zip.dll
26+
* ~~Telerik.Windows.Zip.dll~~*
2727

28+
>note *As of **Q2 2025** the Zip Library will no longer be used as an internal dependency in the rest of the Document Processing Libraries - PdfProcessing, WordsProcessing, SpreadProcessing, SpreadStreamProcessing. It will be replaced by the System.IO.Compression. We will continue to ship the Telerik Zip Library as a standalone library so clients can still use it separately.
2829
2930
## Import
3031

libraries/radwordsprocessing/getting-started.md

-4
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,6 @@ Here is a list of assemblies that contain the __RadWordsProcessing__ functionali
4545
<td><b>Telerik.Windows.Documents.DrawingML.dll</b></td>
4646
<td><b>Telerik.Documents.DrawingML.dll</b></td>
4747
</tr>
48-
<tr>
49-
<td><b>Telerik.Windows.Zip.dll</b></td>
50-
<td><b>Telerik.Zip.dll</b></td>
51-
</tr>
5248
<tr>
5349
<td colspan="2">&nbsp;</td>
5450
</tr>

0 commit comments

Comments
 (0)