Breaking Changes in Version 15.0.0
This article lists the breaking changes introduced with the Telerik UI for .NET MAUI 15.0.0 release version.
Document Processing Libraries
All namespaces of the Telerik Document Processing Libraries are renamed from Telerik.Windows.Documents.* to Telerik.Documents.*. The assembly names are not changed, so you don't have to update any package or assembly references. However, you must update every using directive, fully qualified type name, and XAML clr-namespace mapping that points to the old namespaces.
This change affects the PdfViewer control, as well as the Document Processing Libraries(slug://document-processing-libraries-overview)—PdfProcessing, WordsProcessing, and SpreadProcessing. The SpreadStreamProcessing library is not affected because it already uses the Telerik.Documents.SpreadsheetStreaming namespaces.
The following table lists the renamed namespaces:
| Old Namespace | New Namespace |
|---|---|
Telerik.Windows.Documents.Common.FormatProviders | Telerik.Documents.Common.FormatProviders |
Telerik.Windows.Documents.Core.* | Telerik.Documents.Core.* |
Telerik.Windows.Documents.Extensibility | Telerik.Documents.Extensibility |
Telerik.Windows.Documents.Fixed.* | Telerik.Documents.Fixed.* |
Telerik.Windows.Documents.Flow.* | Telerik.Documents.Flow.* |
Telerik.Windows.Documents.Spreadsheet.* | Telerik.Documents.Spreadsheet.* |
Telerik.Windows.Documents.Primitives | Telerik.Documents.Primitives |
Telerik.Windows.Documents.Utilities | Telerik.Documents.Utilities |
For example, update the using directives in your C# code:
// Old
using Telerik.Windows.Documents.Fixed.Model;
using Telerik.Windows.Documents.Fixed.Search;
// New
using Telerik.Documents.Fixed.Model;
using Telerik.Documents.Fixed.Search;
And update the clr-namespace mappings in your XAML:
<!-- Old -->
xmlns:telerikTextSearch="clr-namespace:Telerik.Windows.Documents.Fixed.Search;assembly=Telerik.Documents.Fixed"
<!-- New -->
xmlns:telerikTextSearch="clr-namespace:Telerik.Documents.Fixed.Search;assembly=Telerik.Documents.Fixed"
PdfViewer
The names and the signatures of the PdfViewer members are not changed, but the following members expose types from the Document Processing Libraries, so the namespaces of these types change as described in the Document Processing Libraries section:
| Member | Affected Type |
|---|---|
RadPdfViewer.Document | RadFixedDocument |
RadPdfViewer.SourcePasswordNeeded and DocumentSource.PasswordNeeded | PasswordNeededEventArgs |
PageElementsLoadedEventArgs.Page | RadFixedPage |
LinkAnnotationTappedEventArgs.LinkAnnotation | Link |
FixedDocumentSource constructor and implicit operators, DocumentSource implicit operator | RadFixedDocument |
PdfViewerSearchSettings.SearchOptions and PdfViewerSearchSettings.SearchAsync | TextSearchOptions |
PdfViewerTextSearchResult.SearchResults and PdfViewerTextSearchResult.MainSearchResult | SearchResult |
PdfViewerSearchContext public fields and constructors | RadFixedDocument, TextSearchOptions |
PdfViewerTextSearchWorker overridable members | RadFixedDocument, TextSearchOptions, SearchResult |
Applications that are compiled against an earlier version of the Document Processing Libraries must be rebuilt against the new version.