インストール

インストール前にiOS要件（iOS 27.0+ · iPhone 12以上 · Xcode 27+）を確認してください。

Swift Package Managerでインストール

パッケージ追加を開く

Xcodeで File → Add Package Dependencies… を選択します。

リポジトリURLを入力

次のURLを入力してパッケージを追加します。

https://github.com/onecheck-inc/onesight-sdk

ターゲットに追加

OneS1ghtSDKライブラリをアプリのターゲットに追加します。

測位エンジン（gpi-dltdoa）はxcframeworkとしてSDKに内蔵されています。このパッケージ1つを追加するだけでよく、別途の依存関係設定は不要です。

初期化にはock_sdk_...形式のSDKキーが必要です。キーはコンソールのモバイルSDKキー管理画面で発行します。

キーの全体の値は、発行直後の一度だけ表示されます。安全な場所に保管してください。

アプリ起動時に、発行したキーでSDKを初期化します。

import OneS1ghtSDK

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

initialize(apiKey:)はキーを検証し、設定をロードします。キーが無効な場合、測位は開始されません。

測位の開始、主要API、ゾーンイベントの受信方法へ進みます。