v10.42.3

Enhancements

• Update packaging for the Xcode 15.0 release. Carthage release and obj-c
  binaries are now built with Xcode 15.

Fixed

• The prebuilt Realm.xcframework for SPM was packaged incorrectly and did not
  work (#8361, since v10.42.1).

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 15.0.0.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-15.0.0.

v10.42.2

Enhancements

• Add support for logging messages sent by the server. (Core #6476)
• Unknown protocol errors received from the baas server will no longer cause the application to crash if a valid error action is also received. Unknown error actions will be treated as an ApplicationBug error action and will cause sync to fail with an error via the sync error handler. (Core #6885)
• Some sync error messages now contain more information about what went wrong.

Fixed

• The MultipleSyncAgents exception from opening a synchronized Realm in multiple processes at once no longer leaves the sync client in an invalid state. (Core #6868, since v10.36.0)
• Testing the size of a collection of links against zero would sometimes fail (sometimes = "difficult to explain"). In particular: (Core #6850, since v10.41.0)
• When async writes triggered a file compaction some internal state could be corrupted, leading to later crashes in the slab allocator. This typically resulted in the "ref + size <= next->first" assertion failure, but other failures were possible. Many issues reported; see Core #6340. (since 10.35.0)
• Realm.Configuration.maximumNumberOfActiveVersions now handles intermediate versions which have been cleaned up correctly and checks the number of live versions rather than the number of versions between the oldest live version and current version (since 10.35.0).
• If the client disconnected between uploading a change to flexible sync subscriptions and receiving the new object data from the server resulting from that subscription change, the next connection to the server would sometimes result in a client reset (Core #6966, since v10.21.1).

Deprecations

• RLMApp has localAppName and localAppVersion fields which never ended up being used for anything and are now deprecated.
• RLMSyncAuthError has not been used since v10.0.0 and is now deprecated.

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.1.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-15 beta 7.

Internal

• Upgraded realm-core from 13.17.1 to 13.20.1

v10.42.1

Fixed

• The names of the prebuilt zips for SPM have changed to avoid having Carthage download them instead of the intended Carthage zip (#8326, since v10.42.0).
• The prebuild Realm.xcframework for SwiftPM now has all platforms other than visionOS built with Xcode 14 to comply with app store rules (#8339, since 10.42.0).
• Fix visionOS compilation with Xcode beta 7.

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.1.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-15 beta 7.

v10.42.0

Enhancements

• Add support for building for visionOS and add Xcode 15 binaries to the release package. visionOS currently requires installing Realm via either Swift Package Manager or by using a XCFramework as CocoaPods and Carthage do not yet support it.
• Zips compatible with SPM's .binaryTarget() are now published as part of the releases on Github.
• Prebuilt XCFrameworks are now built with LTO enabled. This has insignificant performance benefits, but cuts the size of the library by ~15%.

Fixed

• Fix nested properties observation on a Projections not notifying when there is a property change. (#8276, since v10.34.0).
• Fix undefined symbol error for UIKit when linking Realm to a framework using SPM. (#8308, since v10.41.0)
• If the app crashed at exactly the wrong time while opening a freshly compacted Realm the file could be left in an invalid state (Core #6807, since v10.33.0).
• Sync progress for DOWNLOAD messages was sometimes stored incorrectly, resulting in an extra round trip to the server. (Core #6827, since v10.31.0)

Breaking Changes

• Legacy non-xcframework Carthage installations are no longer supported. Please ensure you are using --use-xcframeworks if installing via Carthage.

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.1.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-15 beta 5.

Internal

• Upgraded realm-core from 13.17.0 to 13.17.1
• Release packages were being uploaded to several static.realm.io URLs which are no longer linked to anywhere. These are no longer being updated, and release packages are now only being uploaded to Github.

v10.41.1

Enhancements

• Filesystem errors now include more information in the error message.
• Sync connection and session reconnect timing/backoff logic has been reworked and unified into a single implementation. Previously some categories of errors would cause an hour-long wait before attempting to reconnect, while others would use an exponential backoff strategy. All errors now result in the sync client waiting for 1 second before retrying, doubling the wait after each subsequent failure up to a maximum of five minutes. If the cause of the error changes, the backoff will be reset. If the sync client voluntarily disconnects, no backoff will be used. (Core #6526)

Fixed

• Removed warnings for deprecated APIs internal use. (#8251, since v10.39.0)
• Fix an error during async open and client reset if properties have been added to the schema. This fix also applies to partition-based to flexible sync migration if async open is used. (Core #6707, since v10.28.2)

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.1.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-15 beta 4.

Internal

• Upgraded realm-core from 13.15.1 to 13.17.0
• The location where prebuilt core binaries are published has changed slightly. If you are using REALM_BASE_URL to mirror the binaries, you may need to adjust your mirroring logic.
• Release packages were being uploaded to several static.realm.io URLs which are no longer linked to anywhere. These are no longer being updated, and release packages are now only being uploaded to Github.

v10.41.0

Enhancements

• Add support for multiplexing sync connections. When enabled (the default), a single connection is used per sync user rather than one per synchronized Realm. This reduces resource consumption when multiple Realms are opened and will typically improve performance (PR #8282).
• Sync timeout options can now be set on RLMAppConfiguration along with the other app-wide configuration settings (PR #8282).

Fixed

• Import as RLMRealm_Private.h as a module would cause issues when using Realm as a subdependency. (#8164, since 10.37.0)
• Disable setting a custom logger by default on the sync client when the sync manager is created. This was overriding the default logger set using RLMLogger.defaultLogger. (since v10.39.0).

Breaking Changes

• The RLMSyncTimeouts.appConfiguration property has been removed. This was an unimplemented read-only property which did not make any sense on the containing type (PR #8282).

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.1.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-15 beta 2.

Internal

• Upgraded realm-core from 13.15.0 to 13.15.1

v10.40.2

Enhancements

• Actor.preconditionIsolated() is now used for runtime actor checking when available (i.e. building with Xcode 15 and running on iOS 17) rather than the less reliable workaround.

Fixed

• If downloading the fresh Realm file failed during a client reset on a flexible sync Realm, the sync client would crash the next time the Realm was opened. (Core #6494, since v10.28.2)
• If the order of properties in the local class definitions did not match the order in the server-side schema, the before-reset Realm argument passed to a client reset handler would have an invalid schema and likely crash if any data was read from it. (Core 6693, since v10.40.0)

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.1.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-15 beta 1.

Internal

• Upgraded realm-core from 13.13.0 to 13.15.0.
• The prebuilt library used for CocoaPods installations is now built with Xcode 14. This should not have any observable effects other than the download being much smaller due to no longer including bitcode.

v10.40.1

Enhancements

• Fix compilation with Xcode 15. Note that iOS 12 is the minimum supported
  deployment target when using Xcode 15.
• Switch to building the Carthage release with Xcode 14.3.1.

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.1.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-15 beta 1.

Internal

• Overhauled SDK metrics collection to better drive future development efforts.

v10.40.0

Drop support for Xcode 13 and add Xcode 14.3.1. Xcode 14.1 is now the minimum supported version.

Enhancements

• Adjust the error message for private Object subclasses and subclasses nested inside other types to explain how to make them work rather than state that it's impossible. (#5662).
• Improve performance of SectionedResults. With a single section it is now ~10% faster, and the runtime of sectioning no longer scales significantly with section count, giving >100% speedups when there are large numbers of sections (Core #6606).
• Very slightly improve performance of runtime thread checking on the main thread. (Core #6606)

Fixed

• Allow support for implicit boolean queries on Swift's Type Safe Queries API (#8212).
• Fixed a fatal error (reported to the sync error handler) during client reset or automatic partition-based to flexible sync migration if the reset has been triggered during an async open and the schema being applied has added new classes. Due to this bug automatic flexibly sync migration has been disabled for older releases and this is now the minimum version required. (#6601, since automatic client resets were introduced in v10.25.0)
• Dictionaries sometimes failed to map unresolved links to nil. If the target of a link in a dictionary was deleted by another sync client, reading that field from the dictionary would sometimes give an invalid object rather than nil. In addition, queries on dictionaries would sometimes have incorrect results. (Core #6644, since v10.8.0)
• Older versions of Realm would sometimes fail to properly mark objects as being the target of an incoming link from another object. When this happened, deleting the target object would hit an assertion failure due to the inconsistent state. We now reconstruct a valid state rather than crashing. (Core #6585, since v5.0.0)
• Fix several UBSan failures which did not appear to result in functional bugs (Core #6649).
• Using both synchronous and asynchronous transactions on the same thread or scheduler could hit the assertion failure "!realm.is_in_transaction()" if one of the callbacks for an asynchronous transaction happened to be scheduled during a synchronous transaction (Core #6659, since v10.26.0)
• The stored deployment location for Apps was not being updated correctly after receiving a redirect response from the server, resulting in every connection attempting to connect to the old URL and getting redirected rather than only the first connection after the deployment location changed. (Core #6630, since v10.38.2)

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.
• CocoaPods: 1.10 or later.
• Xcode: 14.1-14.3.1.

Internal

• Upgraded realm-core from 13.10.1 to 13.13.0.

v10.39.1

Enhancements

• New notifiers can now be registered in write transactions until changes have
  actually been made in the write transaction. This makes it so that new
  notifications can be registered inside change notifications triggered by
  beginning a write transaction (unless a previous callback performed writes).
  (#4818).
• Reduce the memory footprint of an automatic (discard or recover) client reset
  when there are large incoming changes from the server.
  (Core #6567).

Compatibility

• Realm Studio: 14.0.1 or later.
• APIs are backwards compatible with all previous releases in the 10.x.y series.
• Carthage release for Swift is built with Xcode 14.3.
• CocoaPods: 1.10 or later.
• Xcode: 13.4-14.3.

Internal

• Upgraded realm-core from 13.10.0 to 13.10.1.