iOS framework 5

5.0.0-rc.1 (2025-11-14)

API Docs

These release notes describe the changes since version 4.6.1.

New features

• Added the new renderer ContinuousScrollRenderer that shows all documents in a single vertical scrolling view.

• Added a new event listener for the ReaderView, OnReadingAreaRangeChangedListener, which you can use to get notified when the reading area range changes. You can retrieve the updated value using the new property, ReaderView.readingAreaRange. Note that for paginated renderers the reading area range is the same as the visible range.

  • Note: We have marked ReaderView.readingAreaRange and its corresponding listener OnReadingAreaRangeChangedListener as experimental APIs as we may change the definition of the Reading Area based on your feedback.

• Added a new ReaderView.goTo() option scrollRendererScrollBehavior to control how scroll renderers behave when the target position is already visible in the ReaderView.

• Scroll renderers can now smoothly scroll to nearby positions. The duration of the smooth scrolling can be controlled with the renderer options scrollAnimationDurationMs and scrollAnimationMaxDistance. Please refer to the API documentation for more information.

• Added a new listener method, OnRendererScrollEventListener.onRendererScrollChanged(event:), which is called continuously while scroll renderers are scrolling.

• Changed the OnRendererScrollEventListener.onRendererScrollStarted(event:) parameter type to RendererScrollEngineEventData. It is now possible to determine whether scrolling was initiated by the user by inspecting the userGenerated property.

• Added a new renderer option swipeNavigationGestureThreshold. This option can be used to configure the swipe distance required to perform a swipe navigation. Additionally, swipe animations have been refined to start more smoothly.

• Added ReaderViewScrollByOptions argument to ReaderView.scrollBy(length:options) . When the option setReadingPositionToReadingAreaStart is set to true, the reading position moves to the start of the new Reading Area after scrolling, instead of staying until it leaves the visible range. This is now the default behavior of scrollBy().

• Added support for EPUB switch/case elements.

Breaking changes

• Bumped minimum iOS version to iOS 15

• Reordered initializer arguments alphabetically in all Renderer options:

  • FlipBookRendererOptions

  • SingleDocumentScrollRendererOptions

  • SinglePageSwipeRendererOptions

  • SpreadSwipeRendererOptions

  • StackRendererOptions

• All async interactions that communicate with the web view are now @MainActor isolated

• The ContainerContentBlockType enum entry .MATHML_SUB_SUPERSCRIPT was renamed to MATHML_SUBSUP_SCRIPT to be consistent with its value.

Changes to default options

• EpubReaderPublicationOptions.documentSectioningOptions.enabled has changed from false to true.

• ReaderViewOptions.pageProgressionTimelineOptions.enabled has changed from true to false.

• ReaderPublicationOptions.reflowOptions.unforcedTextBreak.widows.minLines has changed from 3 to 2.

If you are using PageProgressionTimeline, in addition to enabling it, you must also:

• Set EpubReaderPublicationOptions.documentSectioningOptions.enabled to false

or

• Set ReaderViewOptions.pageProgressionTimelineOptions.forceCompleteRendition to true

Removed old deprecated types and members

• ColibrioAudioPlayer.setMediaSessoinMetaData(mediaSessionMetadata:)

  • Use setter on ColibrioAudioPlayer.mediaSession.metaData

• ColibrioAudioPlayer.setMediaCommands(mediaCommands:)

  • Use setter on ColibrioAudioPlayer.mediaSession.mediaCommands

• typealias FetchNavigationItemReferencesResultData

  • Use FetchNavigationItemReferencesResult

• typealias ReaderPublicationNavigationData

  • Use ReaderPublicationNavigation

• typealias ReaderPublicationNavigationCollectionData

  • Use ReaderPublicationNavigationCollection

• typealias ReaderPublicationNavigationItemData

  • Use ReaderPublicationNavigationItem

• typealias ReaderPublicationNavigationItemReferenceData

  • Use ReaderPublicationNavigationItemReference

• typealias ColibrioView

  • Use ColibrioReadingSystemView

• SyncMediaPlayer.approximateElapsedTime

  • Use SyncMediaPlayer.approximateElapsedTimeMs

• SyncMediaPlayer.playing

  • Use !(SyncMediaPlayer.paused) && (SyncMediaPlayer.ready)

• typealias VisiblePageData

  • Use VisiblePage

• ReaderView.fetchRectsForVisibleContent(visiblePage:locator:options:completion)

  • Use VisiblePage.fetchRectsForVisibleContent(locator:options:completion:)

• ReaderView.fetchRectsForVisibleContent(visiblePage:locator:options) async

  • Use VisiblePage.fetchRectsForVisibleContent(locator:options:) async

• ReaderView.syncMediaPlayer (set)

  • Use ReaderView.setSyncMediaPlayer(syncMediaPlayer:initialSyncMethod:)

• ReadingSystemEngine.addOnLicenseEventListener(_:)

  • Use ColibrioReaderFramework.addOnLicenseEventListener(_:)

• ReadingSystemEngine.removeOnLicenseEventListener(_:)

  • Use ColibrioReaderFramework.removeOnLicenseEventListener(_:)

• ReadingSystemEngine.createZipResourceProvider(dataSource:options:completion)

  • Use ZipResourceProvider.create(dataSource:zipResourceProviderOptions:)

• ReadingSystemEngine.createZipResourceProvider(dataSource:options:) async

  • Use ZipResourceProvider.create(dataSource:zipResourceProviderOptions:) async

• ZipResourceProvider.create(dataSource:serializedZipArchiveInformation:chunkCacheSize:completion)

  • Use ZipResourceProvider.create(dataSource:zipResourceProviderOptions:)

Improvements

• Most data types now conform to the Sendable protocol.

Deprecations

• Deprecated ignoreAspectRatio in all renderer options. Use ReaderView.options.contentDisplayAreaOptions instead.

Bugfixes

• Fixed an issue with pinch-zooming in PDFs containing many links. Previously, if one finger was on a link, pinch-zooming failed.

• Fixed an issue with publication CSS stylesheets not working on iOS 26.2 Beta 2.