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

# 설치

> Swift Package Manager로 OneS1ght iOS SDK를 추가하고 SDK 키로 초기화하는 방법을 안내합니다.

<Info>
  설치 전 [iOS 요구사항](/sdk/overview#ios-요구사항)(iOS 27.0+ · iPhone 12 이상 · Xcode 27+)을 확인하세요.
</Info>

## Swift Package Manager로 설치

<Steps>
  <Step title="패키지 추가 열기">
    Xcode에서 **File → Add Package Dependencies…** 를 선택합니다.
  </Step>

  <Step title="저장소 URL 입력">
    다음 URL을 입력하고 패키지를 추가합니다.

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

  <Step title="타깃에 추가">
    `OneS1ghtSDK` 라이브러리를 앱 타깃에 추가합니다.
  </Step>
</Steps>

<Note>
  측위 엔진(`gpi-dltdoa`)은 `xcframework`로 SDK에 내장되어 있습니다. **이 패키지 하나만** 추가하면 되며, 별도 의존성 설정이 필요 없습니다.
</Note>

## SDK 키 발급

초기화에는 `ock_sdk_...` 형식의 SDK 키가 필요합니다. 키는 콘솔의 [모바일 SDK 키 관리](/locator/sdk-keys) 화면에서 발급합니다.

<Warning>
  전체 키 값은 발급 직후 **한 번만** 표시됩니다. 안전한 곳에 보관하세요.
</Warning>

## 초기화

앱 시작 시 발급받은 키로 SDK를 초기화합니다.

```swift theme={null}
import OneS1ghtSDK

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

`initialize(apiKey:)`는 키를 검증하고 설정을 로드합니다. 키가 유효하지 않으면 측위가 시작되지 않습니다.

## 다음 단계

<Card title="사용법" icon="code" href="/sdk/usage">
  측위 시작, 주요 API, 구역 이벤트 수신 방법을 이어서 확인하세요.
</Card>