iOS Tutorial - So integrieren Sie unseren Document Scanner

2.11.2021

In diesem Artikel zeigen wir Ihnen, wie schnell und einfach es ist, eine App mit integriertem Scanbot SDK zu erstellen. Los geht's!

Erste Schritte

Voraussetzungen

Erstellung einer iOS-App

Beginnen wir, indem wir ein neues iOS-Projekt anlegen.

Für dieses Tutorial werden wir ein Swift-Projekt mit Hilfe von Storyboard erstellen. 

So beginnen Sie ein neues iOS-Projekt:

Installation des Scanbot SDK

Sie können das Scanbot SDK über den Swift Package Manager, CocoaPods, Carthage oder XCFramework integrieren (siehe Dokumentation). Alternativ können Sie das Scanbot SDK-Paket auch herunterladen und manuell hinzufügen. In diesem Tutorial verwenden wir den Swift Package Manager.

So fügen Sie das Scanbot SDK für iOS mittels Swift Package Manager hinzu:

Führen Sie einen Testlauf durch

Sie sollten nun einen leeren Bildschirm sehen.

Vorbereitungen

Bevor wir die Scan-Funktionen implementieren, müssen wir unsere App für die Verwendung des Scanbot SDK vorbereiten. Beginnen wir damit, die Unterstützung für die Verwendung der Kamera-API hinzuzufügen. 

Dazu müssen Sie den Key NSCameraUsageDescription wie folgt in die Datei Info.plist einfügen:

HINWEIS: Wenn Sie keine Testlizenz haben, überspringen Sie den nächsten Schritt und verwenden Sie das Scanbot SDK im Testmodus. Siehe dazu auch die Hinweise zum Lizenzschlüssel am Ende dieses Tutorials.

So fügen Sie einen Scanbot SDK-Testlizenzschlüssel hinzu:


import UIKit
import ScanbotSDK

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

	func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
//        Uncomment this line if you have a license.
//        ScanbotSDK.setLicense("See the license key notes below!")
        return true
    }
}

Los gehts mit dem Coden!

Erstellung einer Benutzeroberfläche für unser Projekt


class ViewController: UIViewController {

    @IBOutlet private var scannedDocumentImageView: UIImageView?

    override func viewDidLoad() {
        super.viewDidLoad()
    }
    
    @IBAction func scanButtonDidTap(_ sender: UIButton) {}
}


Hinzufügen des Scanners


import ScanbotSDK

class ViewController: UIViewController, SBSDKUIDocumentScannerViewControllerDelegate {

    @IBOutlet private var scannedDocumentImageView: UIImageView?
    private var scannerViewController: SBSDKUIDocumentScannerViewController?

    override func viewDidLoad() {
        super.viewDidLoad()
    }
    
    @IBAction func scanButtonDidTap(_ sender: UIButton) {}
}

extension ViewController: SBSDKUIDocumentScannerViewControllerDelegate {
    func scanningViewController(_ viewController: SBSDKUIDocumentScannerViewController,
                                didFinishWith document: SBSDKUIDocument) {
    }
}

override func viewDidLoad() {
    super.viewDidLoad()
    
    let configuration = SBSDKUIDocumentScannerConfiguration.default()
    self.scannerViewController = SBSDKUIDocumentScannerViewController.createNew(with: configuration, andDelegate: self)
}

HINWEIS: Für dieses Projekt verwenden wir die Standardkonfiguration (SBSDKUIDocumentScannerConfiguration.default()). Sie können die Benutzeroberfläche, den Text und das Verhalten aber auch ganz nach Wunsch anpassen. Schauen Sie sich dazu die Konfigurationseigenschaften uiConfiguration, textConfiguration und behaviorConfiguration der SBSDKUIDocumentScannerConfiguration-Instanz an.


@IBAction func scanButtonDidTap(_ sender: UIButton) {
    if let scannerViewController = self.scannerViewController {
        self.present(scannerViewController, animated: true, completion: nil)
    }
}

    func scanningViewController(_ viewController: SBSDKUIDocumentScannerViewController,
                                didFinishWith document: SBSDKUIDocument) {
        self.scannedDocumentImageView?.image = document.page(at: 0)?.documentImage()
    }

