Update to latest features with framework version 1.6.3.1

Author: MarvinFrankenfeld

.DS_Store

@@ -19,19 +19,23 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
         initRootWindow()
 
         //the Docutain SDK needs to be initialized priot to using any functionality of it
-        //a valid license key is required (contact us via [mailto:sdk@Docutain.com] to get a trial license
+        //a valid license key is required, you can generate one on our website https://sdk.docutain.com/TrialLicense?Source=721410
         if(!DocutainSDK.initSDK(licenseKey: licenseKey)){
             //init of Docutain SDK failed, get last error message
             print("InitSDK failed with error: \(DocutainSDK.getLastError())")
             if(licenseKey == "YOUR_LICENSE_KEY_HERE"){
                 showLicenseEmptyInfo()
                 return false
+            } else{
+                showLicenseErrorInfo()
+                return false
             }
         }
 
         if #available(iOS 13.0, *) {
-            //If you want to use text recognition (OCR) and/or data extraction features, you need to set the AnalyzeConfiguration
-            //in order to start all the necessary processes
+            //Reading payment state and BIC when getting the analyzed data is disabled by default
+            //If you want to analyze these 2 fields as well, you need to set the AnalyzeConfig accordingly
+            //A good place to do this, is right after initializing the Docutain SDK
             let analyzeConfig = AnalyzeConfiguration()
             analyzeConfig.readPaymentState = true
             analyzeConfig.readBIC = true
