Realm Object Store
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:
property- contains the structures and logic used to setup and modify Realm files and their schema.
shared_realm- wraps the
object_storeAPIs to provide transactions, notifications, Realm caching, migrations, and other higher level functionality.
list- accessor classes, object creation/update pipeline, and helpers for creating platform specific property getters and setters.
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:
The object store's CMake build system currently only supports building for OS X, Linux, and Android.
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.
git submodule update --init
brew install cmake
Generate build files:
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/ .
If you want to use XCode as your editor, you can generate a XCode project with:
cmake -G Xcode .
Building With Sync Support
If you wish to build with sync enabled, invoke
cmake like so:
Building Against a Local Version of Core
If you wish to build against a local version of core you can invoke
cmake like so:
The given core tree will be built as part of the object store build.
Building Against a Local Version of Sync
Specify the path to realm-core and realm-sync when invoking
cmake -DREALM_ENABLE_SYNC=1 -DREALM_CORE_PREFIX=/path/to/realm-core -DREALM_SYNC_PREFIX=/path/to/realm-sync
Prebuilt sync binaries are currently not supported.
Building with Sanitizers
The object store can be built using ASan, TSan and/or UBSan by specifying
-DSANITIZE_UNDEFINED=1 when invoking CMake.
Building with ASan requires specifying a path to core with
-DREALM_CORE_PREFIX 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.
It requires a root device or an emulator:
make adb push tests/tests /data/local/tmp adb shell /data/local/tmp/tests
Dockerfile included in this repo will provision a Docker image suitable
for building and running tests for both the Linux and Android platforms.
# Build Docker image from Dockerfile docker build -t "objectstore" . # Run bash interactively from the built Docker image, # mounting the current directory docker run --rm -it -v $(pwd):/tmp -w /tmp objectstore bash # Build the object store for Linux and run tests > cmake . > make > make run-tests
Refer to the rest of this document for instructions to build/test in other configurations.
Realm Object Store is published under the Apache 2.0 license. The underlying core is also published 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.