Richie iOS SDK Changelog

Changes in the Richie iOS SDK, not limited to Editions

Richie iOS SDK releases can be found at richiefi/richiesdk-ios.

The version numbering scheme is YYYYYMM.X.Y, where YYYYMM indicates year and month, X is an incrementing number starting from zero at the start of the month indicating change ordering and Y is patch level and usually expected to be 0. Each release lists the changes it includes that are relevant to SDK users and those change lines start with the version number for that change.

202406.40.0 (2024-06-25)

  • 202406.39: Fix a crash with the old reader. The crash was introduced in version 202406.7.

202406.25.0 (2024-06-17)

This version fixes ad preloading in the editions reader, changes how editions zooming behaves and (mostly) replaces the public interface of analytics.

  • 202406.24: Render new zoomed images when editions zoom changes and modify the default zoom to use UIApplication.shared.preferredContentSizeCategory.
  • 202406.14: Add new analytics interface, RichieAnalytics, and move the kMaggioAnalytics_X constants into RichieAnalyticsEvent and RichieAnalyticsAttribute types.
  • 202405.37: Fix ads not being preloaded in the editions reader and remove ad preloading limitations.

202405.15.0 (2024-05-20)

This SDK release contains couple of internal improvements & a new feature for app-specific data hosts. No Public API changes.

Custom Host Name Configuration

Richie SDK-based applications now support the configuration of an app-specific host name, replacing the default data.richie.app domain for fetching app content, including configurations and Editions issues. Set the RichieAppDataHost key in Info.plist of the host app to the app-specific hostname which has been coordinated with Richie.

Updated Pinned Certificates

This release includes an updated set of pinned Richie certificates. These updates are essential to maintain the seamless functionality of Richie SDK-based applications moving forward.

If you have already adopted the previous SDK version 202404.11.0 then it's important that you'll update to this SDK version before August 2024.


  • 202405.11: Update the list of pinned Richie certificates
  • 202404.33: Add check for free disk space before downloading edition. Add accessed API information (NSPrivacyAccessedAPICategoryDiskSpace) to the privacy manifest.
  • 202404.29: Add Richie App Data Host customization support. By setting the RichieAppDataHost key in host app Info.plist to the app-specific host name all requests to Richie app data backend will be done to that hostname instead of the default data.richie.app.

202404.11.0 (2024-04-16)

This release fixes issues in the new reader and adds two new interfaces on top of the old functionality: Richie as an entry point to all the sub-SDKs (ads, editions, books) and RichieAdsController as a more modern, limited version of RichieAds. For now these are just facades on the still-available old types and you can adopt them on your own pace.

  • 202404.10: Add some sendability annotations
  • 202404.4: Add an unified SDK factory, Richie. You can use it to create ads, editions and books root objects.
    • The books factory method drops the useCustomTabs parameter that is on the BooksLibraryController constructor because it was being ignored there.
  • 202404.1: Add a new Swifty interface to Ads, RichieAdsController. It forces main actor and hides unused features.
  • 202403.51: Add missing version info to docs
  • 202403.39: Support for tab grouping in books catalog
  • 202403.20: Fix interaction bugs in the editions reader
  • 202403.3: Show numeric keyboard for sudokus
  • 202402.50: Memory usage reduction: clear the editions reader image cache when the app goes to background
  • 202402.35: Fix multicolumn text selection in the editions reader
  • 202402.34: Fix zoom state handling in the editions reader
  • 202402.27: Fix zoom state handling in the editions reader

202402.25.0 (2024-02-15)

The headlining feature of this release is that we have dropped support for iOS 12, 13 and 14. iOS 15 is now the minimum supported version.

  • 202402.21: Remove RichiePushNotification from the SDKs
  • 202402.18: Remove some unwanted symbols from the SDK documentation
  • 202402.16: Fix editions reader losing pinch to zoom after quick spread changes
  • 202402.8: Bump SDK operating system version requirements to iOS 15
  • 202402.4: Add support for double tapping in editions reader crosswords for zooming in
  • 202402.1: Fix a non-portrait book cover sometimes disappearing while scrolling
  • 202401.44: Omit xattrs from SDK documentation archives
  • 202401.42: Expose ObjC in the SDK documentation
  • 202401.41: Deprecate "Organization" and "Product" analytics attributes
  • 202401.38: Use integers for PageViewDuration analytics
  • 202401.36: Fix crosswords content disappearing in the editions reader
  • 202401.34: Fix editions reader opening animation
  • 202401.33: Fix editions reader crossword flashing an blurriness
  • 202401.31: Add search to podcasts
  • 202401.28: Remove user analytics attributes
  • 202401.17: Reduce new reader memory usage
  • 202401.16: Fix keyboard covering crosswords in the new reader
  • 202401.10: Fix flickering ads and zoomed spread visible in grid in the new reader

202312.17.0 (2023-12-21)

  • 202312.17: Fix missing "Did start filling crossword" event in Editions
  • 202312.16: Fix opening animation timing and leaks in the new reader
  • 202311.59: Add opening animation to the new reader
  • 202311.55: Fix missing gesture attribute in new reader analytics page view event
Android SDK Changelog