Einsatz CIB Module unter iOS technischer Leitfaden (DE)

3. SDK

3.2. Integration

Allgemein
Setzen der Lizenz
Prüfen der Lizen

Allgemein

Die CIB Module werden für iOS als xcframework geliefert. Das xcframework kann wie folgt in eine bestehende iOS-Anwendung integriert werden. Dabei wird auf Xcode als Entwicklungsumgebung gesetzt.

Die im Lieferumfang enthaltene Beispielintegration („Showcase“) kann ebenfalls als Vorlage genutzt werden.

  1. In Xcode, markieren Sie ihr App-Projekt im „Project Navigator“.
  2. Unter „Targets“ wählen Sie Ihr App Target und öffnen die Seite „General“.
  3. Im Bereich „Linked Frameworks and Libraries” klicken Sie auf das „+“.
  4. Wählen Sie den Pfad zum xcframework mit den CIB Modulen und klicken Sie „Add“.


Setzen der Lizenz

Die Lizenz besteht jeweils aus Ihrem Kundennamen („Company“) und einem Schlüssel („Key“). Diese müssen Sie über Properties bei jedem Aufruf gesetzt werden.

Beispiel für CIB pdfToolbox und CIB ocr:

#define ocrLicenseCompany @"REQUEST FROM CIB SUPPORT
#define ocrLicenseKey @"REQUEST FROM CIB SUPPORT
#define pdfToolboxLicenseCompany @"REQUEST FROM CIB SUPPORT
#define pdfToolboxLicenseKey @"REQUEST FROM CIB SUPPORT
…
DXOCRJob *ocrJob = [[DXOCRJob alloc] init];
[ocrJob setValue:ocrLicenseCompany forProperty:COMOD_PROP_LICENSE_COMPANY];
[ocrJob setValue:ocrLicenseKey forProperty:COMOD_PROP_LICENSE_KEY];
…
DXPDFToolboxJob *pdfToolboxJob = [[DXPDFToolboxJob alloc] init];
[pdfToolboxJob setValue:pdfToolboxLicenseCompany forProperty:COMOD_PROP_LICENSE_COMPANY];
[pdfToolboxJob setValue:pdfToolboxLicenseKey forProperty:COMOD_PROP_LICENSE_KEY];


Prüfen der Lizen

Hinweis:
Eine Lizenz kann bestimmte Funktionen ein- oder ausschließen. Um sicher zu gehen ob ein Lizenzproblem vorliegt, muss das Tracefile geprüft werden. Dazu gehen Sie wie folgt vor.

  1. Stellen Sie sicher, dass bei Ihrem Aufruf an das jeweilige CIB Modul die Property „TraceFilename“ mit einem validen Dateipfad gesetzt ist.
  2. Starten Sie ihren Job.
  3. Nachdem der Job beendet ist, öffnen Sie auf dem Gerät den unter „TraceFilename“ angegebenen Dateipfad. Hier befindet sich der Trace des Jobs.
  4. Öffnen Sie das Tracefile. Wenn die Lizenz gültig ist, sollte u.a. folgende Zeile darin zu finden sein:

LICENSE: Valid license.

Ist dies nicht der Fall, prüfen Sie Ihre Lizenz. Falls das Problem weiter besteht, kontaktieren Sie den CIB Support.