# 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="https://2249461369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LR7sVOoZyL01-NkNVQJ%2Fuploads%2FnsTbmdnn0kTqWBlyZwNC%2Fimage.png?alt=media&#x26;token=ff23b4f5-94a3-4907-97b3-87b2990ac5e2" 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:

![](https://2249461369-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LR7sVOoZyL01-NkNVQJ%2F-LpmW5Og18sPDrnkkaTa%2F-LpmWhXrn-_gl7R5edVS%2FScreenshot%202019-09-27%20at%2013.41.15.png?alt=media\&token=91585bde-6bf7-44f2-848b-5abdf1b3c789)

* 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.

![](https://2249461369-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LR7sVOoZyL01-NkNVQJ%2F-LpmW5Og18sPDrnkkaTa%2F-LpmXIJl-a_n64GwAdzc%2FScreenshot%202019-09-27%20at%2013.43.55.png?alt=media\&token=9d97ef92-2b22-46dc-808b-dc655a2949b6)

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](https://swift.objectbox.io/getting-started).