Comment on page
If you aren't using CocoaPods, ObjectBox can easily be installed manually. Just download, add the framework to your project, and run our setup script.
Unpack the ZIP-archive and put the entire folder somewhere in your project's folder (for example, if your project is in
/Users/vivien/RecordsDatabase/RecordsDatabase.xcodeproj, you could put ObjectBox at
Like with any embedded framework, you link to it and copy it into your application:
- Find the ObjectBox.framework for your platform from the
- Open your project's target settings by clicking the little blue project icon at the top of the Project Navigator in Xcode.
- Select the General tab for your target and find the Frameworks, Libraries and Embedded Content section.
- Drag the ObjectBox.framework into the list and choose "Embed & Sign" from the popup at its right.
- macOS and Xcode 10 and earlier only:
- Go to the Build Phases tab and add a Copy Files build phase.
- Select Frameworks as the Destination from the popup.
- Drag the ObjectBox.framework into it.
You're done, your project is linking to ObjectBox.
Then open Terminal and run
gem install xcodeproj /path/to/ObjectBox/setup.rb /path/to/MyProject.xcodeproj
/path/to/is again where your project is, like
The first call installs a helper library needed by the installation script to do its work. This library is not needed once you have run the script. Nobody else using your project needs to do this.