Einsatz CIB Module unter Android technischer Leitfaden (DE)

3. SDK

3.2. Integration

Allgemein
 Setzen der Lizenz
 Prüfen der Lizen
Allgemein

Die CIB Modulen werden für Android als AAR geliefert. Das AAR kann wie folgt in eine bestehende Android-Anwendung integriert werden. Dabei wird auf Android Studio als Entwicklungsumgebung gesetzt.

Die im Lieferumfang enthaltene Beispielintegration („Showcase“) kann ebenfalls als Vorlage für die Integration genutzt werden.

  1. In Android Studio, wählen Sie „File“ ➔ „New“ ➔ „Module“.
  2. Im Dialog wählen Sie „Import .JAR/.AAR Package“ und klicken „Next“.
  3. Wählen Sie den Pfad zum AAR mit den CIB Modulen aus und klicken Sie „Finish“.
  4. Klicken Sie anschließend in der Werkzeugleiste auf „Sync Project with Gradle Files“.

Setzen der Lizenz

Die Lizenz besteht jeweils aus Ihrem Kundennamen („Company“) und einem Schlüssel („Key“). Diese müssen Sie über eine Ressourcendatei in Ihrem existierenden Projekt, wie z.B. eine „strings.xml“, als Strings gesetzt werden. Fügen Sie dazu folgende Zeilen in eine bestehende „strings.xml“ ein.

<item name="cibPdfToolboxLicenseCompany" format="string" type="string" 
translatable="false">REQUEST FROM CIB SUPPORT</item>
<item name="cibPdfToolboxLicenseKey" format="string" type="string" 
translatable="false">REQUEST FROM CIB SUPPORT</item>
<item name="cibOcrLicenseCompany" format="string" type="string" 
translatable="false">REQUEST FROM CIB SUPPORT</item>
<item name="cibOcrLicenseKey" format="string" type="string" 
translatable="false">REQUEST FROM CIB SUPPORT</item>

Als Werte setzten Sie die separat ausgehändigten Lizenzschlüsselpaare. Die Werte müssen exakt so gesetzt werden, wie Sie sie von uns erhalten haben.


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.