Und das war’s! 

Erstellen Sie nun ihre App und führen Sie sie auf einem echten Gerät aus. Sie können jetzt den Scanbot Document Scanner starten, ein Dokument scannen und sich das resultierende Bild anzeigen lassen.

Fazit

Herzlichen Glückwunsch! 🥳  Sie haben soeben mit nur wenigen Zeilen Code einen voll funktionsfähigen Document Scanner gebaut. 

Die Document Scanner-Komponente, die wir hier gerade integriert haben, ist eine sogenannte Ready-to-Use UI (RTU-UI) SDK-Komponente. Die RTU-UI-Komponenten, die im Scanbot SDK enthalten sind, decken alle gängigen Anwendungsfälle des Scannens ab. Sie sind außerdem leicht zu integrieren und anzupassen. 

Neben den RTU-UI-Komponenten bietet das Scanbot SDK auch Classic- Komponenten. Mit diesen können Sie eine vollständig anpassbare Benutzeroberfläche erstellen. Weitere Details finden Sie in unserer Dokumentation.

Sie können diese Beispielanwendung hier herunterladen.

Um alle beeindruckenden Funktionen des Scanbot SDKs auszuprobieren, laden Sie das vollständige iOS Beispielprojekt herunter. Dieses integriert alle API-Funktionen, wie z.B. Cropping UI, Image Filtering, PDF und TIFF Rendering, OCR (Texterkennung), Barcode und QR Code Scanning, MRZ Scanning (Machine Readable Zones) und EHIC Scanning (Europäische Krankenversicherungskarte).

Scanbot SDK (Testversion) Lizenzschlüssel

Bitte beachten Sie: Ohne Lizenzschlüssel läuft das Scanbot SDK nur für eine Minute pro Sitzung! Nach Ablauf des Testzeitraums werden alle Funktionen des Scanbot Scanner SDK deaktiviert und  die Benutzeroberflächen beendet. 

Alternativ können Sie unverbindlich eine kostenlose, uneingeschränkte 30-Tage-Testlizenz anfordern.

Da Scanbot SDK-Lizenzschlüssel an einen Bundle Identifier gebunden sind, müssen Sie – wie in dieser Tutorial-App – den Standard-Bundle Identifier com.example.MyAwesomeIOSApp verwenden. Alternativ können Sie auch die ID Ihrer eigenen Anwendung angeben, wenn Sie Ihre Testlizenz beantragen. Bitte beachten Sie dabei die Groß- und Kleinschreibung!

Viel Spaß beim Programmieren! 👩💻🧔🏿💻

Wenn Sie Hilfe benötigen, wenden Sie sich bitte an einen unserer Experten. Wir helfen Ihnen gerne weiter. 

Das Scanbot Fact Sheet: Alle Informationen auf einen Blick!

Scanbot verarbeitet und nutzt die angegebenen Informationen, um Sie bzgl. unserer Produkte zu kontaktieren und Ihnen den monatlichen Newsletter zuzusenden. Sie können diesen Service jederzeit deabonnieren. Hinweise zum Widerruf und zu der Verarbeitung Ihrer Daten finden Sie in unserer Datenschutzerklärung.

Bereit zum Ausprobieren?

Sprechen Sie mit einem unserer Lösungsexperten, um herauszufinden, wie wir Ihre Anforderungen an die mobile Datenerfassung lösen können, oder integrieren Sie das Scanbot SDK gleich in Ihre eigene mobile App oder Webseite.

Kontaktieren Sie uns
Jetzt testen

Entwickler, bereit loszulegen?

Das Hinzufügen der kostenlosen 30-Tage Testlizenz zu Ihrer App ist einfach. Laden Sie das Scanbot SDK jetzt herunter und entdecken Sie die Vorteile der mobilen Datenerfassung.