Installation

ObjectBox C and C++

ObjectBox.io Sync Docs Follow us

Search…

ObjectBox C / C++ database

Transactions in ObjectBox

Installation

The ObjectBox C / C ++ database is setup within minutes. Get the library and the generator and start developing high performance data applications.

ObjectBox library
There are a couple of ways to get the ObjectBox library (we recommend CMake 3.14 or newer):
CMake 3.14+
CMake (v3.11+)
download.sh
GitHub
Use CMake's FetchContent to get ObjectBox headers and library ready to use in your project:
CMakeLists.txt
1
include(FetchContent)
2
FetchContent_Declare(
3
    objectbox
4
    GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
5
    GIT_TAG        v0.14.0
6
)
7
​
8
FetchContent_MakeAvailable(objectbox)
9
​
10
add_executable(myapp main.cpp)
11
target_link_libraries(myapp objectbox)
Copied!
If you want to use an ObjectBox Sync variant of the library, change the list line to: 
CMakeLists.txt
1
target_link_libraries(myapp objectbox-sync)
Copied!
Use CMake's FetchContent to get ObjectBox headers and library into your project like this:
CMakeLists.txt
1
include(FetchContent)
2
FetchContent_Declare(
3
    objectbox
4
    GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
5
    GIT_TAG        v0.14.0
6
)
7
​
8
FetchContent_GetProperties(objectbox)
9
if(NOT objectbox_POPULATED)
10
  FetchContent_Populate(objectbox)
11
endif()
12
​
13
add_executable(myapp main.cpp)
14
target_link_libraries(myapp objectbox)
Copied!
If you want to use an ObjectBox Sync variant of the library, change the list line to: 
CMakeLists.txt
1
target_link_libraries(myapp objectbox-sync)
Copied!
Using the download.sh script (on Windows, use something like Git Bash to run it)
Get the repo's download.sh and run it in a terminal:
bash <(curl -s https://raw.githubusercontent.com/objectbox/objectbox-c/main/download.sh)
To get the ObjectBox Sync variant of the library, pass --sync to the previous command.
Details on the download.sh script:
Creates a "download" directory and a version dependent sub directory named like "libobjectbox-0.1-some-hex-hash".
Inside the version dependent sub directory, you will find the directories "include" and "lib"/
The "lib" directory contains the binary library.
Gives you an option to install the library to /usr/lib (linux) or /usr/local/lib (macOS).
Get the library for your platform from the latest GitHub release: 
https://github.com/objectbox/objectbox-c/releases/latest​
Once you setup the headers and library like this, you can already start using the ObjectBox API! Here's a minimal example to verify your setup:
C++
C
main.cpp
1
#include "objectbox.hpp"
2
​
3
int main() {
4
    printf("Using ObjectBox version %s\n", obx_version_string());
5
}
Copied!
main.c
1
#include "objectbox.h"
2
​
3
int main() {
4
    printf("ObjectBox version %s\n", obx_version_string());
5
}
Copied!
If you used CMake to setup your project you can already build and execute this program. Otherwise ensure your includes and the runtime shared library (libobjectbox.so, .dylib, .dll depending on the platform) are setup correctly for your compiler and linker environment.
ObjectBox Generator
Install the objectbox-generator executable by downloading the version for your OS from releases. If you want, add it to $PATH for convenience. Alternatively, instead of downloading, you can build the generator yourself by cloning this repo and running make. To build yourself, you need a recent Go version, CMake and a C++11 toolchain.
ObjectBox Generator is a tool that will help you with during development of your application (and as opposed to the objectbox shared library, it's not supposed to be distributed with your app).
Try running objectbox-generator -help to verify the installation and see the options.
FlatBuffers (optional)
If you prefer to work with C++ classes, we recommend using ObjectBox Generator. It's a higher level abstraction which takes care of FlatBuffers so you don't have to.
You can still use FlatBuffers directly, e.g. for zero-copy data access which can be even faster.
ObjectBox uses the high-performance binary representation "FlatBuffers" to achieve cross-platform compatibility of the stored data. Google provides FlatBuffers implementation for various languages including C++.
C++
C
The ObjectBox shared library already includes FlatBuffers symbols so no additional linking should be necessary. For headers, there are two options:
1.
If you're using CMake and the FetchContent command like described above, you are already set up to work with FlatBuffers APIs. The FlatBuffers headers are already part of the objectbox library interface include directories.
2.
Get the FlatBuffers headers, e.g. copy them into your source/include path. 
Get flatcc library and headers. You can link your program to the to the static runtime library.
CMake example (check the link above for the latest version):
1
FetchContent_Declare(
2
    flatcc
3
    GIT_REPOSITORY https://github.com/dvidelabs/flatcc.git
4
    GIT_TAG        v0.6.0
5
)
6
​
7
FetchContent_GetProperties(flatcc)
8
if(NOT flatcc_POPULATED)
9
  FetchContent_Populate(flatcc)
10
endif()
11
​
12
add_executable(c99app main.c)
13
target_link_libraries(c99app objectbox flatccrt)
Copied!
​

ObjectBox C / C++ database

How to get started

Last modified 5mo ago

Copy link

Contents

ObjectBox library

ObjectBox Generator

FlatBuffers (optional)