Some test text!

Search
Hamburger Icon

Android / FAQ / Add a license key

Add license keys

The Apryse library is automatically initialized if you have added a valid license key to your project's AndroidManifest.xml file. Alternatively, you can add the key by manually calling the static initialization methods. Before moving forward, please make sure you have added the Apryse libraries to your project .

No trial license key required.
The trial of Apryse SDK does not require a trial key. A commercial license key is required for use in a production environment. Please fill out our contact form if you do not have a valid license key.
Keep your license keys confidential.
License keys are uniquely generated. Please make sure that it is not publicly available (e.g. in your public GitHub).

Auto-initialize by adding a license key in AndroidManifest.xml

The Apryse Android SDK is auto-initialized only if there is a key defined in the AndroidManifest.xml file named pdftron_license_key. If you prefer to initialize Apryse manually, see the next section for more information.
  1. Find your gradle.properties file in the root folder of your project and add your license key:

    PDFTRON_LICENSE_KEY=INSERT_COMMERCIAL_LICENSE_KEY_HERE_AFTER_PURCHASE
  2. Then in your module's build.gradle file (usually located at app/build.gradle) add:

    android {
        defaultConfig {
            // ...
            manifestPlaceholders = [pdftronLicenseKey:PDFTRON_LICENSE_KEY]
        }
    }
  3. Add a placeholder for the license key to your project's AndroidManifest.xml file, inside the <application> tag:

    <application
        ...>
    
        <!-- Add license key in meta-data tag here. This should be inside the application tag. -->
        <meta-data
            android:name="pdftron_license_key"
            android:value="${pdftronLicenseKey}"/>
            
    </application>

    This tag will inject a build variable containing your license key into the manifest file.

    Next try opening a document in an activity .

Disable auto-initialization

It's also possible to disable auto-initialization altogether by adding the following to the <application> tag in your project's AndroidManifest.xml file:

<provider
    xmlns:tools="http://schemas.android.com/tools"
    android:name="com.pdftron.pdfnet.PDFNetInitializer"
    android:authorities="${applicationId}.pdftron-pdfnet"
    tools:node="remove" />


<provider
    xmlns:tools="http://schemas.android.com/tools"
    android:name="com.pdftron.pdf.utils.PDFTronToolsInitializer"
    android:authorities="${applicationId}.pdftron-tools"
    tools:node="remove" />

Manually initialize by adding a license key directly in your code

Please ensure that you do not have pdftron_license_key defined in your AndroidManifest.xml file, otherwise Apryse will be auto-initialized using this key.

Depending on the package you are using , you will need to call different initialization methods. In your main application's or main activity's onCreate method (and before setContentView in your activity) call one of the following:

  • Tools package:

    If you are using com.pdftron:tools dependency (i.e. using implementation "com.pdftron:tools:11.1.0" in your app/build.gradle file):

    com.pdftron.pdf.utils.AppUtils.initializePDFNetApplication(getApplicationContext(), "Insert commercial license key here after purchase");
  • Apryse package:

    If your application requires greater flexibility and you are using classes in the Apryse package directly, you can initialize using the following method instead:

    PDFNet.initialize(getApplicationContext(), R.raw.pdfnet, "Insert commercial license key here after purchase");

    If you are also using a the Tools library (i.e. com.pdftron:tools) call:

    AppCompatDelegate.setCompatVectorFromResourcesEnabled(true);

    Please note that if you use PDFNet.initialize, you will have to set up the Apryse library manually (for more information see the Apryse class documentation).

Next try opening a document in an activity .

Trial setup questions? Ask experts on Discord
Need other help? Contact Support
Pricing or product questions? Contact Sales