Android SDK | Primagest Trust Services

バージョン管理システム移行に伴うお知らせ

現在、本プロジェクトのライブラリは、バージョン管理システムへの移行作業中のため、詳細や今後のスケジュールにつきましては、別途アナウンスいたします。

概要

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

セットアップ手順

ファイル追加時の設定

ZIPファイルを解凍し、同梱されている「primagest-trust-services-{version}.aar」ファイルを、利用したいAndroid Studioプロジェクトのapp/libs/フォルダにドラッグ＆ドロップで追加します。追加先のディレクトリを指定し、「Refactor」ボタンをクリックします。

build.gradle.ktsの設定

「app/build.gradle.kts」を開き、「android」ブロックに次の設定を追加します。

さらに「dependencies」ブロックに次の依存関係を追加します。その後、画面右上の「Sync Project with Gradle Files」をクリックします。

NFC利用の権限設定

「AndroidManifest.xml」に次の2行を追記します。

<!-- NFC -->
<uses-permission android:name="android.permission.NFC" />
<uses-feature
    android:name="android.hardware.nfc"
    android:required="false" />
<!-- 券面 OCR -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- mdoc / BLE（mdoc 利用時） -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
    android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"
    android:usesPermissionFlags="neverForLocation"
    tools:targetApi="s" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
<!-- API送信 -->
<uses-permission android:name="android.permission.INTERNET" />

importによるSDKの呼び出し

SDKを利用するKotlin/Javaコード内で「PrimagestTrustReader」をインポートすることで、SDK内の機能を使用できます。

Android

概要#

セットアップ手順#

概要

セットアップ手順