# iOS 

<br>
## **概要**

iOS SDKは、マイナンバーカードを利用して電子証明書の取得や署名の作成、利用者の最新基本4情報（氏名・住所・生年月日・性別）に関する同意申請など、公的個人認証に必要な機能をiPhoneアプリに実装するための開発キットです。  
提供される「PrimagestTrustServices.xcframework」フォルダをXcodeのプロジェクトにドラッグ＆ドロップで追加するだけで、利用を開始できます。  
これにより、NFC機能で読み取ったマイナンバーカードを活用し、公的個人認証に必要な各種機能をiPhoneアプリ上で実現できます。

## **セットアップ手順**

<Steps>
    <Step title="PrimagestTrustServices.xcframeworkフォルダのドラッグ＆ドロップ">
        ![PrimagestTrustServices.xcframeworkフォルダのドラッグ＆ドロップ.png](https://api.apidog.com/api/v1/projects/1125421/resources/371027/image-preview)
        ZIPファイルを解凍し、同梱されている「PrimagestTrustServices.xcframework」フォルダを、Xcodeで作成済みのプロジェクトフォルダ内にドラッグ＆ドロップで追加します。
    </Step>
    <Step title="Embed設定の確認">
        ![Embed設定の確認.png](https://api.apidog.com/api/v1/projects/1125421/resources/371028/image-preview)
        プロジェクトを選択し、「General」タブを開きます。画面下部の「Frameworks, Libraries, and Embedded Content」に「PrimagestTrustServices.xcframework」が追加されていることを確認し、Embed の設定を「Embed & Sign」に変更します。
    </Step>
    <Step title="Info.plistの設定">
        ![Info.plistの設定.png](https://api.apidog.com/api/v1/projects/1125421/resources/371029/image-preview)
        NFC を利用するため、「Info.plist」に以下のキーを追加します。  
        - ISO7816 application identifiers for NFC Tag Reader Session  
        - ISO18092 system codes for NFC Tag Reader Session  
        ※ Info.plist の内容は機密事項のため、契約時に公開します。
    </Step>
    <Step title="Build SettingsのInfo.plist Valuesの設定">
        ![Build SettingsのInfo.plist Valuesの設定.png](https://api.apidog.com/api/v1/projects/1125421/resources/371030/image-preview)
        「Build Settings」の「Info.plist Values」に以下を設定します。  
        - 各項目の「Debug」および「Release」に「Any iOS」と「Any iOS Simulator」を追加し、「YES」を設定します。  
        - Privacy - NFC Scan Usage Description  
          アプリでNFCを利用する理由（例：「個人番号カードの読み取りに使用します」）を記述します。
    </Step>
    <Step title="importによるSDKの呼び出し">
        SDKを利用する Swift コード内で「PrimagestTrustServices」をインポートすることで、SDK 内の機能を使用できます。
```swift
import PrimagestTrustServices
```
    </Step>
</Steps>

<br>