Installation
We're trying to make the installation experience smooth for everyone. In case you're getting stuck or are finding some steps hard to follow, please reach out to us, e.g. by creating a GitHub issue or through our Contact form. Thanks!
This section describe the installation on Linux or macOS, if you're using Windows, please skip to the Installation on Windows section.
The main prerequisite to using ObjectBox in Go is the ObjectBox binary library (.so, .dylib depending on your platform) which actually implements the database functionality.
We are using CGO which requires you to have a C/C++ compiler, such as gcc or clang, installed. You can try executing one of following commands in terminal to check if it's already available and working: $CC --version or gcc --version or clang --version. If any of the commands works fine (no need for all of them to work), you should be good to go. Otherwise, please gcc or clang according to the instructions for your system (e.g. sudo apt install gcc on Ubuntu).
There's currently a known issue on some ARM platforms, see Raspberry Pi 3 & 4 fallback.
The fastest way to install is by using our installation script. Execute the following command in your project directory. If that doesn't work for you, you can skip to the manual installation bellow.
bash <(curl -s https://raw.githubusercontent.com/objectbox/objectbox-go/master/install.sh)
C binary library
You can run the followingdownload.sh script (press Y to install the library to a system-wide folder when it asks you). you can remove the temporary "objectboxlib" directory created by this step afterwards.
mkdir objectboxlib && cd objectboxlibbash <(curl -s https://raw.githubusercontent.com/objectbox/objectbox-c/master/download.sh) 0.8.1
If your project is using a go.mod file to keep track of the dependencies, you don't need to install anything else and you can just start using ObjectBox by importing it in your source code:
import "github.com/objectbox/objectbox-go/objectbox"
In case you're not using Go modules, you can install ObjectBox using following commands:
go get -u github.com/objectbox/objectbox-go/...go get -u github.com/google/flatbuffers/go
A package dependency is set up automatically if you've used the "Quick installation" method using the install.sh script
You may encounter an issue on some ARM platforms (seen this on Raspberry Pi 3 & 4) with the default native library installed by the script. Also, the issue seems to only occur when running natively, not inside docker.
You can check your installation to see if you encounter crashes (SIGBUS/SIGSEGV) by executing go test github.com/objectbox/objectbox-go/...
As a workaround, you can install an ARMv6 version of the native library (instead of the default ARMv7 the script picks) using the same script as in the manual installation, just changing the arguments:
./download.sh 0.8.1 testing Linux armv6
The main prerequisite to using ObjectBox in Go is the ObjectBox binary DLL which actually implements the database functionality. We are using CGO which requires you to have MinGW gcc in PATH, e. g. http://tdm-gcc.tdragon.net/ - in case you don't have MinGW installed yet, please do so first.
You can use the following PowerShell script to help you with installation of the library to the right folders:
download the script: (right click and "Save link as", the location doesn't matter) install.ps1
run the script - either double click or right click and "Run in PowerShell" - depends on your settings.
the script will guide you through the installation steps.
In case you couldn't install fully using the script (e.g. it didn't find your MinGW installation), you can try to finish the installation manually
In order to compile your program, you need to copy the downloaded
download/bjectbox.dllto the MinGW library directory, e. g.C:\TDM-GCC-64\libTo run the program, you either need to have the
objectbox.dlllibrary in the same folder as the compiled program, have its location (e. g.C:\TDM-GCC-64\libinPathenvironment variable), or copy it to the system library directoryc:\Windows\System32
If your project is using a go.mod file to keep track of the dependencies, you don't need to install anything else and you can just start using ObjectBox by importing it in your source code:
import "github.com/objectbox/objectbox-go/objectbox"
Don't forget to include the objectbox.dll with your program when distributing/packaging for installer. Having it in the same directory as your program binary should be enough.
