# Android

<br>

## **概要**

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

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

<Steps>
    <Step title="ファイル追加時の設定">
        ![ファイル追加時の設定.png](https://api.apidog.com/api/v1/projects/1125421/resources/371132/image-preview)
        ZIPファイルを解凍し、同梱されている「primagest-trust-services-{version}.aar」ファイルを、利用したいAndroid Studioプロジェクトのapp/libs/フォルダにドラッグ＆ドロップで追加します。追加先のディレクトリを指定し、「Refactor」ボタンをクリックします。
    </Step>
    <Step title="build.gradle.ktsの設定">
        「app/build.gradle.kts」を開き、「dependencies」ブロックに次の3行を追加します。その後、画面右上の「Sync Project with Gradle Files」をクリックします。
        
```gradle
implementation(files("libs/primagest-trust-services-{version}.aar"))
implementation("androidx.core:core-ktx:1.10.1")
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
```
    </Step>
    <Step title="NFC利用の権限設定">
        「AndroidManifest.xml」に次の2行を追記します。
        
```xml
<uses-permission android:name="android.permission.NFC" />
<uses-feature android:name="android.hardware.nfc" android:required="false" />
```
    </Step>
    <Step title="importによるSDKの呼び出し">
        SDKを利用するKotlin/Javaコード内で「PrimagestTrustReader」をインポートすることで、SDK内の機能を使用できます。
        
```kotlin
import jp.co.primagest.trustservices.nfc.PrimagestTrustReader
```
    </Step>
</Steps>

<br>