> ## 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要件](/ja/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に内蔵されています。**このパッケージ1つ**を追加するだけでよく、別途の依存関係設定は不要です。
</Note>

## SDKキーの発行

初期化には`ock_sdk_...`形式のSDKキーが必要です。キーはコンソールの[モバイルSDKキー管理](/ja/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="/ja/sdk/usage">
  測位の開始、主要API、ゾーンイベントの受信方法へ進みます。
</Card>