@@ -75,26 +79,36 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
     }
 
     private func showLicenseEmptyInfo(){
-        let alert = UIAlertController(title: "License empty", message: "A valid license key is required. Please contact us via sdk@Docutain.com to get a trial license.", preferredStyle: .alert)
-        alert.addAction(UIAlertAction(title: "Get license", style: .default, handler: {_ in
-            let email = "sdk@Docutain.com"
-            let subject = "Trial License Request"
-            if let mailURLString = "mailto:\(email)?subject=\(subject)".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed),
-                   let mailURL = URL(string: mailURLString) {
-                    if UIApplication.shared.canOpenURL(mailURL) {
-                        UIApplication.shared.open(mailURL)
-                    } else {
-                        print("Mail can not be opened")
-                    }
-            } else{
-                print("Mail can not be opened")
+        let alert = UIAlertController(title: "License empty", message: "A valid license key is required. Please click \"Get License\" in order to create a free trial license key on our website.", preferredStyle: .alert)
+        alert.addAction(UIAlertAction(title: "Get License", style: .default, handler: {_ in
+            if let url = URL(string: "https://sdk.docutain.com/TrialLicense?Source=721410") {
+                UIApplication.shared.open(url, completionHandler: {_ in
+                    exit(0)
+                })
             }
             self.window?.isUserInteractionEnabled = false
         }))
-        alert.addAction(UIAlertAction(title: "Cancel".localized(), style: .cancel, handler: {_ in
-            exit(0)
+        window?.rootViewController?.present(alert, animated: true)
+    }
+    
+    private func showLicenseErrorInfo(){
+        let alert = UIAlertController(title: "License error", message: "A valid license key is required. Please contact our support to get an extended trial license.", preferredStyle: .alert)
+        alert.addAction(UIAlertAction(title: "Contact Support", style: .default, handler: {_ in
+            self.sendEmailToSupport(completion: {
+                exit(0)
+            })
         }))
         window?.rootViewController?.present(alert, animated: true)
     }
+    
+    func sendEmailToSupport(completion: @escaping () -> Void) {
+        let mailtoString = "mailto:support.sdk@Docutain.com?subject=Trial License Error&body=Please keep your following trial license key in this e-mail: \(licenseKey)".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)
+        let mailtoUrl = URL(string: mailtoString!)!
+        if UIApplication.shared.canOpenURL(mailtoUrl) {
+            UIApplication.shared.open(mailtoUrl) { success in
+                completion()
+            }
+        }
+    }
 }
 

DocutainSDKExampleiOSSwift.xcodeproj/project.pbxproj

@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "filename" : "icons8-document-50(@1×).png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "icons8-document-100(@2×).png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "icons8-document-150(@3×).png",
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

DocutainSDKExampleiOSSwift.xcodeproj/project.xcworkspace/xcuserdata/marvinfrankenfeld.xcuserdatad/UserInterfaceState.xcuserstate

@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "filename" : "icons8-scanner-50(@1×).png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "icons8-scanner-100(@2×).png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "icons8-scanner-150(@3×).png",
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

DocutainSDKExampleiOSSwift/.DS_Store

@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "filename" : "icons8-text-box-50(@1×).png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "icons8-text-box-100(@2×).png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "icons8-text-box-150(@3×).png",
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

DocutainSDKExampleiOSSwift/AppDelegate.swift

@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "filename" : "icons8-pdf-50(@1×).png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "icons8-pdf-100(@2×).png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "icons8-pdf-150(@3×).png",
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

DocutainSDKExampleiOSSwift/Assets.xcassets/.DS_Store

@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "filename" : "icons8-settings-50(@1×).png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "icons8-settings-100(@2×).png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "icons8-settings-150(@3×).png",
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

DocutainSDKExampleiOSSwift/Assets.xcassets/DataExtraction.imageset/Contents.json

@@ -0,0 +1,12 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  },
+  "symbols" : [
+    {
+      "filename" : "settings-settings_symbol.svg",
+      "idiom" : "universal"
+    }
+  ]
+}

DocutainSDKExampleiOSSwift/Assets.xcassets/DataExtraction.imageset/icons8-document-100(@2×).png

@@ -6,9 +6,81 @@
 //
 
 import Foundation
+import UIKit
 
 internal extension String{
     func localized() -> Self{
         return NSLocalizedString(self, comment: "")
     }
 }
+
+internal extension NSObject {
+    static var nameOfClass: String {
+        return NSStringFromClass(self).components(separatedBy: ".").last!
+    }
+}
+
+internal extension UITableViewCell {
+    static var identifier: String {
+        self.nameOfClass
+    }
+}
+
+internal extension UITableView {
+    func registerCell<T: UITableViewCell>(cell: T.Type) {
+        self.register(cell, forCellReuseIdentifier: cell.identifier)
+    }
+
+    func dequeueCell<T: UITableViewCell>(cell: T.Type) -> T? {
+        return dequeueReusableCell(withIdentifier: cell.identifier) as? T
+    }
+}
+
+internal extension UIColor{
+    convenience init(hexString: String) {
+            let hexString = hexString.trimmingCharacters(in: .whitespacesAndNewlines)
+            let scanner = Scanner(string: hexString)
+            
+            if hexString.hasPrefix("#") {
+                scanner.scanLocation = 1
+            }
+            
+            var color: UInt32 = 0
+            scanner.scanHexInt32(&color)
+            
+            let mask = 0x000000FF
+            let r = Int(color >> 16) & mask
+            let g = Int(color >> 8) & mask
+            let b = Int(color) & mask
+            
+            let red   = CGFloat(r) / 255.0
+            let green = CGFloat(g) / 255.0
+            let blue  = CGFloat(b) / 255.0
+            
+            self.init(red: red, green: green, blue: blue, alpha: 1)
+        }
+        
+        var hexString: String {
+            
+            var r: CGFloat = 0
+            var g: CGFloat = 0
+            var b: CGFloat = 0
+            var a: CGFloat = 0
+            
+            getRed(&r, green: &g, blue: &b, alpha: &a)
+            
+            let rgb: Int = (Int)(r * 255) << 16 | (Int)(g * 255) << 8 | (Int)(b * 255) << 0
+            
+            return String(format: "#%06x", rgb)
+        }
+}
+
+internal extension [String : String]{
+    var light: UIColor{
+        return UIColor(hexString: self["light"]!)
+    }
+    
+    var dark: UIColor{
+        return UIColor(hexString: self["dark"]!)
+    }
+}

DocutainSDKExampleiOSSwift/Assets.xcassets/DataExtraction.imageset/icons8-document-150(@3×).png

@@ -0,0 +1,31 @@
+//
+//  BoolSetting.swift
+//  DocutainSDKExampleiOSSwift
+//
+//  Created by Marvin Frankenfeld on 10.04.24.
+//
+
+import Foundation
+
+public class BoolSetting: Setting {
+    
+    public typealias Handler = (Bool, SettingType) -> Void
+
+    public let settingType: SettingType
+    public let title: String
+    public let subtitle: String
+    public internal(set) var value: Bool {
+        didSet { self.onChangeHandler(self.value, self.settingType) }
+    }
+    public let onChangeHandler: Handler
+
+    public init(settingType: SettingType,
+                initialValue: Bool,
+                onChangeHandler: @escaping Handler) {
+        self.title = settingType.rawValue.localized()
+        self.subtitle = "\(settingType.rawValue)_Description".localized()
+        self.value = initialValue
+        self.settingType = settingType
+        self.onChangeHandler = onChangeHandler
+    }
+}