Nutrient for Android - Custom Fonts Example

This is the custom fonts example of Nutrient for Android. This example shows how to ship custom font files with an app so that they can be used in situations where PDF documents require custom fonts that are not part of the Android operating system. This example is written in Kotlin, but all functions also apply to Nutrient when using Java or any other compatible programming language.

Prerequisites

• The latest stable Android Studio version available here.

Getting Started

Clone and check out the custom fonts example repository on your local machine:

git clone https://github.com/PSPDFKit/pspdfkit-android-custom-fonts-example.git
cd pspdfkit-android-custom-fonts-example

You can now open the project inside Android Studio, or build and install the app directly from the command line:

./gradlew :installDebug

Example Description

Structure

assets/: The assets folder of the app (app/src/main/assets/) contain a custom PDF file called Example-Fonts.pdf. This PDF references fonts that are not part of the default system fonts of the Android operating system.

Furthermore, the assets folder contains two custom TrueType font files, which will be added to Nutrient's font include path, so that Nutrient will be able to properly render the example document.

CustomFontsActivity: This app comes with a single activity class which, upon launched, prepares the custom fonts for usage, and then launches a default PdfActivity for displaying the document with custom fonts.

Disabling automatic initialization

This example project does not specify the pspdfkit_license_key as meta-data element inside the AndroidManifest.xml. This is intentional, and prevents Nutrient from automatically initializing without custom fonts. Instead, custom font loading requires the app to manually initialize Nutrient using PSPDFKit.initialize(context, InitializationOptions(licenseKey, fontPaths)).

License

This software is licensed under a modified BSD license.

Additional Resources

• Nutrient for Android online guides: https://nutrient.io/guides/android/current/
• Nutrient API reference:
  • KDoc: https://nutrient.io/api/android/kdoc/
  • Javadoc: https://nutrient.io/api/android/javadoc/
• Nutrient technical customer support: https://nutrient.io/support/request/