Realm JavaScript v20.2.0

Warning

This version doesn't support the deprecated legacy architecture.
See this comment for additional context.

Enhancements

• 16KB page size support for Android 15+ (#7019). If you are using Android Gradle Plugin (AGP) 8.5 or lower, you will need to enable legacy packaging.
• Add support for React Native 0.80.0, by migrating to a pure C++ TurboModule. (#7029)

Fixed

• Fix setting List values from themselves (either through assignment or the Realm#create method). Before this fix, the list would be emptied before being iterated, resulting in elements being removed from the list. (#6977, since v12.12.0)
• Fix numerous crashes on Android, by explicitly setting C++ standard (C++20) when building pre-builds. (#7027, since v12.11.0)

Compatibility

• React Native new architecture only.
• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Internal

• Upgrade React Native version in the test app to 0.80.0.
• Upgrade NDK to 27.1.12297006 and Android API level 24, to match React Native latest.

Realm JavaScript v12.15.0

Warning

This version doesn't support the deprecated legacy architecture.
See this comment for additional context.

Enhancements

• Add support for React Native 0.80.0, by migrating to a pure C++ TurboModule. (#7029)
• 16KB page size support for Android 15+ (#7019). If you are using Android Gradle Plugin (AGP) 8.5 or lower, you will need to enable legacy packaging. Thanks a lot to @liamjones for proposing the fix!

Fixed

• Fix numerous crashes on Android, by explicitly setting C++ standard (C++20) when building pre-builds. (#7027, since v12.11.0)

Compatibility

• React Native new architecture only.
• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Internal

• Upgrade React Native version in the test app to 0.80.0.
• Upgrade NDK to 27.1.12297006 and Android API level 24, to match React Native latest.
• Upgraded Realm Core from v14.13.5 to v14.14.0

Realm JavaScript v12.14.2

Fixed

• Fix setting List values from themselves (either through assignment or the Realm#create method). Before this fix, the list would be emptied before being iterated, resulting in elements being removed from the list. (#6977, since v12.12.0)

Compatibility

• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Internal

Realm JavaScript v12.14.1

Fixed

• Closing and opening a realm before a token refresh is completed, would result in two sync sessions both try to start synchronizing the realm when the refreshes do complete, leading to a crash with a MultipleSyncAgents exception. (realm/realm-core#8064)
• Migrating primary key to a new type without migration function would cause an assertion to fail. (realm/realm-core#8045, since Realm JS v10.0.0)
• Committing a subscription set prematurely released a read lock, which may have caused a BadVersion exception with an error like Unable to lock version XX as it does not exist or has been cleaned up while changing subscriptions. (realm/realm-core##8068, since Realm JS v12.13.0)

Compatibility

• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Internal

• Upgraded Realm Core from v14.13.1 to v14.13.5.

Realm JavaScript v20.1.0

Enhancements

• Added excludeFromIcloudBackup option to the Realm constructor to exclude the realm files from iCloud backup. (#4139 and #6927)

const realm = new Realm({
  schema: [
    /* your schema */
  ],
  // Set to true to exclude from iCloud backup, false to include, defaults to false
  excludeFromIcloudBackup: true,
});

Fixed

• Fixed build error on React Native Android when used with React Native 0.76, due to the merge of dynamic libraries. (#6908 since React Native v0.76.0).
• Fix build failure from duplicate libreactnative.so files. I.e. "2 files found with path 'lib/arm64-v8a/libreactnative.so' from inputs" (#6918, since v12.13.2)
• Having a query with a number of predicates ORed together may result in a crash on some platforms (strict weak ordering check failing on iphone) (realm/realm-core#8028, since Realm JS v20.0.0)

Compatibility

• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Internal

• Refactored Android filesystem platform helpers. (#5296 and realm/realm-js-private#507)
• Upgraded Realm Core from v20.0.1 to v20.1.0

Realm JavaScript v12.14.0

Enhancements

• Added excludeFromIcloudBackup option to the Realm constructor to exclude the realm files from iCloud backup. (#4139 and #6927)

const realm = new Realm({
  schema: [
    /* your schema */
  ],
  // Set to true to exclude from iCloud backup, false to include, defaults to false
  excludeFromIcloudBackup: true,
});

Thanks @danibonilha for your PR and time crafting the testing guide for the iCloud backup exclusion feature.

Fixed

• Fix build failure from duplicate libreactnative.so files. I.e. "2 files found with path 'lib/arm64-v8a/libreactnative.so' from inputs" (#6918, since v12.13.2)

Compatibility

• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Internal

• Refactored Android filesystem platform helpers. (#5296 and realm/realm-js-private#507)

Realm JavaScript v12.13.2

Fixed

• Fixed build error on React Native Android when used with React Native 0.76, due to the merge of dynamic libraries. (#6908 since React Native v0.76.0).
• Filtering notifications with backlink columns as last element could sometimes give wrong results (realm/realm-core#7530, since Realm JS v10.6.2-beta.1)
• Fix crash during client app shutdown when Logger log level is set higher than Info. (realm/realm-core#7969, since Realm JS v12.3.1)
• If File::rw_lock() fails to open a file the exception message does not contain the filename (realm/realm-core#7999, since Realm JS v6.1.0)
• Fallback to hashed filename will fail if length of basename is between 240 and 250 (realm/realm-core#8007, since Realm JS v10.0.0)
• Having a query with a number of predicates ORed together may result in a crash on some platforms (strict weak ordering check failing on iphone) (realm/realm-core#8028, since Realm JS v12.8.0)
• The events library would attempt to upload backup files created as part of file format upgrades, causing backup copies of those backups to be made, looping until the maximum file name size was reached (realm/realm-core#8040, since Realm JS v10.18.0).

Compatibility

• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Internal

• Upgraded Realm Core from v14.12.0 to v14.13.1.

Realm React v0.11.0

Enhancements

• Add more additional overload to useQuery to allow the react-hooks/exhaustive-deps eslint rule to work (#6819)

Fixed

• None

Compatibility

• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Realm JavaScript v20.0.0

Breaking Changes

• Removed all functionality related to Atlas Device Services / Device Sync.

Compatibility

• React Native >= v0.71.4
• Realm Studio v20.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).

Internal

• Upgraded Realm Core from v14.12.0 to v20.0.1

Realm React v0.10.1

Fixed

• Fixing the RealmProvider component when context is created without passing neither a Realm instance nor a Realm.Configuration to avoid unnecessary recreation of the provider, which was causing "Cannot access realm that has been closed" errors. (#6842, since v0.8.0)

Compatibility

• React Native >= v0.71.4
• Realm Studio v15.0.0.
• File format: generates Realms with format v24 (reads and upgrades file format v10).