The object store contains cross-platform abstractions used in Realm products. It is not intended to be used directly.

The object store consists of the following components:

• object_store/schema/object_schema/property - contains the structures and logic used to setup and modify Realm files and their schema.
• shared_realm - wraps the object_store APIs to provide transactions, notifications, Realm caching, migrations, and other higher level functionality.
• object_accessor/results/list - accessor classes, object creation/update pipeline, and helpers for creating platform specific property getters and setters.
• parser/query_builder - cross platform query parser and query builder - requires an object_accessor specialization for argument support.

Each Realm product may use only a subset of the provided components depending on its needs.

Please report bugs against the Realm product that you're using:

• Realm Java
• Realm Objective-C
• Realm React Native
• Realm Swift
• Realm Xamarin

The object store's CMake build system currently only suports building for OS X, Linux, and Android. Building for Linux requires building against a local version of core.

The object store code supports being built for all Apple platforms, Linux and Android when used along with the relevant Realm product's build system.

1. Download dependencies:

   git submodule update --init
   

2. Install CMake. You can download an installer for OS X from the CMake download page, or install via Homebrew:

   brew install cmake
   

3. Generate build files:

   cmake .
   

   If building for Android, the path for the Android NDK must be specified. For example, if it was installed with homebrew:

   cmake -DREALM_PLATFORM=Android -DANDROID_NDK=/usr/local/Cellar/android-ndk-r10e/r10e/ .
   

4. Build:

   make
   

If you wish to build against a local version of core you can invoke cmake like so:

cmake -DREALM_CORE_VERSION=/path/to/realm-core

The given core tree will be built as part of the object store build.

The object store can be built using ASan, TSan and/or UBSan by specifying -DSANITIZE_ADDRESS=1, -DSANITIZE_THREAD=1, or -DSANITIZE_UNDEFINED=1 when invoking CMake. Building with ASan requires specifying a path to core with -DREALM_CORE_VERSION as core needs to also be built with ASan enabled.

On OS X, the Xcode-provided copy of Clang only comes with ASan, and using TSan or UBSan requires a custom build of Clang. If you have installed Clang as an external Xcode toolchain (using the install-xcode-toolchain when building LLVM), note that you'll have to specify -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ when running cmake to stop cmake from being too clever.

make run-tests

Realm Object Store is published under the Apache 2.0 license. The underlying core is available under the Realm Core Binary License while we work to open-source it under the Apache 2.0 license.

This product is not being made available to any person located in Cuba, Iran, North Korea, Sudan, Syria or the Crimea region, or to any other person that is not eligible to receive the product under U.S. law.