Kurulum

1. Pod’u ekleyin

SDK, Techsign’ın GitHub’daki özel CocoaPods spec deposundan dağıtılır. Erişim için Techsign temsilcinizle iletişime geçin, ardından pod’u Podfile dosyanıza ekleyin:

platform :ios, '13.0'

target 'YourApp' do
  use_frameworks!

  pod 'techsigncloudlibs', '2.9.23-wrapper-suppress-ca',
      :source => 'https://github.com/Techsign/PODSPECS.git'
end

pod install

Bundan sonra projeyi .xcodeproj yerine .xcworkspace dosyasıyla açın.

2. Servis istemcisini ekleyin

ProveIDApiClient, Prove ID API’si için bir Swift istemcisidir. API Referansı sekmesinden indirdiğiniz OpenAPI tanımından OpenAPI Generator ile üretin:

openapi-generator generate \
  -i openapi.json \
  -g swift5 \
  -o ProveIDApiClient \
  --additional-properties=projectName=ProveIDApiClient,library=alamofire,responseAs=Result

Üretilen klasörü Xcode’da File → Add Package Dependencies… → Add Local… ile projenize ekleyin. Paket Alamofire 5 ve AnyCodable kullanır; bunları Swift Package Manager sizin için çözer.

3. İzinler

Kullanım açıklamalarını Info.plist dosyasına ekleyin. Bu açıklamalar olmadan kameraya veya NFC’ye erişilirse iOS uygulamayı kapatır.

<key>NSCameraUsageDescription</key>
<string>Kamera, kimlik belgenizi taramak ve yüzünüzü doğrulamak için kullanılır.</string>
<key>NFCReaderUsageDescription</key>
<string>NFC, kimlik belgenizdeki çipi okumak için kullanılır.</string>

4. NFC yeteneği

Yalnızca NFC adımı için:

Xcode’da Signing & Capabilities altında Near Field Communication Tag Reading yeteneğini ekleyin. Bu, aşağıdaki entitlement’ı oluşturur.
Kimlik belgelerinin (ICAO 9303) uygulama tanımlayıcısını Info.plist dosyasına ekleyin.

<key>com.apple.developer.nfc.readersession.formats</key>
<array>
    <string>TAG</string>
</array>

<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
    <string>A0000002471001</string>
</array>

Her cihaz NFC okuyamaz. NFC adımını göstermeden önce kontrol edin:

import CoreNFC

let hasNfc = NFCNDEFReaderSession.readingAvailable