LibJeID for iOS

対応機種

iOS13以降の以下の端末で動作確認しています。

iPhone 14
iPhone 13
iPhone 12
iPhone SE (第2世代)
iPhone 11
iPhone XS
iPhone XR
iPhone X
iPhone 8

その他の機種につきましては、動作確認を行い次第こちらに記載いたします。

開発環境

Xcode11以降

ライブラリの導入方法

LibJeID for iOSは下記URLからダウンロードしたものを配置してご利用ください。

ダウンロードには弊社から連絡差し上げたサブスクリプションIDとアクセスキーによる認証が必要となります。

https://www.osstech.co.jp/download/libjeid/framework/full/

Xcodeは最新バージョンを事前にインストールしておいてください。

1. ライブラリの配置

Xcodeでライブラリを導入したいプロジェクトを開いてください。

上記URLでダウンロードしたZIPファイルに含まれるlibjeid.xcframeworkをプロジェクトにドラック&ドロップして配置してください。 (注: 20200326以前のバージョンはlibjeid.frameworkを配置します)

以下の例では、あらかじめFrameworksというグループを作成しておき、その直下に配置しています。

「Choose options for adding these files」のウィンドウが表示されますので、「Copy items if needed」にチェックを入れて「Finish」を押下してください。

2. Info.plistの編集

アプリのInfo.plistをXcodeで開き、以下を追加します。

Key	Type	Value
Privacy - NFC Scan Usage Description	String	NFCリーダーを使用する理由
ISO7816 application identifiers for NFC Tag Reader Session	Array	(9 items)
Item 0	String	A00000023101
Item 1	String	A00000023102
Item 2	String	D392F000260100000001
Item 3	String	D3921000310001010401
Item 4	String	D3921000310001010402
Item 5	String	D3921000310001010408
Item 6	String	D392F0004F0200000000000000000000
Item 7	String	D392F0004F0300000000000000000000
Item 8	String	D392F0004F0400000000000000000000

Xcodeを用いずにInfo.plistを直接編集する場合、以下を追記してください。 NFCReaderUsageDescriptionに対応する値にはNFCリーダーを使用する理由を記述します。

<key>NFCReaderUsageDescription</key>
<string>NFCリーダーを利用する理由</string>
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
	<string>A00000023101</string>
	<string>A00000023102</string>
	<string>D392F000260100000001</string>
	<string>D3921000310001010401</string>
	<string>D3921000310001010402</string>
	<string>D3921000310001010408</string>
	<string>D392F0004F0200000000000000000000</string>
	<string>D392F0004F0300000000000000000000</string>
	<string>D392F0004F0400000000000000000000</string>
</array>

補足

カード種別とデータを読み取る際に使用するAIDの対応関係は以下のとおりです。

カード種別	使用するAID
運転免許証	A00000023101, A00000023102
マイナンバーカード	D392F000260100000001, D3921000310001010401, D3921000310001010402, D3921000310001010408
在留カード	D392F0004F0200000000000000000000, D392F0004F0300000000000000000000, D392F0004F0400000000000000000000

Info.plistに読み取りたいカードに対応するAIDのみを追加することで、任意のカードのみ読み取り可能なアプリにすることもできます。例えば以下のようにA00000023101とA00000023102のみを追加した場合、アプリは運転免許証を読み取ることができますが、それ以外のカードは読み取ることができません。

Key	Type	Value
Privacy - NFC Scan Usage Description	String	NFCリーダーを使用する理由
ISO7816 application identifiers for NFC Tag Reader Session	Array	(2 items)
Item 0	String	A00000023101
Item 1	String	A00000023102

Xcodeを用いずにInfo.plistを直接編集する場合、以下のようになります。

<key>NFCReaderUsageDescription</key>
<string>NFCリーダーを利用する理由</string>
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
	<string>A00000023101</string>
	<string>A00000023102</string>
</array>