Skip to main content

SDK Initialization

License Key​

The Docutain SDK is a commercial product and requires a paid license for production use.

It needs a valid, non-expired license key in order to work. For Android the license is bound to the applicationId which you can find in the build.gradle file of your Android project.

 defaultConfig {
    ...
    applicationId "de.docutain.sdk.sample"
    ...
}

For iOS the license is bound to the Bundle identifier which you can find in the "General" or "Signing & Capabilities" settings tab of your project in Xcode.

iOSBundleIdentifier

Trial license​

Without a license key, you can test the Docutain SDK for 60 seconds.

In order to get a trial license, please visit our website via https://sdk.docutain.com/TrialLicense to generate a trial license key.

Production license​

To get information about the SDK's functionality and pricing and to purchase a production license, please contact us.

Initialize the SDK​

Make sure you have followed the Getting started guide.

In order to use any functionality of the SDK, you must initialize it first.

bool isDocutainPluginInitialized = await DocutainSdk.initSDK("<YOUR-LICENSE-KEY>");
if(!isDocutainPluginInitialized){
    //get the last error message
    String error = await DocutainSdk.getLastError();
    //implement handling to avoid accessing Docutain SDK when it is not initialized
}
caution

If the initialization fails, you are responsible to deactivate access to SDK functionality.

Logging​

The SDK writes certain information into a log file. You can get the log file by calling DocutainSdkLogger.getTraceFile(). You can send this log file to us if you have any issues/bugs with the SDK. The Logger has certain levels that you can set depending on your needs. However, we suggest to leave the level to it's default value which ensures that in case of any issues/bugs we can get all the information we need from you.

//get the log file
var traceFile = await DocutainSdkLogger.getTraceFile();

//set the log level
DocutainSdkLogger.setLogLevel(Level.verbose);