# Manual Installation

### Download

You can get the newest **ObjectBox-xcframework-\<version>.zip** from [our GitHub Releases](https://github.com/objectbox/objectbox-swift/releases) page:

<figure><img src="/files/POighL0PArAvAGZMUXId" alt=""><figcaption><p>Latest ObjectBox Swift GitHub release with XCFramework download highlighted</p></figcaption></figure>

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 `/Users/vivien/RecordsDatabase/ObjectBox` ).

### Add the Framework to your Project

Like with any embedded framework, you link to it and copy it into your application:

![](/files/-LpmWhXrn-_gl7R5edVS)

* Find the **ObjectBox.framework** for the platform of your application from the `ObjectBox.xcframework` folder.
* 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.

![](/files/-LpmXIJl-a_n64GwAdzc)

You're done, your project is linking to ObjectBox.

### Setup Script

Then open Terminal and run

`gem install xcodeproj`\
`/path/to/ObjectBox/setup.rb /path/to/MyProject.xcodeproj`

where `/path/to/` is again where your project is, like `/Users/vivien/RecordsDatabase/` above.

The `xcodeproj` gem is only needed by the installation script to do its work. It's not required to build your application.

### Done

You can now open your project and [follow the rest of this tutorial](/getting-started.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://swift.objectbox.io/advanced/manual-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.