202310.4.0

This release contains the following visible changes. Note about version numbering: The previous version, 2023.01.0.0, had a version number that didn't reflect its content, due to it being a late fix to a badly built earlier version. That's the reason this changelog includes some version numbers in the 2022 range.

• 202309.44: Don’t ask for a token when editions are marked as free (API Change) (#2861)
  • Improved error reporting from editionDidFailDownload. See DownloadError documentation for details.
• 202309.13: Fix publication date for podcast episodes (#2852)
• 202309.12: The SDKs now have a privacy manifest and a code signature (#2847)
• 202309.7: Remove needless token requests when dealing with free audio (#2844)
• 202308.23: Fix a crash in CoverProvider.getCover (#2834)
• 202301.27: Fix image size comparisons in covers cache. (#2567)
• 202301.23: Fix puzzle storage with identical identifiers (#2558)
• 202212.20: Adopt SQLite based editions catalogs (#2508)
  • Deep API change, we're now using Edition objects instead of UUIDs. Also changes to how editions are queried.
• 202211.24: Improve audio player behaviour in poor network conditions (#2484)

202301.0.0

• Fixed framework builds.

If you are using 202210.22.0, please update to this version as soon as possible.

202210.22.0

NOTE: Use 202301.0.0 or later instead.

• Fixed EditionCoverProvider API by making CoverProviderError public.

202210.16.0

Richie SDKs Release. API improvements:

• Replace the API to access editions covers, instead of URLs it provides now UIImages and it uses and internal cache that enables offline mode support. (#2431)

202210.14.0

Richie SDKs Release

202208.42

This is essentially the same as 202208.39, but with fixed podspec file names.

202208.39

Richie SDKs Release. This version is available also as a Swift package! See Package.swift in this repository. Changes:

• 202208.30: Fix player dark mode (#2382)

• 202208.29: Use position syncing to determine UI values in the library view (#2379)

• 202208.2: Optimize handing of unchanged editions feeds (#2354)

• 202206.35/202206.54: Fix crash in MaggioMultiAnalytics (#2339)

• 202206.28: Dark mode updates (#2325, changes public BookViewDisplayConfig)

• 202206.18: Miniplayer for top bar (#2319)

• 202205.53: Top bar podcast action (#2304)

• 202205.47: Top bar to podcast series and episode views (#2298)

• 202205.38: Fix podcasts front page rotation (#2290)

• 202205.35: Add status bar background (#2289, adds a new option in public BookViewDisplayConfig)

• 202205.26: MP3 offline support (#2280)

• 202205.25: Update podcast views (#2279)

• 202205.11: Views and a whole lot of background stuff for podcasts (#2268)

• 202204.15: Add remote reporter events for error alerts (#2254)

• 202204.14: Fix newly added books not appearing in reading list (#2250)

• 202203.35: Remove MaggioProductsType (#2228)

• 202203.32: Fix position sync logic (#2227)

• 202203.28: Minimal book feeds (#2222)

• 202202.10: Fix editable playlist issues (#2183)

• 202202.8: Ensure we don't use thumbnails as final page images (#2180)

• 202202.5: Fix faulty listening position crash (#2178)

• 202202.4: Fix entitlements handling crash (#2176)

• 202201.23: Added two new analytics attributes: DynamicTypeCategory & ApplicationAge (#2160)

202201.16

This release fixes SDK usage on iOS 12 simulator.

202201.15: Fix running SDK apps in iOS 12 simulator. Specify iOS 12 in the podspec. (#2159)
202201.7: Fix crash: NSInvalidArgumentException in +[MaggioPageView _reportContextForPage:startTime:]
202112.7: Books: Add support for per-track cover art (#2127)

202111.47

We have received reports of problems where editions pages do not load a full-resolution version. We haven't been able to reproduce this, but we would highly recommend that you throughly test the portions of your apps that display editions when upgrading to this version of the SDK, and contact us if you see any blurry rendering.

Changes since the previous release:

• 202111.39: Books: Improve scrolling by optimizing book cover shadows (#2109)
• 202111.38: Editions: Add an API for opening an edition by a given page (#2105)
• 202111.27: Books: Show playlist action feedback with toast notifications (#2100)
• 202111.9: Fix books library tab bar appearance on iOS 15 (#2088)
• 202111.8: Books: Show composed, lyrics, and arranged by metadata in track details view (#2087)
• 202111.4: Fix iCloud user defaults related problems by removing the unused code (#2082)
• 202110.53: Books: Improve scrolling frame rate in books list when download indicating icons aren't needed (#2076)
• 202110.41: Books: Add public api function to get book info (#2065)
• 202110.40: Books: Added support for unencrypted HLS audio. (#2064)
• 202110.37: Books editable playlists: Offline support (#2057)
• 202110.14: Books: Add support for editable playlists (#2038)
• 202109.15: Books: Fix asset urls getting incorrectly overwritten (#2013)
• 202109.2: Books: Let track have multiple album/playlist guids (#2002)
• 202108.43: Add IssueContentPageNumber analytics parameter. This is a breaking change: MaggioIssueNavigationListener methods are now all required, and two methods got one new parameter each. (#1997)
• 202108.34: Fix hidden navigation bar handling in books library (#1989)
• 202108.29: Books: Fix crash caused by race condition concerning album states (#1984)
• 202107.9: Optimize books feed parsing speed (#1962)
• 202107.7: Fix crash caused by bad JWT handling (#1960)
• 202106.20: Fix blurry zoom in editions (#1950)
• 202106.14: Books: Alert user if audio content cannot be processed (#1945)
• 202106.12: Books: Add support for HLS and FairPlay (#1944)
• 202106.2: Books: Sort the feed's books by publication date, newest first (#1935)
• 202105.10: Books: Fix feed text color override for single podcast picks (#1910)
• 202104.48: Add support for related recommendations to book details view (#1899)
• 202104.15: Support for "lite" compositions on the book details view (#1869)

202101.35

Richie SDKs Release

This is our first XCFramework release. It also turns on BUILD_LIBRARY_FOR_DISTRIBUTION, meaning that it should be compatible with future Swift compilers, too.

Note that a side effect of BUILD_LIBRARY_FOR_DISTRIBUTION is that Swift considers most of the enums exposed in API to be open, so you need to specify an @unknown case in switch statements.

The dSYMs package was constructed afterwards and might not exactly match the SDK package due to differences in environment. Sorry about that; the next releases should have dSYMs that are gathered from the same compilation run as the libraries.

202101.31: Integrate RichieLogging into SDK/apps (#1769)
202101.30: Create XCFrameworks (#1762)
202101.21: Add support for books without toc (#1761)
202101.20: Add support for no_ads_after for dynamic ads in maggio (#1760)