- None.
- <How to hit and notice issue? what was the impact?> (#????, since v?.?.?)
- None.
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.21.0 or later.
- APIs are backwards compatible with all previous releases in the 3.x.y series.
- Carthage release for Swift is built with Xcode 10.3.
- Add Xcode 10.3 binaries to the release package. Remove the Xcode 9.2 and 9.3 binaries.
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.21.0 or later.
- Carthage release for Swift is built with Xcode 10.3.
- Add support for canceling asynchronous opens using a new AsyncOpenTask returned from the asyncOpen() call. (PR #6913).
- Importing the Realm SPM package can now be done by pinning to a version rather than a branch.
- Queries on a List/RLMArray which checked an indexed int property would sometimes give incorrect results. (#6154), since v3.15.0)
- Queries involving an indexed int property had a memory leak if run multiple times. (#6186), since v3.15.0)
- Creating a subscription with
includeLinkingObjects:performed unneccesary comparisons, making it extremely slow when large numbers of objects were involved. (Core #3311, since v3.15.0)
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.21.0 or later.
- Carthage release for Swift is built with Xcode 10.2.1.
- Add support for including Realm via Swift Package Manager. This currently
requires depending on the branch "master" rather than pinning to a version
(i.e.
.package(url: "https://github.com/realm/realm-cocoa", .branch("master"))). (#6187). - Add Codable conformance to RealmOptional and List, and Encodable conformance to Results. (PR #6172).
- Attempting to observe an unmanaged LinkingObjects object crashed rather than throwing an approriate exception (since v0.100.0).
- Opening an encrypted Realm could potentially report that a valid file was corrupted if the system was low on free memory. (since 3.14.0, Core #3267)
- Calling
Realm.asyncOpen()on multiple Realms at once would sometimes crash due to aFileNotFoundexception being thrown on a background worker thread. (since 3.16.0, ObjectStore #806).
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.21.0 or later.
- Carthage release for Swift is built with Xcode 10.2.1.
- Add support for Xcode 11 Beta 1. Xcode betas are only supported when building from source, and not when using a prebuilt framework. (PR #6164).
- Using asyncOpen on query-based Realms which didn't already exist on the local device would fail with error 214. (#6178, since 3.16.0).
- asyncOpen on query-based Realms did not wait for the server-created permission objects to be downloaded, resulting in crashes if modifications to the permissions were made before creating a subscription for the first time (since 3.0.0).
- EINTR was not handled correctly in the notification worker, which may have
resulted in inconsistent and rare assertion failures in
ExternalCommitHelper::listen()when building with assertions enabled. (PR: #804, since 0.91.0).
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.21.0 or later.
- Carthage release for Swift is built with Xcode 10.2.1.
- The static type passed at compile time to
realm.create()was checked for a primary key rather than the actual type passed at runtime, resulting in exceptions like "''RealmSwiftObject' does not have a primary key and can not be updated'" being thrown even if the object type being created has a primary key. (since 3.16.0, #6159).
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.21.0 or later.
- Carthage release for Swift is built with Xcode 10.2.1.
- Add an option to only set the properties which have values different from the
existing ones when updating an existing object with
Realm.create()/-[RLMObject createOrUpdateInRealm:withValue:]. This makes notifications report only the properties which have actually changed, and improves Object Server performance by reducing the number of operations to merge. (Issue: #5970, PR: #6149). - Using
-[RLMRealm asyncOpenWithConfiguration:callbackQueue:]/Realm.asyncOpen()to open a synchronized Realm which does not exist on the local device now uses an optimized transfer method to download the initial data for the Realm, greatly speeding up the first start time for applications which use full synchronization. This is currently not applicable to query-based synchronization. (PR: #6106).
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.21.0 or later.
- Carthage release for Swift is built with Xcode 10.2.1.
The minimum version of Realm Object Server has been increased to 3.21.0 and attempting to connect to older versions will produce protocol mismatch errors. Realm Cloud has already been upgraded to this version, and users using that do not need to worry about this.
- Add
createdAt,updatedAt,expiresAtandtimeToLiveproperties toRLMSyncSubscription/SyncSubscription. These properties will benilfor subscriptions created with older versions of Realm, but will be automatically populated for newly-created subscriptions. - Add support for transient subscriptions by setting the
timeToLivewhen creating the subscription. The next time a subscription is created or updated after that time has elapsed the subscription will be automatically removed. - Add support for updating existing subscriptions with a new query or limit.
This is done by passing
update: true(in swift) or settingoptions.overwriteExisting = YES(in obj-c) when creating the subscription, which will make it update the existing subscription with the same name rather than failing if one already exists with that name. - Add an option to include the objects from
RLMLinkingObjects/LinkingObjectsproperties in sync subscriptions, similarly to howRLMArray/Listautomatically pull in the contained objects. - Improve query performance for chains of OR conditions (or an IN condition) on an unindexed integer or string property. (Core PR #2888 and Core PR #3250).
- Improve query performance for equality conditions on indexed integer properties. (Core PR #3272).
- Adjust the file allocation algorithm to reduce fragmentation caused by large numbers of small blocks.
- Improve file allocator logic to reduce fragmentation and improve commit performance after many writes. (Core PR #3278).
- Making a query that compares two integer properties could cause a segmentation fault on x86 (i.e. macOS only). (Core PR #3253).
- The
downloadable_bytesparameter passed to sync progress callbacks reported a value which correlated to the amount of data left to download, but not actually the number of bytes which would be downloaded.
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.21.0 or later.
- Carthage release for Swift is built with Xcode 10.2.1.
- Updating
RLMSyncManager.customRequestHeaderswill immediately update all currently active sync session with the new headers rather than requiring manually closing the Realm and reopening it.
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.11.0 or later.
- Carthage release for Swift is built with Xcode 10.2.1.
- Fix "Cannot find interface declaration for 'RealmSwiftObject', superclass of 'MyRealmObjectClass'" errors when building for a simulator with Xcode 10.2 with "Install Objective-C Compatibility Header" enabled.
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.11.0 or later.
- Carthage release for Swift is built with Xcode 10.2.
- Reduce memory usage when committing write transactions.
- Improve performance of compacting encrypted Realm files. (PR #3221).
- Add a Xcode 10.2 build to the release package.
- Fix a memory leak whenever Realm makes a HTTP(s) request to the Realm Object Server (Issue #6058, since 3.8.0).
- Fix an assertion failure when creating an object in a synchronized Realm after creating an object with a null int primary key in the same write transaction. (PR #3227).
- Fix some new warnings when building with Xcode 10.2 beta.
- Properly clean up sync sessions when the last Realm object using the session is deallocated while the session is explicitly suspended (since 3.9.0).
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.11.0 or later.
- Carthage release for Swift is built with Xcode 10.2.
- Throw an exception rather than crashing with an assertion failure in more cases when opening invalid Realm files.
- Upgrade to REALM_CORE_VERSION=5.14.0
- Upgrade to REALM_SYNC_VERSION=3.15.1
- Fix a crash when iterating over
Realm.subscriptions()using for-in. (Since 3.13.0, PR #6050).
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.11.0 or later.
- Add
Realm.subscriptions()/-[RLMRealm subscriptions]andRealm.subscription(named:)/-[RLMRealm subscriptionWithName:]to enable looking up existing query-based sync subscriptions. (PR: realm#6029).
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.11.0 or later.
- Add a User-Agent header to HTTP requests made to the Realm Object Server. By
default, this contains information about the Realm library version and your
app's bundle ID. The application identifier can be customized by setting
RLMSyncManager.sharedManager.userAgent/SyncManager.shared.userAgentprior to opening a synchronized Realm. (PR: realm#6007). - Add Xcode 10.1 binary to the prebuilt package.
- None.
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.11.0 or later.
- None.
- Improve the performance of the merge algorithm used for integrating remote changes from the server. In particular, changesets involving many objects which all link to a single object should be greatly improved.
- Fix a memory leak when removing notification blocks from collections. PR: #702, since 1.1.0.
- Fix re-sorting or distincting an already-sorted Results using values from linked objects. Previously the unsorted order was used to read the values from the linked objects. PR #3102, since 3.1.0.
- Fix a set of bugs which could lead to bad changeset assertions when using
sync. The assertions would look something like the following:
[realm-core-5.10.0] Assertion failed: ndx < size() with (ndx, size()) = [742, 742].
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.11.0 or later.
- None.
- None.
- Fix
SyncUser.requestEmailConfirmationnot triggering the email confirmation flow on ROS. (PR #5953, since 3.5.0) - Add some missing validation in the getters and setters of properties on managed Realm objects, which would sometimes result in an application crashing with a segfault rather than the appropriate exception being thrown when trying to write to an object which has been deleted. (PR #5952, since 2.8.0)
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- Realm Object Server: 3.11.0 or later.
- None.
- Reduce memory usage when integrating synchronized changes sent by ROS.
- Devices will now report download progress for read-only Realms, allowing the server to compact Realms more aggressively and reducing the amount of server-side storage space required.
- Fix a crash when adding an object with a non-
@objcString?property which has not been explicitly ignored to a Realm on watchOS 5 (and possibly other platforms when building with Xcode 10). (Issue: 5929). - Fix some merge algorithm bugs which could result in
BadChangesetErrorbeing thrown when integrating changes sent by the server.
- File format: Generates Realms with format v9 (Reads and upgrades all previous formats)
- NOTE!!!
You will need to upgrade your Realm Object Server to at least version 3.11.0
or use Realm Cloud.
If you try to connect to a ROS v3.10.x or previous, you will see an error
like
Wrong protocol version in Sync HTTP request, client protocol version = 25, server protocol version = 24.
- Update to Sync 3.12.2.
Prebuilt binaries are now built for Xcode 9.2, 9.3, 9.4 and 10.0.
Older versions of Xcode are still supported when building from source, but you should be migrating to at least Xcode 9.2 as soon as possible.
- Add support for Watch Series 4 by adding an arm64_32 slice to the library.
- Expose RLMSyncUser.refreshToken publicly so that it can be used for custom HTTP requests to Realm Object Server.
- Add RLMSyncSession.connectionState, which reports whether the session is currently connected to the Realm Object Server or if it is offline.
- Add
-suspendand-resumemethods toRLMSyncSessionto enable manually pausing data synchronization. - Add support for limiting the number of objects matched by a query-based sync subscription. This requires a server running ROS 3.10.1 or newer.
- Fix crash when getting the description of a
MigrationObjectwhich hasListproperties. - Fix crash when calling
dynamicList()on aMigrationObject.
- Remove some old and no longer applicable migration logic which created an unencrypted file in the sync metadata directory containing a list of ROS URLs connected to.
- Add support for pinning SSL certificates used for https and realms
connections by setting
RLMSyncManager.sharedManager.pinnedCertificatePathsin obj-c andSyncManager.shared.pinnedCertificatePathsin Swift.
- Fix warnings when building Realm as a static framework with CocoaPods.
- Speed up the actual compaction when using compact-on-launch.
- Reduce memory usage when locally merging changes from sync.
- When first connecting to a server, wait to begin uploading changes until after all changes have been downloaded to reduce the server-side load for query-based sync.
- Improve performance of applying remote changesets from sync.
- Improve performance of creating objects with string primary keys.
- Improve performance of large write transactions.
- Adjust file space allocation strategy to reduce fragmentation, producing smaller Realm files and typically better performance.
- Close network connections immediately when a sync session is destroyed.
- Report more information in
InvalidDatabaseexceptions.
- Fix permission denied errors for RLMPlatform.h when building with CocoaPods and Xcode 10 beta 3.
- Fix a use-after-free when canceling a write transaction which could result in
incorrect "before" values in KVO observations (typically
nilwhen a non-nil value is expected). - Fix several bugs in the merge algorithm that could lead to memory corruption and crashes with errors like "bad changeset" and "unreachable code".
- Fix a bug which could potentially flood Realm Object Server with PING messages after a client device comes back online.
- Avoid performing potentially large amounts of pointless background work for LinkingObjects instances which are accessed and then not immediate deallocated.
- Fix crashes which could result from extremely fragmented Realm files.
- Fix a bug that could result in a crash with the message "bad changeset error" when merging changesets from the server.
- Add some additional consistency checks that will hopefully produce better errors when the "prev_ref + prev_size <= ref" assertion failure occurs.
- Fix a problem in the changeset indexing algorithm that would sometimes cause "bad permission object" and "bad changeset" errors.
- Fix a large number of linking warnings about symbol visibility by aligning compiler flags used.
- Fix large increase in size of files produced by
Realm.writeCopy()introduced in 3.6.0.
- Add support for compiling Realm Swift with Xcode 10 beta 1.
The feature known as Partial Sync has been renamed to Query-based Synchronization. This has impacted a number of API's. See below for the details.
+[RLMSyncConfiguration initWithUser] has been deprecated in favor of-[RLMSyncUser configurationWithURL:url].+[RLMSyncConfiguration automaticConfiguration] has been deprecated in favor of-[RLMSyncUser configuration].+[RLMSyncConfiguration automaticConfigurationForUser] has been deprecated in favor of-[RLMSyncUser configuration].-[RLMSyncConfiguration isPartial] has been deprecated in favor of-[RLMSyncConfiguration fullSynchronization]`.
- Add
-[RLMRealm syncSession]andRealm.syncSessionto obtain the session used for a synchronized Realm. - Add
-[RLMSyncUser configuration]. Query-based sync is the default sync mode for this configuration. - Add
-[RLMSyncUser configurationWithURL:url]. Query-based sync is the default sync mode for this configuration.
- Improve performance of sync metadata operations and resolving thread-safe references.
shouldCompactOnLaunchis now supported for compacting the local data of synchronized Realms.
- Fix a potential deadlock when a sync session progress callback held the last strong reference to the sync session.
- Fix some cases where comparisons to
nilin queries were not properly serialized when subscribing to a query. - Don't delete objects added during a migration after a call to
-[RLMMigration deleteDataForClassName:]. - Fix incorrect results and/or crashes when multiple
-[RLMMigration enumerateObjects:block:]blocks deleted objects of the same type. - Fix some edge-cases where
-[RLMMigration enumerateObjects:block:]enumerated the incorrect objects following deletions. - Restore the pre-3.5.0 behavior for Swift optional properties missing an ivar rather than crashing.
- Add wrapper functions for email confirmation and password reset to
SyncUser.
- Fix incorrect results when using optional chaining to access a RealmOptional property in Release builds, or otherwise interacting with a RealmOptional object after the owning Object has been deallocated.
The prebuilt binary for Carthage is now built for Swift 4.1.
- Expose
RLMSyncManager.authorizationHeaderName/SyncManager.authorizationHeaderNameas a way to override the transport header for Realm Object Server authorization. - Expose
RLMSyncManager.customRequestHeaders/SyncManager.customRequestHeaderswhich allows custom HTTP headers to be appended on requests to the Realm Object Server. - Expose
RLMSSyncConfiguration.urlPrefix/SyncConfiguration.urlPrefixas a mechanism to replace the default path prefix in Realm Sync WebSocket requests.
Add a prebuilt binary for Xcode 9.3.
Realm Object Server v3.0.0 or newer is required when using synchronized Realms.
- Expose
RLMObject.object(forPrimaryKey:)as a factory method for Swift so that it is callable with recent versions of Swift.
- Exclude the RLMObject-derived Permissions classes from the types repored by
Realm.Configuration.defaultConfiguration.objectTypesto avoid a failed cast. - Cancel pending
Realm.asyncOpen()calls when authentication fails with a non-transient error such as missing the Realm path in the URL. - Fix "fcntl() inside prealloc()" errors on APFS.
Realm Object Server v3.0.0 or newer is required when using synchronized Realms.
- Add
Realm.permissions,Realm.permissions(forType:), andRealm.permissions(forClassNamed:)as convenience methods for accessing the permissions of the Realm or a type.
- Fix
+[RLMClassPermission objectInRealm:forClass:]to work for classes that are part of the permissions API, such asRLMPermissionRole. - Fix runtime errors when applications define an
Objectsubclass with the same name as one of the Permissions object types.
Realm Object Server v3.0.0 or newer is required when using synchronized Realms.
- Added an improved API for adding subscriptions in partially-synchronized Realms.
Results.subscribe()can be used to subscribe to any result set, and the returnedSyncSubscriptionobject can be used to observe the state of the subscription and ultimately to remove the subscription. See the documentation for more information (https://docs.realm.io/platform/v/3.x/using-synced-realms/syncing-data). - Added a fine-grained permissions system for use with partially-synchronized Realms. This allows permissions to be defined at the level of individual objects or classes. See the documentation for more information (https://docs.realm.io/platform/v/3.x/using-synced-realms/access-control).
- Added
SyncConfiguration.automatic()andSyncConfiguration.automatic(user:). These methods return aRealm.Configurationappropriate for syncing with the default synced Realm for the current (or specified) user. These should be considered the preferred methods for accessing synced Realms going forwards. - Added
+[RLMSyncSession sessionForRealm:]to retrieve the sync session corresponding to aRLMRealm.
- Fix incorrect initalization of
RLMSyncManagerthat made it impossible to seterrorHandler. - Fix compiler warnings when building with Xcode 9.3.
- Fix some warnings when running with UBsan.
Realm Object Server v3.0.0-rc.1 or newer is required when using synchronized Realms.
- Added
SyncConfiguration.automatic()andSyncConfiguration.automatic(user:). These methods return aRealm.Configurationappropriate for syncing with the default synced Realm for the current (or specified). These should be considered the preferred methods for accessing synced Realms going forwards. - A role is now automatically created for each user with that user as its only member.
This simplifies the common use case of restricting access to specific objects to a single user.
This role can be accessed at
PermissionUser.role. - Improved error reporting when the server rejects a schema change due to a lack of permissions.
- Fix incorrect initalization of
RLMSyncManagerthat made it impossible to seterrorHandler. - Fix compiler warnings when building with Xcode 9.3.
Realm Object Server v3.0.0-alpha.9 or newer is required when using synchronized Realms.
- Fix a crash that would occur when using partial sync with Realm Object Server v3.0.0-alpha.9.
Realm Object Server v3.0.0-alpha.8 or newer is required when using synchronized Realms.
- Added
findOrCreate(forRoleNamed:)andfindOrCreate(forRole:)toList<Permission>to simplify the process of adding permissions for a role. - Added
+permissionForRoleNamed:inArray:,+permissionForRoleNamed:onRealm:,+permissionForRoleNamed:onClass:realm:,+permissionForRoleNamed:onClassNamed:realm:, and+permissionForRoleNamed:onObject:toRLMSyncPermissionto simplify the process of adding permissions for a role. - Added
+[RLMSyncSession sessionForRealm:]to retrieve the sync session corresponding to aRLMRealm.
PermissionRole.usersandPermissionUser.rolesare now public as intended.- Fixed the handling of
setPermissionsin-[RLMRealm privilegesForRealm]and related methods.
- Added an improved API for adding subscriptions in partially-synchronized Realms.
Results.subscribe()can be used to subscribe to any result set, and the returnedSyncSubscriptionobject can be used to observe the state of the subscription and ultimately to remove the subscription. - Added a fine-grained permissions system for use with partially-synchronized Realms. This allows permissions to be
defined at the level of individual objects or classes. See
Permissionand related types for more information.
- Fix some warnings when running with UBsan.
Prebuilt Swift frameworks for Carthage are now built with Xcode 9.2.
- Fix a memory leak when opening Realms with an explicit
objectTypesarray from Swift.
- Prebuilt frameworks are now included for Swift 3.2.3 and 4.0.3.
- Prebuilt frameworks are no longer included for Swift 3.0.x.
- Building from source with Xcode versions prior to Xcode 8.3 is no longer supported.
- Add
Results.distinct(by:)/-[RLMResults distinctResultsUsingKeyPaths:], which return aResultscontaining only objects with unique values at the given key paths. - Improve performance of change checking for notifications in certain cases.
- Realm Object Server errors not explicitly recognized by the client are now reported to the application regardless.
- Add support for JSON Web Token as a sync credential source.
- Add support for Nickname and Anonymous Auth as a sync credential source.
- Improve allocator performance when writing to a highly fragmented file. This should significantly improve performance when inserting large numbers of objects which have indexed properties.
- Improve write performance for complex object graphs involving many classes linking to each other.
- Add a missing check for a run loop in the permission API methods which require one.
- Fix some cases where non-fatal sync errors were being treated as fatal errors.
Prebuilt frameworks are now included for Swift 3.2.2 and 4.0.2.
- Fix a crash when a linking objects property is retrieved from a model object instance via Swift subscripting.
- Fix incorrect behavior if a call to
posix_fallocateis interrupted.
- Explicitly exclude KVO-generated object subclasses from the schema.
- Fix regression where the type of a Realm model class is not properly determined, causing crashes
when a type value derived at runtime by
type(of:)is passed into certain APIs. - Fix a crash when an
Objectsubclass has implicitly ignoredletproperties. - Fix several cases where adding a notification block from within a notification callback could produce incorrect results.
- iOS 7 is no longer supported.
- Synchronized Realms require a server running Realm Object Server v2.0 or higher.
- Computed properties on Realm object types are detected and no longer added to the automatically generated schema.
- The Objective-C and Swift
create(_:, value: update:)APIs now correctly nil out nullable properties when updating an existing object when thevalueargument specifies nil orNSNullfor the property value. -[RLMRealm addOrUpdateObjects:]and-[RLMRealm deleteObjects:]now require their argument to conform toNSFastEnumeration, to match similar APIs that also take collections.- The way interactive sync errors (client reset and permission denied)
are delivered to the user has been changed. Instead of a block which can
be invoked to immediately delete the offending Realm file, an opaque
token object of type
RLMSyncErrorActionTokenwill be returned in the error object'suserInfodictionary. This error object can be passed into the new+[RLMSyncSession immediatelyHandleError:]API to delete the files. - The return types of the
SyncError.clientResetInfo()andSyncError.deleteRealmUserInfo()APIs have been changed. They now returnRLMSyncErrorActionTokens orSyncError.ActionTokens instead of closures. - The class methods
Object.className(),Object.objectUtilClass(), and the propertyObject.isInvalidatedcan no longer be overriden. - The callback which runs when a sync user login succeeds or fails
now runs on the main queue by default, or can be explicitly specified
by a new
callbackQueueparameter on the{RLM}SyncUser.logIn(...)API. - Fix empty strings, binary data, and null on the right side of
BEGINSWITH,ENDSWITHandCONTAINSoperators in predicates to match Foundation's semantics of never matching any strings or data. - Swift
Objectcomparison and hashing behavior now works the same way as that ofRLMObject(objects are now only considered equatable if their model class defines a primary key). - Fix the way the hash property works on
Objectwhen the object model has no primary key. - Fix an issue where if a Swift model class defined non-generic managed
properties after generic Realm properties (like
List<T>), the schema would be constructed incorrectly. Fixes an issue where creating such models from an array could fail. - Loosen
RLMArrayandRLMResults's generic constraint fromRLMObjecttoNSObject. This may result in having to add some casts to disambiguate types. - Remove
RLMSyncPermissionResults.RLMSyncPermissions are now vended out using aRLMResults. This results collection supports all normal collection operations except for setting values using key-value coding (sinceRLMSyncPermissions are immutable) and the property aggregation operations. RLMSyncUserInfohas been significantly enhanced. It now contains metadata about a user stored on the Realm Object Server, as well as a list of all user account data associated with that user.- Starting with Swift 4,
Listnow conforms toMutableCollectioninstead ofRangeReplaceableCollection. For Swift 4, the empty collection initializer has been removed, and default implementations of range replaceable collection methods that make sense forListhave been added. List.removeLast()now throws an exception if the list is empty, to more closely match the behavior of the standard library'sCollection.removeLast()implementation.RealmCollection's associated typeElementhas been renamedElementType.- The following APIs have been renamed:
| Old API | New API |
|---|---|
NotificationToken.stop() |
NotificationToken.invalidate() |
-[RLMNotificationToken stop] |
-[RLMNotificationToken invalidate] |
RealmCollection.addNotificationBlock(_:) |
RealmCollection.observe(_:) |
RLMSyncProgress |
RLMSyncProgressMode |
List.remove(objectAtIndex:) |
List.remove(at:) |
List.swap(_:_:) |
List.swapAt(_:_:) |
SyncPermissionValue |
SyncPermission |
RLMSyncPermissionValue |
RLMSyncPermission |
-[RLMSyncPermission initWithRealmPath:userID:accessLevel] |
-[RLMSyncPermission initWithRealmPath:identity:accessLevel:] |
RLMSyncPermission.userId |
RLMSyncPermission.identity |
-[RLMRealm addOrUpdateObjectsInArray:] |
-[RLMRealm addOrUpdateObjects:] |
- The following APIs have been removed:
| Removed API | Replacement |
|---|---|
Object.className |
None, was erroneously present. |
RLMPropertyTypeArray |
RLMProperty.array |
PropertyType.array |
Property.array |
-[RLMArray sortedResultsUsingProperty:ascending:] |
-[RLMArray sortedResultsUsingKeyPath:ascending:] |
-[RLMCollection sortedResultsUsingProperty:ascending:] |
-[RLMCollection sortedResultsUsingKeyPath:ascending:] |
-[RLMResults sortedResultsUsingProperty:ascending:] |
-[RLMResults sortedResultsUsingKeyPath:ascending:] |
+[RLMSortDescriptor sortDescriptorWithProperty:ascending:] |
+[RLMSortDescriptor sortDescriptorWithKeyPath:ascending:] |
RLMSortDescriptor.property |
RLMSortDescriptor.keyPath |
AnyRealmCollection.sorted(byProperty:ascending:) |
AnyRealmCollection.sorted(byKeyPath:ascending:) |
List.sorted(byProperty:ascending:) |
List.sorted(byKeyPath:ascending:) |
LinkingObjects.sorted(byProperty:ascending:) |
LinkingObjects.sorted(byKeyPath:ascending:) |
Results.sorted(byProperty:ascending:) |
Results.sorted(byKeyPath:ascending:) |
SortDescriptor.init(property:ascending:) |
SortDescriptor.init(keyPath:ascending:) |
SortDescriptor.property |
SortDescriptor.keyPath |
+[RLMRealm migrateRealm:configuration:] |
+[RLMRealm performMigrationForConfiguration:error:] |
RLMSyncManager.disableSSLValidation |
RLMSyncConfiguration.enableSSLValidation |
SyncManager.disableSSLValidation |
SyncConfiguration.enableSSLValidation |
RLMSyncErrorBadResponse |
RLMSyncAuthErrorBadResponse |
RLMSyncPermissionResults |
RLMResults |
SyncPermissionResults |
Results |
RLMSyncPermissionChange |
-[RLMSyncUser applyPermission:callback] / -[RLMSyncUser deletePermission:callback:] |
-[RLMSyncUser permissionRealmWithError:] |
-[RLMSyncUser retrievePermissionsWithCallback:] |
RLMSyncPermissionOffer |
-[RLMSyncUser createOfferForRealmAtURL:accessLevel:expiration:callback:] |
RLMSyncPermissionOfferResponse |
-[RLMSyncUser acceptOfferForToken:callback:] |
-[NSError rlmSync_clientResetBlock] |
-[NSError rlmSync_errorActionToken] / -[NSError rlmSync_clientResetBackedUpRealmPath] |
-[NSError rlmSync_deleteRealmBlock] |
-[NSError rlmSync_errorActionToken] |
Listcan now contain values of typesBool,Int,Int8,Int16,Int32,Int64,Float,Double,String,Data, andDate(and optional versions of all of these) in addition toObjectsubclasses. QueryingLists containing values other thanObjectsubclasses is not yet implemented.RLMArraycan now be constrained with the protocolsRLMBool,RLMInt,RLMFloat,RLMDouble,RLMString,RLMData, andRLMDatein addition to protocols defined withRLM_ARRAY_TYPE. By defaultRLMArrays of non-RLMObjecttypes can contain null. Indicating that the property is required (by overriding+requiredProperties:) will instead make the values within the array required. QueryingRLMArrays containing values other thanRLMObjectsubclasses is not yet implemented.- Add a new error code to denote 'permission denied' errors when working
with synchronized Realms, as well as an accompanying block that can be
called to inform the binding that the offending Realm's files should be
deleted immediately. This allows recovering from 'permission denied'
errors in a more robust manner. See the documentation for
RLMSyncErrorPermissionDeniedErrorfor more information. - Add Swift
Object.isSameObject(as:_)API to perform the same function as the existing Objective-C API-[RLMObject isEqualToObject:]. - Opening a synced Realm whose local copy was created with an older version of
Realm Mobile Platfrom when a migration is not possible to the current version
will result in an
RLMErrorIncompatibleSyncedFile/incompatibleSyncedFileerror. When such an error occurs, the original file is moved to a backup location, and future attempts to open the synchronized Realm will result in a new file being created. If you wish to migrate any data from the backup Realm you can open it using the backup Realm configuration available on the error object. - Add a preview of partial synchronization. Partial synchronization allows a
synchronized Realm to be opened in such a way that only objects requested by
the user are synchronized to the device. You can use it by setting the
isPartialproperty on aSyncConfiguration, opening the Realm, and then callingRealm.subscribe(to:where:callback:)with the type of object you're interested in, a string containing a query determining which objects you want to subscribe to, and a callback which will report the results. You may add as many subscriptions to a synced Realm as necessary.
- Realm no longer throws an "unsupported instruction" exception in some cases when opening a synced Realm asynchronously.
- Realm Swift APIs that filter or look up the index of an object based on a format string now properly handle optional arguments in their variadic argument list.
-[RLMResults<RLMSyncPermission *> indexOfObject:]now properly accounts for access level.- Fix a race condition that could lead to a crash accessing to the freed configuration object if a default configuration was set from a different thread.
- Fixed an issue that crash when enumerating after clearing data during migration.
- Fix a bug where a synced Realm couldn't be reopened even after a successful client reset in some cases.
- Fix a bug where the sync subsystem waited too long in certain cases to reconnect to the server.
- Fix a bug where encrypted sync-related metadata was incorrectly deleted from upgrading users, resulting in all users being logged out.
- Fix a bug where permission-related data continued to be synced to a client even after the user that data belonged to logged out.
- Fix an issue where collection notifications might be delivered inconsistently if a notification callback was added within another callback for the same collection.
- Reinstate
RLMSyncPermissionSortPropertyUserIDto allow users to sort permissions to their own Realms they've granted to others.
-[RLMResults<RLMSyncPermission *> indexOfObject:]now properly accounts for access level.- Fix a race condition that could lead to a crash accessing to the freed configuration object if a default configuration was set from a different thread.
- Fixed an issue that crash when enumerating after clearing data during migration.
- Fix a bug where a synced Realm couldn't be reopened even after a successful client reset in some cases.
- Fix a bug where the sync subsystem waited too long in certain cases to reconnect to the server.
- Fix a bug where encrypted sync-related metadata was incorrectly deleted from upgrading users, resulting in all users being logged out.
- Fix a bug where permission-related data continued to be synced to a client even after the user that data belonged to logged out.
- Fix an issue where collection notifications might be delivered inconsistently if a notification callback was added within another callback for the same collection.
- Remove
RLMSyncPermissionSortPropertyUserIDto reflect changes in how the Realm Object Server reports permissions for a user. - Remove
RLMSyncPermissionOfferandRLMSyncPermissionOfferResponseclasses and associated helper methods and functions. Use the-[RLMSyncUser createOfferForRealmAtURL:accessLevel:expiration:callback:]and-[RLMSyncUser acceptOfferForToken:callback:]methods instead.
- The keychain item name used by Realm to manage the encryption keys for sync-related metadata is now set to a per-app name based on the bundle identifier. Keys that were previously stored within the single, shared Realm keychain item will be transparently migrated to the per-application keychain item.
- Fix downloading of the Realm core binaries when Xcode's command-line tools are set as the active developer directory for command-line interactions.
- Fix a crash that could occur when resolving a ThreadSafeReference to a
Listwhose parent object had since been deleted.
- Rename
List.remove(objectAtIndex:)toList.remove(at:)to match the name used by 'RangeReplaceableCollection'. - Rename
List.swap()toList.swapAt()to match the name used by 'Array'. - Loosen
RLMArrayandRLMResults's generic constraint fromRLMObjecttoNSObject. This may result in having to add some casts to disambiguate types. - Remove
RLMPropertyTypeArrayin favor of a separate boolarrayproperty onRLMProperty/Property. - Remove
RLMSyncPermissionResults.RLMSyncPermissions are now vended out using aRLMResults. This results collection supports all normal collection operations except for setting values using KVO (sinceRLMSyncPermissions are immutable) and the property aggregation operations. RealmCollection's associated typeElementhas been renamedElementType.- Realm Swift collection types (
List,Results,AnyRealmCollection, andLinkingObjectshave had their generic type parameter changed fromTtoElement). RealmOptional's generic type parameter has been changed fromTtoValue.RLMSyncUserInfohas been significantly enhanced. It now contains metadata about a user stored on the Realm Object Server, as well as a list of all user account data associated with that user.- Starting with Swift 4,
Listnow conforms toMutableCollectioninstead ofRangeReplaceableCollection. For Swift 4, the empty collection initializer has been removed, and default implementations of range replaceable collection methods that make sense forListhave been added. List.removeLast()now throws an exception if the list is empty, to more closely match the behavior of the standard library'sCollection.removeLast()implementation.
Listcan now contain values of typesBool,Int,Int8,Int16,Int32,Int64,Float,Double,String,Data, andDate(and optional versions of all of these) in addition toObjectsubclasses. QueryingLists containing values other thanObjectsubclasses is not yet implemented.RLMArraycan now be constrained with the protocolsRLMBool,RLMInt,RLMFloat,RLMDouble,RLMString,RLMData, andRLMDatein addition to protocols defined withRLM_ARRAY_TYPE. By defaultRLMArrays of non-RLMObjecttypes can contain null. Indicating that the property is required (by overriding+requiredProperties:) will instead make the values within the array required. QueryingRLMArrays containing values other thanRLMObjectsubclasses is not yet implemented.- Opening a synced Realm whose local copy was created with an older version of
Realm Mobile Platfrom when a migration is not possible to the current version
will result in an
RLMErrorIncompatibleSyncedFile/incompatibleSyncedFileerror. When such an error occurs, the original file is moved to a backup location, and future attempts to open the synchronized Realm will result in a new file being created. If you wish to migrate any data from the backup Realm you can open it using the backup Realm configuration available on the error object. - Add preview support for partial synchronization. Partial synchronization is
allows a synchronized Realm to be opened in such a way that only objects
requested by the user are synchronized to the device. You can use it by setting
the
isPartialproperty on aSyncConfiguration, opening the Realm, and then callingRealm.subscribe(to:where:callback:)with the type of object you're interested in, a string containing a query determining which objects you want to subscribe to, and a callback which will report the results. You may add as many subscriptions to a synced Realm as necessary.
- Realm Swift APIs that filter or look up the index of an object based on a format string now properly handle optional arguments in their variadic argument list.
- iOS 7 is no longer supported.
- Computed properties on Realm object types are detected and no longer added to the automatically generated schema.
-[RLMRealm addOrUpdateObjectsInArray:]has been renamed to-[RLMRealm addOrUpdateObjects:]for consistency with similar methods that add or delete objects.-[RLMRealm addOrUpdateObjects:]and-[RLMRealm deleteObjects:]now require their argument to conform toNSFastEnumeration, to match similar APIs that also take collections.- Remove deprecated
{RLM}SyncPermissionand{RLM}SyncPermissionChangeclasses. {RLM}SyncPermissionValuehas been renamed to just{RLM}SyncPermission. ItsuserIdproperty has been renamedidentity, and its-initWithRealmPath:userID:accessLevel:initializer has been renamed-initWithRealmPath:identity:accessLevel:.- Remove deprecated
-[RLMSyncUser permissionRealmWithError:]andSyncUser.permissionRealm()APIs. Use the new permissions system. - Remove deprecated error
RLMSyncErrorBadResponse. UseRLMSyncAuthErrorBadResponseinstead. - The way interactive sync errors (client reset and permission denied)
are delivered to the user has been changed. Instead of a block which can
be invoked to immediately delete the offending Realm file, an opaque
token object of type
RLMSyncErrorActionTokenwill be returned in the error object'suserInfodictionary. This error object can be passed into the new+[RLMSyncSession immediatelyHandleError:]API to delete the files. - Remove
-[NSError rlmSync_clientResetBlock]and-[NSError rlmSync_deleteRealmBlock]APIs. - The return types of the
SyncError.clientResetInfo()andSyncError.deleteRealmUserInfo()APIs have been changed. They now returnRLMSyncErrorActionTokens orSyncError.ActionTokens instead of closures. - The (erroneously added) instance property
Object.classNamehas been removed. - The class methods
Object.className(),Object.objectUtilClass(), and the propertyObject.isInvalidatedcan no longer be overriden. - The callback which runs when a sync user login succeeds or fails
now runs on the main queue by default, or can be explicitly specified
by a new
callbackQueueparameter on the{RLM}SyncUser.logIn(...)API. - Rename
{RLM}NotificationToken.stop()toinvalidate()and{RealmCollection,SyncPermissionResults}.addNotificationBlock(_:)toobserve(_:)to mirror Foundation's new KVO APIs. - The
RLMSyncProgressenum has been renamedRLMSyncProgressMode. - Remove deprecated
{RLM}SyncManager.disableSSLValidationproperty. Disable SSL validation on a per-Realm basis by setting theenableSSLValidationproperty on{RLM}SyncConfigurationinstead. - Fix empty strings, binary data, and null on the right side of
BEGINSWITH,ENDSWITHandCONTAINSoperators in predicates to match Foundation's semantics of never matching any strings or data. - Swift
Objectcomparison and hashing behavior now works the same way as that ofRLMObject(objects are now only considered equatable if their model class defines a primary key). - Fix the way the hash property works on
Objectwhen the object model has no primary key. - Fix an issue where if a Swift model class defined non-generic managed
properties after generic Realm properties (like
List<T>), the schema would be constructed incorrectly. Fixes an issue where creating such models from an array could fail.
- Add Swift
Object.isSameObject(as:_)API to perform the same function as the existing Objective-C API-[RLMObject isEqualToObject:]. - Expose additional authentication-related errors that might be reported by a Realm Object Server.
- An error handler can now be registered on
{RLM}SyncUsers in order to report authentication-related errors that affect the user.
- Sync users are now automatically logged out upon receiving certain types of errors that indicate they are no longer logged into the server. For example, users who are authenticated using third-party credentials will find themselves logged out of the Realm Object Server if the third-party identity service indicates that their credential is no longer valid.
- Address high CPU usage and hangs in certain cases when processing collection notifications in highly-connected object graphs.
- Remove the following deprecated Objective-C APIs:
-[RLMArray sortedResultsUsingProperty:ascending:],-[RLMCollection sortedResultsUsingProperty:ascending:],-[RLMResults sortedResultsUsingProperty:ascending:],+[RLMSortDescriptor sortDescriptorWithProperty:ascending:],RLMSortDescriptor.property. These APIs have been superseded by equivalent APIs that take or return key paths instead of property names. - Remove the following deprecated Objective-C API:
+[RLMRealm migrateRealm:configuration:]. Please use+[RLMRealm performMigrationForConfiguration:error:]instead. - Remove the following deprecated Swift APIs:
AnyRealmCollection.sorted(byProperty:, ascending:),LinkingObjects.sorted(byProperty:, ascending:),List.sorted(byProperty:, ascending:),Results.sorted(byProperty:, ascending:),SortDescriptor.init(property:, ascending:),SortDescriptor.property. These APIs have been superseded by equivalent APIs that take or return key paths instead of property names. - The Objective-C and Swift
create(_:, value: update:)APIs now correctly nil out nullable properties when updating an existing object when thevalueargument specifies nil orNSNullfor the property value.
- It is now possible to create and log in multiple Realm Object Server users with the same identity if they originate from different servers. Note that if the URLs are different aliases for the same authentication server each user will still be treated as separate (e.g. they will have their own copy of each synchronized Realm opened using them). It is highly encouraged that users defined using the access token credential type be logged in with an authentication server URL specified; this parameter will become mandatory in a future version of the SDK.
- Add
-[RLMSyncUser retrieveInfoForUser:identityProvider:completion:]API allowing administrator users to retrieve information about a user based on their provider identity (for example, a username). Requires any edition of the Realm Object Server 1.8.2 or later.
- Realm no longer throws an "unsupported instruction" exception in some cases when opening a synced Realm asynchronously.
- Synchronized Realms require a server running Realm Object Server v2.0 or higher.
- Add a new error code to denote 'permission denied' errors when working
with synchronized Realms, as well as an accompanying block that can be
called to inform the binding that the offending Realm's files should be
deleted immediately. This allows recovering from 'permission denied'
errors in a more robust manner. See the documentation for
RLMSyncErrorPermissionDeniedErrorfor more information. - Add
-[RLMSyncPermissionValue initWithRealmPath:username:accessLevel:]API allowing permissions to be applied to a user based on their username (usually, an email address). Requires any edition of the Realm Object Server 1.6.0 or later. - Improve performance of creating Swift objects which contain at least one List property.
List.descriptionnow reports the correct types for nested lists.- Fix unmanaged object initialization when a nested property type returned
falsefromObject.shouldIncludeInDefaultSchema(). - Don't clear RLMArrays on self-assignment.
- The keychain item name used by Realm to manage the encryption keys for sync-related metadata is now set to a per-app name based on the bundle identifier. Keys that were previously stored within the single, shared Realm keychain item will be transparently migrated to the per-application keychain item.
- Fix downloading of the Realm core binaries when Xcode's command-line tools are set as the active developer directory for command-line interactions.
- Fix a crash that could occur when resolving a ThreadSafeReference to a
Listwhose parent object had since been deleted.
Swift binaries are now produced for Swift 3.0, 3.0.1, 3.0.2, 3.1, 3.2 and 4.0.
- Auxiliary files are excluded from backup by default.
- Fix more cases where assigning an RLMArray property to itself would clear the RLMArray.
- None.
- Expose additional authentication-related errors that might be reported by a Realm Object Server.
- An error handler can now be registered on
{RLM}SyncUsers in order to report authentication-related errors that affect the user.
- Sorting Realm collection types no longer throws an exception on iOS 7.
- Sync users are now automatically logged out upon receiving certain types of errors that indicate they are no longer logged into the server. For example, users who are authenticated using third-party credentials will find themselves logged out of the Realm Object Server if the third-party identity service indicates that their credential is no longer valid.
- Address high CPU usage and hangs in certain cases when processing collection notifications in highly-connected object graphs.
- None.
- None.
- The
shouldCompactOnLaunchblock is no longer invoked if the Realm at that path is already open on other threads. - Fix an assertion failure in collection notifications when changes are made to the schema via sync while the notification block is active.
- None.
- Add a new error code to denote 'permission denied' errors when working
with synchronized Realms, as well as an accompanying block that can be
called to inform the binding that the offending Realm's files should be
deleted immediately. This allows recovering from 'permission denied'
errors in a more robust manner. See the documentation for
RLMSyncErrorPermissionDeniedErrorfor more information. - Add
-[RLMSyncPermissionValue initWithRealmPath:username:accessLevel:]API allowing permissions to be applied to a user based on their username (usually, an email address). Requires any edition of the Realm Object Server 1.6.0 or later. - Improve performance of creating Swift objects which contain at least one List property.
- It is now possible to create and log in multiple Realm Object Server users with the same identity if they originate from different servers. Note that if the URLs are different aliases for the same authentication server each user will still be treated as separate (e.g. they will have their own copy of each synchronized Realm opened using them). It is highly encouraged that users defined using the access token credential type be logged in with an authentication server URL specified; this parameter will become mandatory in a future version of the SDK.
- Add
-[RLMSyncUser retrieveInfoForUser:identityProvider:completion:]API allowing administrator users to retrieve information about a user based on their provider identity (for example, a username). Requires any edition of the Realm Object Server 1.8.2 or later.
List.descriptionnow reports the correct types for nested lists.- Fix unmanaged object initialization when a nested property type returned
falsefromObject.shouldIncludeInDefaultSchema(). - Don't clear RLMArrays on self-assignment.
- Properly update RealmOptional properties when adding an object with
add(update: true). - Add some missing quotes in error messages.
- Fix a performance regression when creating objects with primary keys.
- Fix an issue where synchronized Realms would eventually disconnect from the remote server if the user object used to define their sync configuration was destroyed.
- Restore support for changing primary keys in migrations (broken in 2.8.0).
- Revert handling of adding objects with nil properties to a Realm to the pre-2.8.0 behavior.
Add support for building with Xcode 9 Beta 1.
- Fix setting a float property to NaN.
- Fix a crash when using compact on launch in combination with collection notifications.
- None.
- Enable encryption on watchOS.
- Add
-[RLMSyncUser changePassword:forUserID:completion:]API to change an arbitrary user's password if the current user has administrative privileges and using Realm's 'password' authentication provider. Requires any edition of the Realm Object Server 1.6.0 or later.
- Suppress
-Wdocumentationwarnings in Realm C++ headers when using CocoaPods with Xcode 8.3.2. - Throw an appropriate error rather than crashing when an RLMArray is assigned to an RLMArray property of a different type.
- Fix crash in large (>4GB) encrypted Realm files.
- Improve accuracy of sync progress notifications.
- Fix an issue where synchronized Realms did not connect to the remote server in certain situations, such as when an application was offline when the Realms were opened but later regained network connectivity.
- None.
- Use reachability API to minimize the reconnection delay if the network connection was lost.
- Add
-[RLMSyncUser changePassword:completion:]API to change the current user's password if using Realm's 'password' authentication provider. Requires any edition of the Realm Object Server 1.4.0 or later. {RLM}SyncConfigurationnow has anenableSSLValidationproperty (and default parameter in the Swift initializer) to allow SSL validation to be specified on a per-server basis.- Transactions between a synced Realm and a Realm Object Server can now exceed 16 MB in size.
- Add new APIs for changing and retrieving permissions for synchronized Realms. These APIs are intended to replace the existing Realm Object-based permissions system. Requires any edition of the Realm Object Server 1.1.0 or later.
- Support Realm model classes defined in Swift with overridden Objective-C
names (e.g.
@objc(Foo) class SwiftFoo: Object {}). - Fix
-[RLMMigration enumerateObjects:block:]returning incorrectoldObjectobjects when enumerating a class name after previously deleting anewObject. - Fix an issue where
Realm.asyncOpen(...)would fail to work when opening a synchronized Realm for which the user only had read permissions. - Using KVC to set a
Listproperty tonilnow clears it to match the behavior ofRLMArrayproperties. - Fix crash from
!m_awaiting_pongassertion failure when using synced Realms. - Fix poor performance or hangs when performing case-insensitive queries on indexed string properties that contain many characters that don't differ between upper and lower case (e.g., numbers, punctuation).
- None.
- None.
- Fix an issue where calling
Realm.asyncOpen(...)with a synchronized Realm configuration would fail with an "Operation canceled" error. - Fix initial collection notification sometimes not being delivered for synced Realms.
- Fix circular links sometimes resulting in objects not being marked as modified in change notifications.
- None.
- None.
- Fix an issue where calling
Realm.asyncOpen(...)with a synchronized Realm configuration would crash in error cases rather than report the error. This is a small source breaking change if you were relying on the error being reported to be aRealm.Error.
- None.
- Add a
{RLM}SyncUser.isAdminproperty indicating whether a user is a Realm Object Server administrator. - Add an API to asynchronously open a Realm and deliver it to a block on a given queue. This performs all work needed to get the Realm to a usable state (such as running potentially time-consuming migrations) on a background thread before dispatching to the given queue. In addition, synchronized Realms wait for all remote content available at the time the operation began to be downloaded and available locally.
- Add
shouldCompactOnLaunchblock property when configuring a Realm to determine if it should be compacted before being returned. - Speed up case-insensitive queries on indexed string properties.
- Add RLMResults's collection aggregate methods to RLMArray.
- Add support for calling the aggregate methods on unmanaged Lists.
- Fix a deadlock when multiple processes open a Realm at the same time.
- Fix
value(forKey:)/value(forKeyPath:)returning incorrect values forListproperties.
- None.
- None.
- Fix CocoaPods installation with static libraries and multiple platforms.
- Fix uncaught "Bad version number" exceptions on the notification worker thread followed by deadlocks when Realms refresh.
Files written by Realm this version cannot be read by earlier versions of Realm. Old files can still be opened and files open in read-only mode will not be modified.
If using synchronized Realms, the Realm Object Server must be running version 1.3.0 or later.
Swift binaries are now produced for Swift 3.0, 3.0.1, 3.0.2 and 3.1.
- None.
- Add support for multi-level object equality comparisons against
NULL. - Add support for the
[d]modifier on string comparison operators to perform diacritic-insensitive comparisons. - Explicitly mark
[[RLMRealm alloc] init]as unavailable. - Include the name of the problematic class in the error message when an invalid property type is marked as the primary key.
- Fix incorrect column type assertions which could occur after schemas were merged by sync.
- Eliminate an empty write transaction when opening a synced Realm.
- Support encrypting synchronized Realms by respecting the
encryptionKeyvalue of the Realm's configuration. - Fix crash when setting an
{NS}Dataproperty close to 16MB. - Fix for reading
{NS}Dataproperties incorrectly returningnil. - Reduce file size growth in cases where Realm versions were pinned while starting write transactions.
- Fix an assertion failure when writing to large
RLMArray/Listproperties. - Fix uncaught
BadTransactLogexceptions when pulling invalid changesets from synchronized Realms. - Fix an assertion failure when an observed
RLMArray/Listis deleted after being modified.
- None.
- Add
(RLM)SyncPermissionclass to allow reviewing access permissions for Realms. Requires any edition of the Realm Object Server 1.1.0 or later. - Further reduce the number of files opened per thread-specific Realm on macOS, iOS and watchOS.
- Fix a crash that could occur if new Realm instances were created while the application was exiting.
- Fix a bug that could lead to bad version number errors when delivering change notifications.
- Fix a potential use-after-free bug when checking validity of results.
- Fix an issue where a sync session might not close properly if it receives an error while being torn down.
- Fix some issues where a sync session might not reconnect to the server properly or get into an inconsistent state if revived after invalidation.
- Fix an issue where notifications might not fire when the children of an observed object are changed.
- Fix an issue where progress notifications on sync sessions might incorrectly report out-of-date values.
- Fix an issue where multiple threads accessing encrypted data could result in corrupted data or crashes.
- Fix an issue where certain
LIKEqueries could hang. - Fix an issue where
-[RLMRealm writeCopyToURL:encryptionKey:error]could create a corrupt Realm file. - Fix an issue where incrementing a synced Realm's schema version without actually changing the schema could cause a crash.
- None.
- Avoid copying copy-on-write data structures, which can grow the file, when the write does not actually change existing values.
- Improve performance of deleting all objects in an RLMResults.
- Reduce the number of files opened per thread-specific Realm on macOS.
- Improve startup performance with large numbers of
RLMObject/Objectsubclasses.
- Fix synchronized Realms not downloading remote changes when an access token expires and there are no local changes to upload.
- Fix an issue where values set on a Realm object using
setValue(value:, forKey:)that were not themselves Realm objects were not properly converted into Realm objects or checked for validity. - Fix an issue where
-[RLMSyncUser sessionForURL:]could erroneously return a non-nil value when passed in an invalid URL. SyncSession.Progress.fractionTransferrednow returns 1 if there are no transferrable bytes.- Fix sync progress notifications registered on background threads by always dispatching on a dedicated background queue.
- Fix compilation issues with Xcode 8.3 beta 2.
- Fix incorrect sync progress notification values for Realms originally created using a version of Realm prior to 2.3.0.
- Fix LLDB integration to be able to display summaries of
RLMResultsonce more. - Reject Swift properties with names which cause them to fall in to ARC method families rather than crashing when they are accessed.
- Fix sorting by key path when the declared property order doesn't match the order of properties in the Realm file, which can happen when properties are added in different schema versions.
- Fix an issue where RLMRealm instances could end up in the autorelease pool for other threads.
- Fix an issue where authentication tokens were not properly refreshed automatically before expiring.
This release drops support for compiling with Swift 2.x. Swift 3.0.0 is now the minimum Swift version supported.
- None.
- Add change notifications for individual objects with an API similar to that of collection notifications.
- Fix Realm Objective-C compilation errors with Xcode 8.3 beta 1.
- Fix several error handling issues when renewing expired authentication tokens for synchronized Realms.
- Fix a race condition leading to bad_version exceptions being thrown in Realm's background worker thread.
- Make
PermissionChange'sidproperty a primary key.
- None.
- Add
SyncPermissionOfferandSyncPermissionOfferResponseclasses to allow creating and accepting permission change events to synchronized Realms between different users. - Support monitoring sync transfer progress by registering notification blocks
on
SyncSession. Specify the transfer direction (.upload/.download) and mode (.reportIndefinitely/.forCurrentlyOutstandingWork) to monitor.
- Fix a call to
commitWrite(withoutNotifying:)committing a transaction that would not have triggered a notification incorrectly skipping the next notification. - Fix incorrect results and crashes when conflicting object insertions are merged by the synchronization mechanism when there is a collection notification registered for that object type.
- Sync-related error reporting behavior has been changed. Errors not related to a particular user or session are only reported if they are classed as 'fatal' by the underlying sync engine.
- Added
RLMSyncErrorClientResetErrortoRLMSyncErrorenum.
- The following Objective-C APIs have been deprecated in favor of newer or preferred versions:
| Deprecated API | New API |
|---|---|
-[RLMArray sortedResultsUsingProperty:] |
-[RLMArray sortedResultsUsingKeyPath:] |
-[RLMCollection sortedResultsUsingProperty:] |
-[RLMCollection sortedResultsUsingKeyPath:] |
-[RLMResults sortedResultsUsingProperty:] |
-[RLMResults sortedResultsUsingKeyPath:] |
+[RLMSortDescriptor sortDescriptorWithProperty:ascending] |
+[RLMSortDescriptor sortDescriptorWithKeyPath:ascending:] |
RLMSortDescriptor.property |
RLMSortDescriptor.keyPath |
- The following Swift APIs have been deprecated in favor of newer or preferred versions:
| Deprecated API | New API |
|---|---|
LinkingObjects.sorted(byProperty:ascending:) |
LinkingObjects.sorted(byKeyPath:ascending:) |
List.sorted(byProperty:ascending:) |
List.sorted(byKeyPath:ascending:) |
RealmCollection.sorted(byProperty:ascending:) |
RealmCollection.sorted(byKeyPath:ascending:) |
Results.sorted(byProperty:ascending:) |
Results.sorted(byKeyPath:ascending:) |
SortDescriptor(property:ascending:) |
SortDescriptor(keyPath:ascending:) |
SortDescriptor.property |
SortDescriptor.keyPath |
- Introduce APIs for safely passing objects between threads. Create a
thread-safe reference to a thread-confined object by passing it to the
+[RLMThreadSafeReference referenceWithThreadConfined:]/ThreadSafeReference(to:)constructor, which you can then safely pass to another thread to resolve in the new Realm with-[RLMRealm resolveThreadSafeReference:]/Realm.resolve(_:). - Realm collections can now be sorted by properties over to-one relationships.
- Optimized
CONTAINSqueries to use Boyer-Moore algorithm (around 10x speedup on large datasets).
- Setting
deleteRealmIfMigrationNeedednow also deletes the Realm if a file format migration is required, such as when moving from a file last accessed with Realm 0.x to 1.x, or 1.x to 2.x. - Fix queries containing nested
SUBQUERYexpressions. - Fix spurious incorrect thread exceptions when a thread id happens to be reused while an RLMRealm instance from the old thread still exists.
- Fixed various bugs in aggregate methods (max, min, avg, sum).
This release adds binary versions of Swift 3.0.2 frameworks built with Xcode 8.2.
- Rename occurences of "iCloud" with "CloudKit" in APIs and comments to match naming in the Realm Object Server.
- None.
- Add support for 'LIKE' queries (wildcard matching).
- Fix authenticating with CloudKit.
- Fix linker warning about "Direct access to global weak symbol".
- Add
RealmSwift.ObjectiveCSupport.convert(object:)methods to help write code that interoperates between Realm Objective-C and Realm Swift APIs. - Throw exceptions when opening a Realm with an incorrect configuration, like:
readOnlyset with a sync configuration.readOnlyset with a migration block.- migration block set with a sync configuration.
- Greatly improve performance of write transactions which make a large number of changes to indexed properties, including the automatic migration when opening files written by Realm 1.x.
- Reset sync metadata Realm in case of decryption error.
- Fix issue preventing using synchronized Realms in Xcode Playgrounds.
- Fix assertion failure when migrating a model property from object type to
RLMLinkingObjectstype. - Fix a
LogicError: Bad version numberexception when usingRLMResultswith no notification blocks and explicitly called-[RLMRealm refresh]from that thread. - Logged-out users are no longer returned from
+[RLMSyncUser currentUser]or+[RLMSyncUser allUsers]. - Fix several issues which could occur when the 1001st object of a given type was created or added to an RLMArray/List, including crashes when rerunning existing queries and possibly data corruption.
- Fix a potential crash when the application exits due to a race condition in the destruction of global static variables.
- Fix race conditions when waiting for sync uploads or downloads to complete which could result in crashes or the callback being called too early.
- None.
- None.
- Add the ability to skip calling specific notification blocks when committing a write transaction.
- Deliver collection notifications when beginning a write transaction which advances the read version of a Realm (previously only Realm-level notifications were sent).
- Fix some scenarios which would lead to inconsistent states when using collection notifications.
- Fix several race conditions in the notification functionality.
- Don't send Realm change notifications when canceling a write transaction.
- Remove
RLMAuthenticationActionsand replace+[RLMSyncCredential credentialWithUsername:password:actions:]with+[RLMSyncCredential credentialsWithUsername:password:register:]. - Rename
+[RLMSyncUser authenticateWithCredential:]to+[RLMSyncUser logInWithCredentials:]. - Rename "credential"-related types and methods to
RLMSyncCredentials/SyncCredentialsand consistently refer to credentials in the plural form. - Change
+[RLMSyncUser all]to return a dictionary of identifiers to users and rename to:+[RLMSyncUser allUsers]in Objective-C.SyncUser.allUsers()in Swift 2.SyncUser.allin Swift 3.
- Rename
SyncManager.sharedManager()toSyncManager.sharedin Swift 3. - Change
Realm.Configuration.syncConfigurationto take aSyncConfigurationstruct rather than a named tuple. +[RLMSyncUser logInWithCredentials:]now invokes its callback block on a background queue.
- None.
- Add
+[RLMSyncUser currentUser]. - Add the ability to change read, write and management permissions for
synchronized Realms using the management Realm obtained via the
-[RLMSyncUser managementRealmWithError:]API and theRLMSyncPermissionChangeclass.
- None.
This release adds binary versions of Swift 3.0.1 frameworks built with Xcode 8.1 GM seed.
- None.
- None.
- Fix a
BadVersionexception caused by a race condition when delivering collection change notifications. - Fix an assertion failure when additional model classes are added and
deleteRealmIfMigrationNeededis enabled. - Fix a
BadTransactLogexception when deleting anRLMResultsin a synced Realm. - Fix an assertion failure when a write transaction is in progress at the point of process termination.
- Fix a crash that could occur when working with a
RLMLinkingObjectproperty of an unmanaged object.
This release is not protocol-compatible with previous version of the Realm Mobile Platform.
- Rename Realm Swift's
UsertoSyncUserto make clear that it relates to the Realm Mobile Platform, and to avoid potential conflicts with otherUsertypes.
- Fix Realm headers to be compatible with pre-C++11 dialects of Objective-C++.
- Fix incorrect merging of RLMArray/List changes when objects with the same primary key are created on multiple devices.
- Fix bad transaction log errors after deleting objects on a different device.
- Fix a BadVersion error when a background worker finishes running while older results from that worker are being delivered to a different thread.
- Fix an assertion failure when opening a Realm file written by a 1.x version of Realm which has an indexed nullable int or bool property.
This release introduces support for the Realm Mobile Platform! See https://realm.io/news/introducing-realm-mobile-platform/ for an overview of these great new features.
- By popular demand,
RealmSwift.Errorhas been moved from the top-level namespace into aRealmextension and is nowRealm.Error, so that it no longer conflicts withSwift.Error. - Files written by Realm 2.0 cannot be read by 1.x or earlier versions. Old files can still be opened.
- The .log, .log_a and .log_b files no longer exist and the state tracked in them has been moved to the main Realm file. This reduces the number of open files needed by Realm, improves performance of both opening and writing to Realms, and eliminates a small window where committing write transactions would prevent other processes from opening the file.
- Fix an assertion failure when sorting by zero properties.
- Fix a mid-commit crash in one process also crashing all other processes with the same Realm open.
- Properly initialize new nullable float and double properties added to existing objects to null rather than 0.
- Fix a stack overflow when objects with indexed string properties had very long common prefixes.
- Fix a race condition which could lead to crashes when using async queries or collection notifications.
- Fix a bug which could lead to incorrect state when an object which links to itself is deleted from the Realm.
This release brings official support for Xcode 8, Swift 2.3 and Swift 3.0. Prebuilt frameworks are now built with Xcode 7.3.1 and Xcode 8.0.
- Deprecate
migrateRealm:in favor of newperformMigrationForConfiguration:error:method that follows Cocoa's NSError conventions. - Fix issue where
RLMResultsusedidinstead of its generic type as the return type of subscript.
- Improve error message when using NSNumber incorrectly in Swift models.
- Further reduce the download size of the prebuilt static libraries.
- Improve sort performance, especially on non-nullable columns.
- Allow partial initialization of object by
initWithValue:, deferring required property checks until object is added to Realm.
- Fix incorrect truncation of the constant value for queries of the form
column < valueforfloatanddoublecolumns. - Fix crash when an aggregate is accessed as an
Int8,Int16,Int32, orInt64. - Fix a race condition that could lead to a crash if an RLMArray or List was deallocated on a different thread than it was created on.
- Fix a crash when the last reference to an observed object is released from within the observation.
- Fix a crash when
initWithValue:is used to create a nested object for a class with an uninitialized schema. - Enforce uniqueness for
RealmOptionalprimary keys when using thevaluesetter.
- Attempting to add an object with no properties to a Realm now throws rather than silently doing nothing.
- Swift: A
writeblock may nowthrow, reverting any changes already made in the transaction. - Reduce address space used when committing write transactions.
- Significantly reduce the download size of prebuilt binaries and slightly reduce the final size contribution of Realm to applications.
- Improve performance of accessing RLMArray properties and creating objects with List properties.
- Fix a crash when reading the shared schema from an observed Swift object.
- Fix crashes or incorrect results when passing an array of values to
createOrUpdateafter reordering the class's properties. - Ensure that the initial call of a Results notification block is always passed .Initial even if there is a write transaction between when the notification is added and when the first notification is delivered.
- Fix a crash when deleting all objects in a Realm while fast-enumerating query results from that Realm.
- Handle EINTR from flock() rather than crashing.
- Fix incorrect behavior following a call to
[RLMRealm compact]. - Fix live updating and notifications for Results created from a predicate involving an inverse relationship to be triggered when an object at the other end of the relationship is modified.
- None.
- Significantly improve performance of opening Realm files, and slightly improve performance of committing write transactions.
- Swift: Fix an error thrown when trying to create or update
Objectinstances viaadd(:_update:)with a primary key property of typeRealmOptional. - Xcode playground in Swift release zip now runs successfully.
- The
keyparameter ofRealm.objectForPrimaryKey(_:key:)/Realm.dynamicObjectForPrimaryKey(_:key:)is now marked as optional. - Fix a potential memory leak when closing Realms after a Realm file has been opened on multiple threads which are running in active run loops.
- Fix notifications breaking on tvOS after a very large number of write transactions have been committed.
- Fix a "Destruction of mutex in use" assertion failure after an error while opening a file.
- Realm now throws an exception if an
Objectsubclass is defined with a managed Swiftlazyproperty. Objects with ignoredlazyproperties should now work correctly. - Update the LLDB script to work with recent changes to the implementation of
RLMResults. - Fix an assertion failure when a Realm file is deleted while it is still open, and then a new Realm is opened at the same path. Note that this is still not a supported scenario, and may break in other ways.
No changes since 0.103.2.
- None.
- Improve the error messages when an I/O error occurs in
writeCopyToURL.
- Fix an assertion failure which could occur when opening a Realm after opening that Realm failed previously in some specific ways in the same run of the application.
- Reading optional integers, floats, and doubles from within a migration block
now correctly returns
nilrather than 0 when the stored value isnil.
- None.
- None.
- Fix a bug that sometimes resulted in a single object's NSData properties
changing from
nilto a zero-length non-nilNSData when a different object of the same type was deleted.
- All functionality deprecated in previous releases has been removed entirely.
- Support for Xcode 6.x & Swift prior to 2.2 has been completely removed.
RLMResults/Resultsnow become empty when aRLMArray/Listor object they depend on is deleted, rather than throwing an exception when accessed.- Migrations are no longer run when
deleteRealmIfMigrationNeededis set, recreating the file instead.
- Added
invalidatedproperties toRLMResults/Results,RLMLinkingObjects/LinkingObjects,RealmCollectionTypeandAnyRealmCollection. These properties report whether the Realm the object is associated with has been invalidated. - Some
NSErrors created by Realm now have more descriptive user info payloads.
- None.
- None.
- Return
RLMErrorSchemaMismatcherror rather than the more genericRLMErrorFailwhen a migration is required. - Improve the performance of allocating instances of
Objectsubclasses that haveLinkingObjectsproperties.
RLMLinkingObjectsproperties declared in Swift subclasses ofRLMObjectnow work correctly.- Fix an assertion failure when deleting all objects of a type, inserting more objects, and then deleting some of the newly inserted objects within a single write transaction when there is an active notification block for a different object type which links to the objects being deleted.
- Fix crashes and/or incorrect results when querying over multiple levels of
LinkingObjectsproperties. - Fix opening read-only Realms on multiple threads at once.
- Fix a
BadTransactLogexception when storing dates before the unix epoch (1970-01-01).
- None.
- Add a method to rename properties during migrations:
- Swift:
Migration.renamePropertyForClass(_:oldName:newName:) - Objective-C:
-[RLMMigration renamePropertyForClass:oldName:newName:]
- Swift:
- Add
deleteRealmIfMigrationNeededtoRLMRealmConfiguration/Realm.Configuration. When this is set totrue, the Realm file will be automatically deleted and recreated when there is a schema mismatch rather than migrated to the new schema.
- Fix
BETWEENqueries that traverseRLMArray/Listproperties to ensure that a single related object satisfies theBETWEENcriteria, rather than allowing different objects in the array to satisfy the lower and upper bounds. - Fix a race condition when a Realm is opened on one thread while it is in the middle of being closed on another thread which could result in crashes.
- Fix a bug which could result in changes made on one thread being applied incorrectly on other threads when those threads are refreshed.
- Fix crash when migrating to the new date format introduced in 0.101.0.
- Fix crash when querying inverse relationships when objects are deleted.
- Files written by this version of Realm cannot be read by older versions of Realm. Existing files will automatically be upgraded when they are opened.
- Greatly improve performance of collection change calculation for complex object graphs, especially for ones with cycles.
- NSDate properties now support nanoseconds precision.
- Opening a single Realm file on multiple threads now shares a single memory mapping of the file for all threads, significantly reducing the memory required to work with large files.
- Crashing while in the middle of a write transaction no longer blocks other processes from performing write transactions on the same file.
- Improve the performance of refreshing a Realm (including via autorefresh) when there are live Results/RLMResults objects for that Realm.
- Fix an assertion failure of "!more_before || index >= std::prev(it)->second)"
in
IndexSet::do_add(). - Fix a crash when an
RLMArrayorListobject is destroyed from the wrong thread.
-[RLMObject linkingObjectsOfClass:forProperty]andObject.linkingObjects(_:forProperty:)are deprecated in favor of properties of typeRLMLinkingObjects/LinkingObjects.
- The automatically-maintained inverse direction of relationships can now be exposed as
properties of type
RLMLinkingObjects/LinkingObjects. These properties automatically update to reflect the objects that link to the target object, can be used in queries, and can be filtered like other Realm collection types. - Queries that compare objects for equality now support multi-level key paths.
- Fix an assertion failure when a second write transaction is committed after a write transaction deleted the object containing an RLMArray/List which had an active notification block.
- Queries that compare
RLMArray/Listproperties using != now give the correct results.
- None.
- None.
- Fix a scenario that could lead to the assertion failure "m_advancer_sg->get_version_of_current_transaction() == new_notifiers.front()->version()".
- Deprecate properties of type
id/AnyObject. This type was rarely used, rarely useful and unsupported in every other Realm binding. - The block for
-[RLMArray addNotificationBlock:]and-[RLMResults addNotificationBlock:]now takes another parameter. - The following Objective-C APIs have been deprecated in favor of newer or preferred versions:
| Deprecated API | New API |
|---|---|
-[RLMRealm removeNotification:] |
-[RLMNotificationToken stop] |
RLMRealmConfiguration.path |
RLMRealmConfiguration.fileURL |
RLMRealm.path |
RLMRealmConfiguration.fileURL |
RLMRealm.readOnly |
RLMRealmConfiguration.readOnly |
+[RLMRealm realmWithPath:] |
+[RLMRealm realmWithURL:] |
+[RLMRealm writeCopyToPath:error:] |
+[RLMRealm writeCopyToURL:encryptionKey:error:] |
+[RLMRealm writeCopyToPath:encryptionKey:error:] |
+[RLMRealm writeCopyToURL:encryptionKey:error:] |
+[RLMRealm schemaVersionAtPath:error:] |
+[RLMRealm schemaVersionAtURL:encryptionKey:error:] |
+[RLMRealm schemaVersionAtPath:encryptionKey:error:] |
+[RLMRealm schemaVersionAtURL:encryptionKey:error:] |
- The following Swift APIs have been deprecated in favor of newer or preferred versions:
| Deprecated API | New API |
|---|---|
Realm.removeNotification(_:) |
NotificationToken.stop() |
Realm.Configuration.path |
Realm.Configuration.fileURL |
Realm.path |
Realm.Configuration.fileURL |
Realm.readOnly |
Realm.Configuration.readOnly |
Realm.writeCopyToPath(_:encryptionKey:) |
Realm.writeCopyToURL(_:encryptionKey:) |
schemaVersionAtPath(_:encryptionKey:error:) |
schemaVersionAtURL(_:encryptionKey:) |
- Add information about what rows were added, removed, or modified to the notifications sent to the Realm collections.
- Improve error when illegally appending to an
RLMArray/Listproperty from a default value or the standalone initializer (init()) before the schema is ready.
- Fix a use-after-free when an associated object's dealloc method is used to remove observers from an RLMObject.
- Fix a small memory leak each time a Realm file is opened.
- Return a recoverable
RLMErrorAddressSpaceExhaustederror rather than crash when there is insufficient available address space on Realm initialization or write commit.
- None.
- None.
- Fixed a bug that caused some encrypted files created using
-[RLMRealm writeCopyToPath:encryptionKey:error:]to fail to open.
- None.
- None.
- Mark further initializers in Objective-C as NS_DESIGNATED_INITIALIZER to prevent that these aren't correctly defined in Swift Object subclasses, which don't qualify for auto-inheriting the required initializers.
-[RLMResults indexOfObjectWithPredicate:]now returns correct results forRLMResultsinstances that were created by filtering anRLMArray.- Adjust how RLMObjects are destroyed in order to support using an associated object on an RLMObject to remove KVO observers from that RLMObject.
-[RLMResults indexOfObjectWithPredicate:]now returns the index of the first matching object for a sortedRLMResults, matching its documented behavior.- Fix a crash when canceling a transaction that set a relationship.
- Fix a crash when a query referenced a deleted object.
Prebuilt frameworks are now built with Xcode 7.3.
- None.
- None.
- Fix running unit tests on iOS simulators and devices with Xcode 7.3.
- None.
- None.
- Fix a crash when opening a Realm on 32-bit iOS devices.
- None.
- None.
- Properly report changes made by adding an object to a Realm with addOrUpdate:/createOrUpdate: to KVO observers for existing objects with that primary key.
- Fix crashes and assorted issues when a migration which added object link properties is rolled back due to an error in the migration block.
- Fix assertion failures when deleting objects within a migration block of a type which had an object link property added in that migration.
- Fix an assertion failure in
Query::apply_patchwhen updating certain kinds of queries after a write transaction is committed.
- Initializing the shared schema is 3x faster.
- Using Realm Objective-C from Swift while having Realm Swift linked no longer causes that the
declared
ignoredPropertiesare not taken into account. - Fix assertion failures when rolling back a migration which added Object link properties to a class.
- Fix potential errors when cancelling a write transaction which modified
multiple
RLMArray/Listproperties. - Report the correct value for inWriteTransaction after attempting to commit a write transaction fails.
- Support CocoaPods 1.0 beginning from prerelease 1.0.0.beta.4 while retaining backwards compatibility with 0.39.
- None.
- Aggregate operations (
ANY,NONE,@count,SUBQUERY, etc.) are now supported for key paths that begin with an object relationship so long as there is aRLMArray/Listproperty at some point in a key path. - Predicates of the form
%@ IN arrayPropertyare now supported.
- Use of KVC collection operators on Swift collection types no longer throws an exception.
- Fix reporting of inWriteTransaction in notifications triggered by
beginWriteTransaction. - The contents of
ListandOptionalproperties are now correctly preserved when copying a Swift object from one Realm to another, and performing other operations that result in a Swift object graph being recursively traversed from Objective-C. - Fix a deadlock when queries are performed within a Realm notification block.
- The
ANY/SOME/NONEqualifiers are now required in comparisons involving a key path that traverse aRLMArray/Listproperty. Previously they were only required if the first key in the key path was anRLMArray/Listproperty. - Fix several scenarios where the default schema would be initialized
incorrectly if the first Realm opened used a restricted class subset (via
objectClasses/objectTypes).
- Fix crashes when deleting an object containing an
RLMArray/Listwhich had previously been queried. - Fix a crash when deleting an object containing an
RLMArray/Listwith active notification blocks. - Fix duplicate file warnings when building via CocoaPods.
- Fix crash or incorrect results when calling
indexOfObject:on anRLMResultsderived from anRLMArray.
+[RLMRealm realmWithPath:]/Realm.init(path:)now inherits from the default configuration.- Swift 1.2 is no longer supported.
- Add
addNotificationBlocktoRLMResults,Results,RLMArray, andList, which calls the given block whenever the collection changes. - Do a lot of the work for keeping
RLMResults/Resultsup-to-date after write transactions on a background thread to help avoid blocking the main thread. NSPredicate'sSUBQUERYoperator is now supported. It has the following limitations:@countis the only operator that may be applied to theSUBQUERYexpression.- The
SUBQUERY(…).@countexpression must be compared with a constant. - Correlated subqueries are not yet supported.
- None.
- None.
- Swift: Added
Errorenum allowing to catch errors e.g. thrown on initializingRLMRealm/Realminstances. - Fail with
RLMErrorFileNotFoundinstead of the more genericRLMErrorFileAccess, if no file was found when a realm was opened as read-only or if the directory part of the specified path was not found when a copy should be written. - Greatly improve performance when deleting objects with one or more indexed properties.
- Indexing
BOOL/BoolandNSDateproperties are now supported. - Swift: Add support for indexing optional properties.
- Fix incorrect results or crashes when using
-[RLMResults setValue:forKey:]on an RLMResults which was filtered on the key being set. - Fix crashes when an RLMRealm is deallocated from the wrong thread.
- Fix incorrect results from aggregate methods on
Results/RLMResultsafter objects which were previously in the results are deleted. - Fix a crash when adding a new property to an existing class with over a million objects in the Realm.
- Fix errors when opening encrypted Realm files created with writeCopyToPath.
- Fix crashes or incorrect results for queries that use relationship equality
in cases where the
RLMResultsis kept alive and instances of the target class of the relationship are deleted.
- All functionality deprecated in previous releases has been removed entirely.
- Add generic type annotations to NSArrays and NSDictionaries in public APIs.
- Adding a Realm notification block on a thread not currently running from within a run loop throws an exception rather than silently never calling the notification block.
- Support for tvOS.
- Support for building Realm Swift from source when using Carthage.
- The block parameter of
-[RLMRealm transactionWithBlock:]/Realm.write(_:)is now marked as__attribute__((noescape))/@noescape. - Many forms of queries with key paths on both sides of the comparison operator are now supported.
- Add support for KVC collection operators in
RLMResultsandRLMArray. - Fail instead of deadlocking in
+[RLMRealm sharedSchema], if a Swift property is initialized to a computed value, which attempts to open a Realm on its own.
- Fix poor performance when calling
-[RLMRealm deleteObjects:]on anRLMResultswhich filtered the objects when there are other classes linking to the type of the deleted objects. - An exception is now thrown when defining
Objectproperties of an unsupported type.
- Queries are no longer limited to 16 levels of grouping.
- Rework the implementation of encrypted Realms to no longer interfere with debuggers.
- Fix crash when trying to retrieve object instances via
dynamicObjects. - Throw an exception when querying on a link providing objects, which are from a different Realm.
- Return empty results when querying on a link providing an unattached object.
- Fix crashes or incorrect results when calling
-[RLMRealm refresh]during fast enumeration. - Add
Int8support forRealmOptional,MinMaxTypeandAddableType. - Set the default value for newly added non-optional NSData properties to a zero-byte NSData rather than nil.
- Fix a potential crash when deleting all objects of a class.
- Fix performance problems when creating large numbers of objects with
RLMArray/Listproperties. - Fix memory leak when using Object(value:) for subclasses with
ListorRealmOptionalproperties. - Fix a crash when computing the average of an optional integer property.
- Fix incorrect search results for some queries on integer properties.
- Add error-checking for nil realm parameters in many methods such as
+[RLMObject allObjectsInRealm:]. - Fix a race condition between commits and opening Realm files on new threads that could lead to a crash.
- Fix several crashes when opening Realm files.
-[RLMObject createInRealm:withValue:],-[RLMObject createOrUpdateInRealm:withValue:], and their variants for the default Realm now always match the contents of anNSArrayagainst properties in the same order as they are defined in the model.
Prebuilt frameworks are now built with Xcode 7.1.
- Fix ignoring optional properties in Swift.
- Fix CocoaPods installation on case-sensitive file systems.
- Support assigning
ResultstoListproperties via KVC. - Honor the schema version set in the configuration in
+[RLMRealm migrateRealm:]. - Fix crash when using optional Int16/Int32/Int64 properties in Swift.
- No functional changes since beta2.
- Add RLMOptionalBase.h to the podspec.
- CocoaPods v0.38 or greater is now required to install Realm and RealmSwift as pods.
- Functionality common to both
ListandResultsis now declared in aRealmCollectionTypeprotocol that both types conform to. Results.realmnow returns anOptional<Realm>in order to conform toRealmCollectionType, but will always return.Some()since aResultscannot exist independently from aRealm.- Aggregate operations are now available on
List:min,max,sum,average. - Committing write transactions (via
commitWrite/commitWriteTransactionandwrite/transactionWithBlock) now optionally allow for handling errors when the disk is out of space. - Added
isEmptyproperty onRLMRealm/Realmto indicate if it contains any objects. - The
@count,@min,@max,@sumand@avgcollection operators are now supported in queries.
- Fix assertion failure when inserting NSData between 8MB and 16MB in size.
- Fix assertion failure when rolling back a migration which removed an object
link or
RLMArray/Listproperty. - Add the path of the file being opened to file open errors.
- Fix a crash that could be triggered by rapidly opening and closing a Realm many times on multiple threads at once.
- Fix several places where exception messages included the name of the wrong function which failed.
- Compile iOS Simulator framework architectures with
-fembed-bitcode-marker. - Fix crashes when the first Realm opened uses a class subset and later Realms opened do not.
- Fix inconsistent errors when
Object(value: ...)is used to initialize the default value of a property of anObjectsubclass. - Throw an exception when a class subset has objects with array or object properties of a type that are not part of the class subset.
- Enable bitcode for iOS and watchOS frameworks.
- Build libraries with Xcode 7 final rather than the GM.
- Add missing KVO handling for moving and exchanging objects in
RLMArrayandList.
- Setting the primary key property on persisted
RLMObjects /Objects via subscripting or key-value coding will cause an exception to be thrown. - Fix crash due to race condition in
RLMRealmConfigurationwhere the default configuration was in the process of being copied in one thread, while released in another. - Fix crash when a migration which removed an object or array property is rolled back due to an error.
- The following APIs have been deprecated in favor of the new
RLMRealmConfigurationclass in Realm Objective-C:
| Deprecated API | New API |
|---|---|
+[RLMRealm realmWithPath:readOnly:error:] |
+[RLMRealm realmWithConfiguration:error:] |
+[RLMRealm realmWithPath:encryptionKey:readOnly:error:] |
+[RLMRealm realmWithConfiguration:error:] |
+[RLMRealm setEncryptionKey:forRealmsAtPath:] |
-[RLMRealmConfiguration setEncryptionKey:] |
+[RLMRealm inMemoryRealmWithIdentifier:] |
+[RLMRealm realmWithConfiguration:error:] |
+[RLMRealm defaultRealmPath] |
+[RLMRealmConfiguration defaultConfiguration] |
+[RLMRealm setDefaultRealmPath:] |
+[RLMRealmConfiguration setDefaultConfiguration:] |
+[RLMRealm setDefaultRealmSchemaVersion:withMigrationBlock] |
RLMRealmConfiguration.schemaVersion and RLMRealmConfiguration.migrationBlock |
+[RLMRealm setSchemaVersion:forRealmAtPath:withMigrationBlock:] |
RLMRealmConfiguration.schemaVersion and RLMRealmConfiguration.migrationBlock |
+[RLMRealm migrateRealmAtPath:] |
+[RLMRealm migrateRealm:] |
+[RLMRealm migrateRealmAtPath:encryptionKey:] |
+[RLMRealm migrateRealm:] |
- The following APIs have been deprecated in favor of the new
Realm.Configurationstruct in Realm Swift for Swift 1.2:
| Deprecated API | New API |
|---|---|
Realm.defaultPath |
Realm.Configuration.defaultConfiguration |
Realm(path:readOnly:encryptionKey:error:) |
Realm(configuration:error:) |
Realm(inMemoryIdentifier:) |
Realm(configuration:error:) |
Realm.setEncryptionKey(:forPath:) |
Realm(configuration:error:) |
setDefaultRealmSchemaVersion(schemaVersion:migrationBlock:) |
Realm.Configuration.schemaVersion and Realm.Configuration.migrationBlock |
setSchemaVersion(schemaVersion:realmPath:migrationBlock:) |
Realm.Configuration.schemaVersion and Realm.Configuration.migrationBlock |
migrateRealm(path:encryptionKey:) |
migrateRealm(configuration:) |
- The following APIs have been deprecated in favor of the new
Realm.Configurationstruct in Realm Swift for Swift 2.0:
| Deprecated API | New API |
|---|---|
Realm.defaultPath |
Realm.Configuration.defaultConfiguration |
Realm(path:readOnly:encryptionKey:) throws |
Realm(configuration:) throws |
Realm(inMemoryIdentifier:) |
Realm(configuration:) throws |
Realm.setEncryptionKey(:forPath:) |
Realm(configuration:) throws |
setDefaultRealmSchemaVersion(schemaVersion:migrationBlock:) |
Realm.Configuration.schemaVersion and Realm.Configuration.migrationBlock |
setSchemaVersion(schemaVersion:realmPath:migrationBlock:) |
Realm.Configuration.schemaVersion and Realm.Configuration.migrationBlock |
migrateRealm(path:encryptionKey:) |
migrateRealm(configuration:) |
-
List.extendin Realm Swift for Swift 2.0 has been replaced withList.appendContentsOf, mirroring changes toRangeReplaceableCollectionType. -
Object properties on
Objectsubclasses in Realm Swift must be marked as optional, otherwise a runtime exception will be thrown.
- Persisted properties of
RLMObject/Objectsubclasses are now Key-Value Observing compliant. - The different options used to create Realm instances have been consolidated
into a single
RLMRealmConfiguration/Realm.Configurationobject. - Enumerating Realm collections (
RLMArray,RLMResults,List<>,Results<>) now enumerates over a copy of the collection, making it no longer an error to modify a collection during enumeration (either directly, or indirectly by modifying objects to make them no longer match a query). - Improve performance of object insertion in Swift to bring it roughly in line with Objective-C.
- Allow specifying a specific list of
RLMObject/Objectsubclasses to include in a given Realm viaRLMRealmConfiguration.objectClasses/Realm.Configuration.objectTypes.
- Subscripting on
RLMObjectis now marked as nullable.
- Building for watchOS requires Xcode 7 beta 5.
Object.classNameis now marked asfinal.
- Fix crash when adding a property to a model without updating the schema version.
- Fix unnecessary redownloading of the core library when building from source.
- Fix crash when sorting by an integer or floating-point property on iOS 7.
- None.
- Reduce the amount of memory used by RLMRealm notification listener threads.
- Avoid evaluating results eagerly when filtering and sorting.
- Add nullability annotations to the Objective-C API to provide enhanced compiler warnings and bridging to Swift.
- Make
RLMResults andRLMArrays support Objective-C generics. - Add support for building watchOS and bitcode-compatible apps.
- Make the exceptions thrown in getters and setters more informative.
- Add
-[RLMArray exchangeObjectAtIndex:withObjectAtIndex]andList.swap(_:_:)to allow exchanging the location of two objects in the givenRLMArray/List. - Added anonymous analytics on simulator/debugger runs.
- Add
-[RLMArray moveObjectAtIndex:toIndex:]andList.move(from:to:)to allow moving objects in the givenRLMArray/List.
- Processes crashing due to an uncaught exception inside a write transaction will no longer cause other processes using the same Realm to hang indefinitely.
- Fix incorrect results when querying for < or <= on ints that require 64 bits to represent with a CPU that supports SSE 4.2.
- An exception will no longer be thrown when attempting to reset the schema version or encryption key on an open Realm to the current value.
- Date properties on 32 bit devices will retain 64 bit second precision.
- Wrap calls to the block passed to
enumeratein an autoreleasepool to reduce memory growth when migrating a large amount of objects. - In-memory realms no longer write to the Documents directory on iOS or Application Support on OS X.
- Fixed an issue where the packaged OS X Realm.framework was built with
GCC_GENERATE_TEST_COVERAGE_FILESandGCC_INSTRUMENT_PROGRAM_FLOW_ARCSenabled. - Fix a memory leak when constructing standalone Swift objects with NSDate properties.
- Throw an exception rather than asserting when an invalidated object is added to an RLMArray.
- Fix a case where data loss would occur if a device was hard-powered-off shortly after a write transaction was committed which had to expand the Realm file.
- Objects are no longer copied into standalone objects during object creation. This fixes an issue where nested objects with a primary key are sometimes duplicated rather than updated.
- Comparison predicates with a constant on the left of the operator and key path on the right now give correct results. An exception is now thrown for predicates that do not yet support this ordering.
- Fix some crashes in
index_string.cppwith int primary keys or indexed int properties.
- Schema versions are now represented as
uint64_t(Objective-C) andUInt64(Swift) so that they have the same representation on all architectures.
- Swift:
Resultsnow conforms toCVarArgTypeso it can now be passed as an argument toResults.filter(_:...)andList.filter(_:...). - Swift: Made
SortDescriptorconform to theEquatableandStringLiteralConvertibleprotocols. - Int primary keys are once again automatically indexed.
- Improve error reporting when attempting to mark a property of a type that cannot be indexed as indexed.
- Swift:
RealmSwift.frameworkno longer embedsRealm.framework, which now allows apps using it to pass iTunes Connect validation.
- None.
- Swift: Made
Object.init()a required initializer. RLMObject,RLMResults,ObjectandResultscan now be safely deallocated (but still not used) from any thread.- Improve performance of
-[RLMArray indexOfObjectWhere:]and-[RLMArray indexOfObjectWithPredicate:], and implement them for standalone RLMArrays. - Improved performance of most simple queries.
- The interprocess notification mechanism no longer uses dispatch worker threads, preventing it from starving other GCD clients of the opportunity to execute blocks when dozens of Realms are open at once.
- Swift:
Results.average(_:)now returns an optional, which isnilif and only if the results set is empty.
- Swift: Added
List.invalidated, which returns if the givenListis no longer safe to be accessed, and is analogous to-[RLMArray isInvalidated]. - Assertion messages are automatically logged to Crashlytics if it's loaded into the current process to make it easier to diagnose crashes.
- Swift: Enumerating through a standalone
Listwhose objects themselves have list properties won't crash. - Swift: Using a subclass of
RealmSwift.Objectin an aggregate operator of a predicate no longer throws a spurious type error. - Fix incorrect results for when using OR in a query on a
RLMArray/List<>. - Fix incorrect values from
[RLMResults count]/Results.countwhen using!=on an int property with no other query conditions. - Lower the maximum doubling threshold for Realm file sizes from 128MB to 16MB to reduce the amount of wasted space.
- None.
- Exceptions raised when incorrect object types are used with predicates now contain more detailed information.
- Added
-[RLMMigration deleteDataForClassName:]andMigration.deleteData(_:)to enable cleaning up after removing object subclasses
- Prevent debugging of an application using an encrypted Realm to work around frequent LLDB hangs. Until the underlying issue is addressed you may set REALM_DISABLE_ENCRYPTION=YES in your application's environment variables to have requests to open an encrypted Realm treated as a request for an unencrypted Realm.
- Linked objects are properly updated in
createOrUpdateInRealm:withValue:. - List properties on Objects are now properly initialized during fast enumeration.
- None.
-[RLMRealm inWriteTransaction]is now public.- Realm Swift is now available on CoocaPods.
- Force code re-signing after stripping architectures in
strip-frameworks.sh.
- Migration blocks are no longer called when a Realm file is first created.
- The following APIs have been deprecated in favor of newer method names:
| Deprecated API | New API |
|---|---|
-[RLMMigration createObject:withObject:] |
-[RLMMigration createObject:withValue:] |
-[RLMObject initWithObject:] |
-[RLMObject initWithValue:] |
+[RLMObject createInDefaultRealmWithObject:] |
+[RLMObject createInDefaultRealmWithValue:] |
+[RLMObject createInRealm:withObject:] |
+[RLMObject createInRealm:withValue:] |
+[RLMObject createOrUpdateInDefaultRealmWithObject:] |
+[RLMObject createOrUpdateInDefaultRealmWithValue:] |
+[RLMObject createOrUpdateInRealm:withObject:] |
+[RLMObject createOrUpdateInRealm:withValue:] |
Int8properties defined in Swift are now treated as integers, rather than booleans.- NSPredicates created using
+predicateWithValue:are now supported.
- Compound AND predicates with no subpredicates now correctly match all objects.
- Fix issues with removing search indexes and re-enable it.
- Temporarily disable removing indexes from existing columns due to bugs.
- Fix
Extra argument 'objectClassName' in callerrors when building via CocoaPods.
- Migration blocks are no longer called when a Realm file is first created.
RLMCollectionsupports collection KVC operations.- Sorting
RLMResultsis 2-5x faster (typically closer to 2x). - Refreshing
RLMRealmafter a write transaction which inserts or modifies strings orNSDatais committed on another thread is significantly faster. - Indexes are now added and removed from existing properties when a Realm file is opened, rather than only when properties are first added.
+[RLMSchema dynamicSchemaForRealm:]now respects search indexes.+[RLMProperty isEqualToProperty:]now checks for equalindexedproperties.
- The browser will automatically refresh when the Realm has been modified from another process.
- Allow using Realm in an embedded framework by setting
APPLICATION_EXTENSION_API_ONLYto YES.
- Fix a crash in CFRunLoopSourceInvalidate.
attributesForProperty:has been removed fromRLMObject. You now specify indexed properties by implementing theindexedPropertiesmethod.- An exception will be thrown when calling
setEncryptionKey:forRealmsAtPath:,setSchemaVersion:forRealmAtPath:withMigrationBlock:, andmigrateRealmAtPath:when a Realm at the given path is already open. - Object and array properties of type
RLMObjectwill no longer be allowed.
- Add support for sharing Realm files between processes.
- The browser will no longer show objects that have no persisted properties.
RLMSchema,RLMObjectSchema, andRLMPropertynow have more useful descriptions.- Opening an encrypted Realm while a debugger is attached to the process no longer throws an exception.
RLMArraynow exposes anisInvalidatedproperty to indicate if it can no longer be accessed.
- An exception will now be thrown when calling
-beginWriteTransactionfrom within a notification triggered by calling-beginWriteTransactionelsewhere. - When calling
delete:we now verify that the object being deleted is persisted in the target Realm. - Fix crash when calling
createOrUpdate:inRealmwith nested linked objects. - Use the key from
+[RLMRealm setEncryptionKey:forRealmsAtPath:]in-writeCopyToPath:error:and+migrateRealmAtPath:. - Comparing an RLMObject to a non-RLMObject using
-[RLMObject isEqual:]or-isEqualToObject:now returns NO instead of crashing. - Improved error message when an
RLMObjectsubclass is defined nested within another Swift declaration. - Fix crash when the process is terminated by the OS on iOS while encrypted realms are open.
- Fix crash after large commits to encrypted realms.
- Improve compatiblity of encrypted Realms with third-party crash reporters.
- Fix incorrect results when using aggregate functions on sorted RLMResults.
- Fix data corruption when using writeCopyToPath:encryptionKey:.
- Maybe fix some assertion failures.
- Fix for crashes when encryption is enabled on 64-bit iOS devices.
- Fix bug that resulted in columns being dropped and recreated during migrations.
- Calling
createInDefaultRealmWithObject:,createInRealm:withObject:,createOrUpdateInDefaultRealmWithObject:orcreateOrUpdateInRealm:withObject:is a no-op if the argument is an RLMObject of the same type as the receiver and is already backed by the target realm.
- Fix incorrect column type assertions when the first Realm file opened is a read-only file that is missing tables.
- Throw an exception when adding an invalidated or deleted object as a link.
- Throw an exception when calling
createOrUpdateInRealm:withObject:when the receiver has no primary key defined.
- Fix for RLMObject being treated as a model object class and showing up in the browser.
- Fix compilation from the podspec.
- Fix for crash when calling
objectsWhere:with grouping in the query onallObjects.
- Rename
-[RLMRealm encryptedRealmWithPath:key:readOnly:error:]to-[RLMRealm realmWithPath:encryptionKey:readOnly:error:]. -[RLMRealm setSchemaVersion:withMigrationBlock]is no longer global and must be called for each individual Realm path used. You can now call-[RLMRealm setDefaultRealmSchemaVersion:withMigrationBlock]for the default Realm and-[RLMRealm setSchemaVersion:forRealmAtPath:withMigrationBlock:]for all others;
- Add
-[RLMRealm writeCopyToPath:encryptionKey:error:]. - Add support for comparing string columns to other string columns in queries.
- Roll back changes made when an exception is thrown during a migration.
- Throw an exception if the number of items in a RLMResults or RLMArray changes while it's being fast-enumerated.
- Also encrypt the temporary files used when encryption is enabled for a Realm.
- Fixed crash in JSONImport example on OS X with non-en_US locale.
- Fixed infinite loop when opening a Realm file in the Browser at the same time as it is open in a 32-bit simulator.
- Fixed a crash when adding primary keys to older realm files with no primary keys on any objects.
- Fixed a crash when removing a primary key in a migration.
- Fixed a crash when multiple write transactions with no changes followed by a write transaction with changes were committed without the main thread RLMRealm getting a chance to refresh.
- Fixed incomplete results when querying for non-null relationships.
- Improve the error message when a Realm file is opened in multiple processes at once.
- None.
- None.
- Fix an assertion failure when invalidating a Realm which is in a write transaction, has already been invalidated, or has never been used.
- Fix an assertion failure when sorting an empty RLMArray property.
- Fix a bug resulting in the browser never becoming visible on 10.9.
- Write UTF-8 when generating class files from a realm file in the Browser.
- None.
- Improve the error message when a Realm can't be opened due to lacking write permissions.
- Fix an assertion failure when inserting rows after calling
deleteAllObjectson a Realm. - Separate dynamic frameworks are now built for the simulator and devices to work around App Store submission errors due to the simulator version not being automatically stripped from dynamic libraries.
- None.
- Add support for encrypting Realm files on disk.
- Support using KVC-compliant objects without getters or with custom getter
names to initialize RLMObjects with
createObjectInRealmand friends.
- Merge native Swift default property values with defaultPropertyValues().
- Don't leave the database schema partially updated when opening a realm fails due to a migration being needed.
- Fixed issue where objects with custom getter names couldn't be used to initialize other objects.
- Fix a major performance regression on queries on string properties.
- Fix a memory leak when circularly linked objects are added to a Realm.
- Deallocating an RLMRealm instance in a write transaction lacking an explicit commit/cancel will now be automatically cancelled instead of committed.
-[RLMObject isDeletedFromRealm]has been renamed to-[RLMObject isInvalidated].
- Add
-[RLMRealm writeCopyToPath:]to write a compacted copy of the Realm another file. - Add support for case insensitive, BEGINSWITH, ENDSWITH and CONTAINS string queries on array properties.
- Make fast enumeration of
RLMArrayandRLMResults~30% faster andobjectAtIndex:~55% faster. - Added a lldb visualizer script for displaying the contents of persisted RLMObjects when debugging.
- Added method
-setDefaultRealmPath:to change the default Realm path. - Add
-[RLMRealm invalidate]to release data locked by the current thread.
- Fix for crash when running many simultaneous write transactions on background threads.
- Fix for crashes caused by opening Realms at multiple paths simultaneously which have had properties re-ordered during migration.
- Don't run the query twice when
firstObjectorlastObjectare called on anRLMResultswhich has not had its results accessed already. - Fix for bug where schema version is 0 for new Realm created at the latest version.
- Fix for error message where no migration block is specified when required.
- None.
- None.
- Fix browser location in release zip.
- None.
- Added method
-linkingObjectsOfClass:forProperty:to RLMObject to expose inverse relationships/backlinks.
- Fix for crash due to missing search index when migrating an object with a string primary key in a database created using an older versions (0.86.3 and earlier).
- Throw an exception when passing an array containing a non-RLMObject to -[RLMRealm addObjects:].
- Fix for crash when deleting an object from multiple threads.
- RLMArray has been split into two classes,
RLMArrayandRLMResults. RLMArray is used for object properties as in previous releases. Moving forward all methods used to enumerate, query, and sort objects return an instance of a new classRLMResults. This change was made to support diverging apis and the future addition of change notifications for queries. - The api for migrations has changed. You now call
setSchemaVersion:withMigrationBlock:to register a global migration block and associated version. This block is applied to Realms as needed when opened for Realms at a previous version. The block can be applied manually if desired by callingmigrateRealmAtPath:. arraySortedByProperty:ascending:was renamed tosortedResultsUsingProperty:ascendingaddObjectsFromArray:on bothRLMRealmandRLMArrayhas been renamed toaddObjects:and now accepts any container class which implementsNSFastEnumeration- Building with Swift support now requires Xcode 6.1
- Add support for sorting
RLMArrays by multiple columns withsortedResultsUsingDescriptors: - Added method
deleteAllObjectsonRLMRealmto clear a Realm. - Added method
createObject:withObject:onRLMMigrationwhich allows object creation during migrations. - Added method
deleteObject:onRLMMigrationwhich allows object deletion during migrations. - Updating to core library version 0.85.0.
- Implement
objectsWhere:andobjectsWithPredicate:for array properties. - Add
cancelWriteTransactionto revert all changes made in a write transaction and end the transaction. - Make creating
RLMRealminstances on background threads when an instance exists on another thread take a fifth of the time. - Support for partial updates when calling
createOrUpdateWithObject:andaddOrUpdateObject: - Re-enable Swift support on OS X
- Fix exceptions when trying to set
RLMObjectproperties after rearranging the properties in aRLMObjectsubclass. - Fix crash on IN query with several thousand items.
- Fix crash when querying indexed
NSStringproperties. - Fixed an issue which prevented in-memory Realms from being used accross multiple threads.
- Preserve the sort order when querying a sorted
RLMResults. - Fixed an issue with migrations where if a Realm file is deleted after a Realm is initialized, the newly created Realm can be initialized with an incorrect schema version.
- Fix crash in
RLMSuperSetwhen assigning to aRLMArrayproperty on a standalone object. - Add an error message when the protocol for an
RLMArrayproperty is not a valid object type. - Add an error message when an
RLMObjectsubclass is defined nested within another Swift class.
- Add support for != in queries on object relationships.
- Re-adding an object to its Realm no longer throws an exception and is now a no-op (as it was previously).
- Fix another bug which would sometimes result in subclassing RLMObject subclasses not working.
- Fixed issues with packaging "Realm Browser.app" for release.
- Fix a bug which would sometimes result in subclassing RLMObject subclasses not working.
- Xcode 6 is now supported from the main Xcode project
Realm.xcodeproj. Xcode 5 is no longer supported.
- Support subclassing RLMObject models. Although you can now persist subclasses, polymorphic behavior is not supported (i.e. setting a property to an instance of its subclass).
- Add support for sorting RLMArray properties.
- Speed up inserting objects with
addObject:by ~20%. readonlyproperties are automatically ignored rather than having to be added toignoredProperties.- Updating to core library version 0.83.1.
- Return "[deleted object]" rather than throwing an exception when
-descriptionis called on a deleted RLMObject. - Significantly improve performance of very large queries.
- Allow passing any enumerable to IN clauses rather than just NSArray.
- Add
objectForPrimaryKey:andobjectInRealm:forPrimaryKey:convenience methods to fetch an object by primary key.
- Fix error about not being able to persist property 'hash' with incompatible type when building for devices with Xcode 6.
- Fix spurious notifications of new versions of Realm.
- Fix for updating nested objects where some types do not have primary keys.
- Fix for inserting objects from JSON with NSNull values when default values should be used.
- Trying to add a persisted RLMObject to a different Realm now throws an exception rather than creating an uninitialized object.
- Fix validation errors when using IN on array properties.
- Fix errors when an IN clause has zero items.
- Fix for chained queries ignoring all but the last query's conditions.
- Notifications for a refresh being needed (when autorefresh is off) now send the notification type RLMRealmRefreshRequiredNotification rather than RLMRealmDidChangeNotification.
- Updating to core library version 0.83.0.
- Support for primary key properties (for int and string columns). Declaring a property to be the primary key ensures uniqueness for that property for all objects of a given type. At the moment indexes on primary keys are not yet supported but this will be added in a future release.
- Added methods to update or insert (upsert) for objects with primary keys defined.
[RLMObject initWithObject:]and[RLMObject createInRealmWithObject:]now support any object type with kvc properties.- The Swift support has been reworked to work around Swift not being supported in Frameworks on iOS 7.
- Improve performance when getting the count of items matching a query but not reading any of the objects in the results.
- Add a return value to
-[RLMRealm refresh]that indicates whether or not there was anything to refresh. - Add the class name to the error message when an RLMObject is missing a value for a property without a default.
- Add support for opening Realms in read-only mode.
- Add an automatic check for updates when using Realm in a simulator (the checker code is not compiled into device builds). This can be disabled by setting the REALM_DISABLE_UPDATE_CHECKER environment variable to any value.
- Add support for Int16 and Int64 properties in Swift classes.
- Realm change notifications when beginning a write transaction are now sent after updating rather than before, to match refresh.
-isEqual:now uses the defaultNSObjectimplementation unless a primary key is specified for an RLMObject. When a primary key is specified,-isEqual:calls-isEqualToObject:and a corresponding implementation for-hashis also implemented.
- The timer used to trigger notifications has been removed. Notifications are now only triggered by commits made in other threads, and can not currently be triggered by changes made by other processes. Interprocess notifications will be re-added in a future commit with an improved design.
- Updating to core library version 0.82.2.
- Add property
deletedFromRealmto RLMObject to indicate objects which have been deleted. - Add support for the IN operator in predicates.
- Add support for the BETWEEN operator in link queries.
- Add support for multi-level link queries in predicates (e.g.
foo.bar.baz = 5). - Switch to building the SDK from source when using CocoaPods and add a Realm.Headers subspec for use in targets that should not link a copy of Realm (such as test targets).
- Allow unregistering from change notifications in the change notification handler block.
- Significant performance improvements when holding onto large numbers of RLMObjects.
- Realm-Xcode6.xcodeproj now only builds using Xcode6-Beta6.
- Improved performance during RLMArray iteration, especially when mutating contained objects.
- Fix crashes and assorted bugs when sorting or querying a RLMArray returned from a query.
- Notifications are no longer sent when initializing new RLMRealm instances on background threads.
- Handle object cycles in -[RLMObject description] and -[RLMArray description].
- Lowered the deployment target for the Xcode 6 projects and Swift examples to iOS 7.0, as they didn't actually require 8.0.
- Support setting model properties starting with the letter 'z'
- Fixed crashes that could result from switching between Debug and Relase builds of Realm.
- Realm-Xcode6.xcodeproj now only builds using Xcode6-Beta5.
- Properties to be persisted in Swift classes must be explicitly declared as
dynamic. - Subclasses of RLMObject subclasses now throw an exception on startup, rather than when added to a Realm.
- Add support for querying for nil object properties.
- Improve error message when specifying invalid literals when creating or initializing RLMObjects.
- Throw an exception when an RLMObject is used from the incorrect thread rather than crashing in confusing ways.
- Speed up RLMRealm instantiation and array property iteration.
- Allow array and objection relation properties to be missing or null when creating a RLMObject from a NSDictionary.
- Fixed a memory leak when querying for objects.
- Fixed initializing array properties on standalone Swift RLMObject subclasses.
- Fix for queries on 64bit integers.
- Realm-Xcode6.xcodeproj now only builds using Xcode6-Beta4.
- Updating to core library version 0.80.5.
- Now support disabling the
autorefreshproperty on RLMRealm instances. - Building Realm-Xcode6 for iOS now builds a universal framework for Simulator & Device.
- Using NSNumber properties (unsupported) now throws a more informative exception.
- Added
[RLMRealm defaultRealmPath] - Proper implementation for [RLMArray indexOfObjectWhere:]
- The default Realm path on OS X is now ~/Library/Application Support/[bundle identifier]/default.realm rather than ~/Documents
- We now check that the correct framework (ios or osx) is used at compile time.
- Fixed rapid growth of the realm file size.
- Fixed a bug which could cause a crash during RLMArray destruction after a query.
- Fixed bug related to querying on float properties:
floatProperty = 1.7now works. - Fixed potential bug related to the handling of array properties (RLMArray).
- Fixed bug where array properties accessed the wrong property.
- Fixed bug that prevented objects with custom getters to be added to a Realm.
- Fixed a bug where initializing a standalone object with an array literal would trigger an exception.
- Clarified exception messages when using unsupported NSPredicate operators.
- Clarified exception messages when using unsupported property types on RLMObject subclasses.
- Fixed a memory leak when breaking out of a for-in loop on RLMArray.
- Fixed a memory leak when removing objects from a RLMArray property.
- Fixed a memory leak when querying for objects.
- None.
- Updating to core library version 0.80.3.
- Added support for basic querying of RLMObject and RLMArray properties (one-to-one and one-to-many relationships).
e.g.
[Person objectsWhere:@"dog.name == 'Alfonso'"]or[Person objectsWhere:@"ANY dogs.name == 'Alfonso'"]Supports all normal operators for numeric and date types. Does not support NSData properties orBEGINSWITH,ENDSWITH,CONTAINSand other options for string properties. - Added support for querying for object equality in RLMObject and RLMArray properties (one-to-one and one-to-many relationships).
e.g.
[Person objectsWhere:@"dog == %@", myDog][Person objectsWhere:@"ANY dogs == %@", myDog][Person objectsWhere:@"ANY friends.dog == %@", dog]Only supports comparing objects for equality (i.e. ==) - Added a helper method to RLMRealm to perform a block inside a transaction.
- OSX framework now supported in CocoaPods.
- Fixed Unicode support in property names and string contents (Chinese, Russian, etc.). Closing #612 and #604.
- Fixed bugs related to migration when properties are removed.
- Fixed keyed subscripting for standalone RLMObjects.
- Fixed bug related to double clicking on a .realm file to launch the Realm Browser (thanks to Dean Moore).
- Rename migration methods to -migrateDefaultRealmWithBlock: and -migrateRealmAtPath:withBlock:
- Moved Realm specific query methods from RLMRealm to class methods on RLMObject (-allObjects: to +allObjectsInRealm: ect.)
- Added +createInDefaultRealmWithObject: method to RLMObject.
- Added support for array and object literals when calling -createWithObject: and -initWithObject: variants.
- Added method -deleteObjects: to batch delete objects from a Realm
- Support for defining RLMObject models entirely in Swift (experimental, see known issues).
- RLMArrays in Swift support Sequence-style enumeration (for obj in array).
- Implemented -indexOfObject: for RLMArray
- Properties other than String, NSData and NSDate require a default value in the model. This can be an empty (but typed) array for array properties.
- The previous caveat also implies that not all models defined in Objective-C can be used for object properties. Only Objective-C models with only implicit (i.e. primitives) or explicit default values can be used. However, any Objective-C model object can be used in a Swift array property.
- Array property accessors don't work until its parent object has been added to a realm.
- Realm-Bridging-Header.h is temporarily exposed as a public header. This is temporary and will be private again once rdar://17633863 is fixed.
- Does not leverage Swift generics and still uses RLM-prefix everywhere. This is coming in #549.
- Rename schemaForObject: to schemaForClassName: on RLMSchema
- Removed -objects:where: and -objects:orderedBy:where: from RLMRealm
- Removed -indexOfObjectWhere:, -objectsWhere: and -objectsOrderedBy:where: from RLMArray
- Removed +objectsWhere: and +objectsOrderedBy:where: from RLMObject
- New Xcode 6 project for experimental swift support.
- New Realm Editor app for reading and editing Realm db files.
- Added support for migrations.
- Added support for RLMArray properties on objects.
- Added support for creating in-memory default Realm.
- Added -objectsWithClassName:predicateFormat: and -objectsWithClassName:predicate: to RLMRealm
- Added -indexOfObjectWithPredicateFormat:, -indexOfObjectWithPredicate:, -objectsWithPredicateFormat:, -objectsWithPredi
- Added +objectsWithPredicateFormat: and +objectsWithPredicate: to RLMObject
- Now allows predicates comparing two object properties of the same type.
Completely rewritten to be much more object oriented.
- Everything
- None.
- None.
The Objective-C API has been updated and your code will break!
RLMTableobjects can only be created with anRLMRealmobject.- Renamed
RLMContexttoRLMTransactionManager - Renamed
RLMContextDidChangeNotificationtoRLMRealmDidChangeNotification - Renamed
contextWithDefaultPersistencetomanagerForDefaultRealm - Renamed
contextPersistedAtPath:tomanagerForRealmWithPath: - Renamed
realmWithDefaultPersistencetodefaultRealm - Renamed
realmWithDefaultPersistenceAndInitBlocktodefaultRealmWithInitBlock - Renamed
find:tofirstWhere: - Renamed
where:toallWhere: - Renamed
where:orderBy:toallWhere:orderBy:
- Added
countWhere:onRLMTable - Added
sumOfColumn:where:onRLMTable - Added
averageOfColumn:where:onRLMTable - Added
minOfProperty:where:onRLMTable - Added
maxOfProperty:where:onRLMTable - Added
toJSONStringonRLMRealm,RLMTableandRLMView - Added support for
NOToperator in predicates - Added support for default values
- Added validation support in
createInRealm:withObject:
- None.
TightDB is now Realm! The Objective-C API has been updated and your code will break!
- All references to TightDB have been changed to Realm.
- All prefixes changed from
TDBtoRLM. TDBTransactionandTDBSmartContexthave merged intoRLMRealm.- Write transactions now take an optional rollback parameter (rather than needing to return a boolean).
addColumnWithName:and variant methods now return the index of the newly created column if successful,NSNotFoundotherwise.
createTableWithName:columns:has been added toRLMRealm.- Added keyed subscripting for RLMTable's first column if column is of type RLMPropertyTypeString.
setRow:atIndex:has been added toRLMTable.RLMRealmconstructors now have variants that take an writable initialization block- New object interface - tables created/retrieved using
tableWithName:objectClass:return custom objects
- None.
contextWithPersistenceToFile:error:renamed tocontextPersistedAtPath:error:inTDBContextreadWithBlock:renamed toreadUsingBlock:inTDBContextwriteWithBlock:error:renamed towriteUsingBlock:error:inTDBContextreadTable:withBlock:renamed toreadTable:usingBlock:inTDBContextwriteTable:withBlock:error:renamed towriteTable:usingBlock:error:inTDBContextfindFirstRowrenamed toindexOfFirstMatchingRowonTDBQuery.findFirstRowFromIndex:renamed toindexOfFirstMatchingRowFromIndex:onTDBQuery.- Return
NSNotFoundinstead of -1 when appropriate. - Renamed
castClasstocastToTytpedTableClassonTDBTable. removeAllRows,removeRowAtIndex,removeLastRow,addRowandinsertRowmethods on table now return void instead of BOOL.
- A
TDBTablecan now be queried usingwhere:andwhere:orderBy:takingNSPredicateandNSSortDescriptoras arguments. - Added
find:method onTDBTableto find first row matching predicate. contextWithDefaultPersistenceclass method added toTDBContext. Will create a context persisted to a file in app/documents folder.renameColumnWithIndex:to:has been added toTDBTable.distinctValuesInColumnWithIndexhas been added toTDBTable.dateIsBetween::,doubleIsBetween::,floatIsBetween::andintIsBetween::have been added toTDBQuery.- Column names in Typed Tables can begin with non-capital letters too. The generated
addXselector can look odd. For example, a table with one column with nameage, appending a new row will look like[table addage:7]. - Mixed typed values are better validated when rows are added, inserted, or modified as object literals.
addRow,insertRow, and row updates can be done using objects derived fromNSObject.wherehas been added toTDBViewandTDBViewProtocol.- Adding support for "smart" contexts (
TDBSmartContext).
- Modifications of a
TDBViewandTDBQuerynow throw an exception in a readtransaction.
The Objective-C API has been updated and your code will break!
Of notable changes a fast interface has been added.
This interface includes specific methods to get and set values into Tightdb.
To use these methods import <Tightdb/TightdbFast.h>.
getTableWithName:renamed totableWithName:inTDBTransaction.addColumnWithName:andType:renamed toaddColumnWithName:type:inTDBTable.columnTypeOfColumn:renamed tocolumnTypeOfColumnWithIndexinTDBTable.columnNameOfColumn:renamed tonameOfColumnWithIndex:inTDBTable.addColumnWithName:andType:renamed toaddColumnWithName:type:inTDBDescriptor.- Fast getters and setters moved from
TDBRow.htoTDBRowFast.h.
- Added
minDateInColumnWithIndexandmaxDateInColumnWithIndextoTDBQuery. - Transactions can now be started directly on named tables.
- You can create dynamic tables with initial schema.
TDBTableandTDBViewnow have a shared protocol so they can easier be used interchangeably.
- Fixed bug in 64 bit iOS when inserting BOOL as NSNumber.
- Typed interface Cursor has now been renamed to Row.
- TDBGroup has been renamed to TDBTransaction.
- Header files are renamed so names match class names.
- Underscore (_) removed from generated typed table classes.
- TDBBinary has been removed; use NSData instead.
- Underscope (_) removed from generated typed table classes.
- Constructor for TDBContext has been renamed to contextWithPersistenceToFile:
- Table findFirstRow and min/max/sum/avg operations has been hidden.
- Table.appendRow has been renamed to addRow.
- getOrCreateTable on Transaction has been removed.
- set*:inColumnWithIndex:atRowIndex: methods have been prefixed with TDB
- *:inColumnWithIndex:atRowIndex: methods have been prefixed with TDB
- addEmptyRow on table has been removed. Use [table addRow:nil] instead.
- TDBMixed removed. Use id and NSObject instead.
- insertEmptyRow has been removed from table. Use insertRow:nil atIndex:index instead.
- Added firstRow, lastRow selectors on view.
- firstRow and lastRow on table now return nil if table is empty.
- getTableWithName selector added on group.
- getting and creating table methods on group no longer take error argument.
- [TDBQuery parent] and [TDBQuery subtable:] selectors now return self.
- createTable method added on Transaction. Throws exception if table with same name already exists.
- Experimental support for pinning transactions on Context.
- TDBView now has support for object subscripting.
- None.
The Objective-C API has been updated and your code will break!
- Most selectors have been renamed in the binding!
- Prepend TDB-prefix on all classes and types.
- Return types and parameters changed from size_t to NSUInteger.
- Adding setObject to TightdbTable (t[2] = @[@1, @"Hello"] is possible).
- Adding insertRow to TightdbTable.
- Extending appendRow to accept NSDictionary.
- None.
The Objective-C API has been updated and your code will break!
- addRow renamed to addEmptyRow
- Adding a simple class for version numbering.
- Adding get-version and set-version targets to build.sh.
- tableview now supports sort on column with column type bool, date and int
- tableview has method for checking the column type of a specified column
- tableview has method for getting the number of columns
- Adding methods getVersion, getCoreVersion and isAtLeast.
- Adding appendRow to TightdbTable.
- Adding object subscripting.
- Adding method removeColumn on table.
- None.