The Sandbox on macOS

Installation for macOS is the same as for iOS, however, there is one small extra step.

The Sandbox on macOS

circle-info

You do not need to perform any of these steps for an application running on iOS, or if your macOS application is not sandboxed.

Currently, use of ObjectBox from a sandboxed macOS application requires you to set up at least one App Group for ObjectBox to be able to open a database, in addition to whatever you would normally have done to gain access to the destination folder under the sandbox:

  1. Open your project in Xcode.

  2. Select the project icon at the very top of the Project Navigator.

  3. Select the Signing & Capabilities tab where you turned on App Sandbox.

  4. Click the + Capability button and double-click App Groups.

  5. If the App Groups list is empty, click the little "+" icon to add one.

You should now see a list entry like FGDTDLOBXDJ.$(TeamIdentifierPrefix). If you only see $(TeamIdentifierPrefix) , you still need to set up your team and code-signing under General.

That should be it: ObjectBox will pick up the App Group Identifier without any additional work.

circle-info

Pick a short group identifier. There's an internal limit in macOS of 31 characters for semaphores, that enforces the complete string (FGDTDLOBXDJ.$(TeamIdentifierPrefix) in the example) to be 20 characters or less.

Last updated