> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Add the OneS1ght iOS SDK with Swift Package Manager and initialize it with your SDK key.

<Info>
  Before installing, check the [iOS requirements](/en/sdk/overview#ios-requirements) (iOS 27.0+ · iPhone 12 or later · Xcode 27+).
</Info>

## Install with Swift Package Manager

<Steps>
  <Step title="Open Add Package">
    In Xcode, choose **File → Add Package Dependencies…**.
  </Step>

  <Step title="Enter the repository URL">
    Enter the following URL and add the package.

    ```
    https://github.com/onecheck-inc/onesight-sdk
    ```
  </Step>

  <Step title="Add to your target">
    Add the `OneS1ghtSDK` library to your app target.
  </Step>
</Steps>

<Note>
  The positioning engine (`gpi-dltdoa`) is bundled into the SDK as an `xcframework`. You only need to add **this one package** — no additional dependency setup is required.
</Note>

## Get an SDK key

Initialization requires an SDK key in the `ock_sdk_...` format. Issue one from the console at [Mobile SDK Keys](/en/locator/sdk-keys).

<Warning>
  The full key value is shown **only once**, right after issuing. Store it somewhere safe.
</Warning>

## Initialize

Initialize the SDK with your key when the app starts.

```swift theme={null}
import OneS1ghtSDK

try await OneS1ghtSDK.shared.initialize(apiKey: "ock_sdk_...")
```

`initialize(apiKey:)` verifies the key and loads configuration. If the key is invalid, positioning does not start.

## Next step

<Card title="Usage" icon="code" href="/en/sdk/usage">
  Continue to starting positioning, the main API, and receiving zone events.
</Card>