Product:

Get started

Samples

Open/Save Document

Learn more

Viewer

UI Customization

Annotation

Collaboration

MS Office

Generate via template

Conversion

PDF/A

Forms

Generate

Page manipulation

Editing page content

Extraction

Digital signature

Bookmarks

Compare files

Optimization

Layers (OCGs)

Measurement

Redaction

Security

Portfolios

Low-level PDF API

Changelogs

Open documents using Activity with Apryse Android SDK

Apryse's Android SDK ships with DocumentActivity, an all-in-one document reader and PDF editor. In addition to PDF files, it also supports viewing other file formats such as .docx, .doc, .pptx, .xlsx, .md, .cbz and various image formats. In this activity you can also read, annotate, sign, fill in PDF forms and more.

DocumentActivity extends Android's AppCompatActivity and follows Material design guidelines.

Prerequisites

Integrated Apryse into your project and added the com.pdftron:tools package into your project.
Minimum API: 16 (using AndroidX)
Compile API: 35
Recommended target API: 35

No trial license key required.

The trial of Apryse Mobile SDK does not require a trial key. A commercial license key is required for use in a production environment. Please contact sales to purchase a commercial key or if you need any other license key assistance.

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).

Step 1: Update AndroidManifest.xml

In order to support all the features in DocumentActivity, we will need to add the Android permissions listed in this table. However if you would like to disable certain features and customize your document viewer, you should leave out unnecessary permissions.

Storage permission

Please note that from Android 6.0 (API 23) and up, applications need to request storage permission at runtime before accessing any files on device.

Enable largeHeap and set android:name in the <application> tag to MultiDexApplication:

XML

1<!-- Include existing attributes in application -->
2<application android:name="androidx.multidex.MultiDexApplication" android:largeHeap="true" android:usesCleartextTraffic="false">
3</application>

If your app is targeting Android SDK version 28 or higher, you will need to add the android:usesCleartextTraffic="true" attribute in your application tag to open HTTP files in the viewer. If you are only working with HTTPS files, this is not required.

If you have not done so already, add the <meta-data> tag containing a reference to your license key in the AndroidManifest.xml file. Also, declare DocumentActivity in the same file. The final AndroidManifest.xml file should look something like this:

XML

1<?xml version="1.0" encoding="utf-8"?>
2<!-- Include existing attributes in application -->
3<manifest>
4    <!-- Required permissions are added here -->
5    <uses-permission android:name="android.permission.INTERNET"/>
6    <uses-permission android:name="android.permission.RECORD_AUDIO" />
7
8    <!-- Add multidex support, enable largeHeap -->
9    <!-- Include existing attributes in application -->
10    <application android:name="androidx.multidex.MultiDexApplication" android:largeHeap="true" android:usesCleartextTraffic="false">    
11
12        <!-- Add license key in meta-data tag here. This should be inside the application tag. -->
13        <meta-data android:name="pdftron_license_key" android:value="${pdftronLicenseKey}"/>
14            
15        <!-- Document viewer activity declaration-->
16        <activity android:name="com.pdftron.pdf.controls.DocumentActivity" android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize" android:windowSoftInputMode="adjustPan" android:theme="@style/PDFTronAppTheme"/>
17    </application>
18</manifest>

Step 2: Launch the viewer

Launch DocumentActivity by specifiying a local file path, an HTTP/HTTPS url, or a Content Uri:

1import android.net.Uri;
2import java.io.File;
3import com.pdftron.pdf.controls.DocumentActivity;
4
5// Set the cache location using the config to store the cache file
6ViewerConfig config = new ViewerConfig.Builder().openUrlCachePath(this.getCacheDir().getAbsolutePath()).build();
7
8// from internal storage
9final Uri uri = Uri.fromFile(new File("myLocalFilePath"));
10// from content uri
11final Uri uri = Uri.parse("myContentUri");
12// from http/https
13final Uri uri = Uri.parse("myFileLink");
14// from assets
15final Uri uri = Uri.parse("file:///android_asset/my_file.pdf");
16
17// intent builder
18Intent intent = DocumentActivity.IntentBuilder.fromActivityClass(this, DocumentActivity.class)
19        .withUri(uri)
20        .usingConfig(config)
21        .usingTheme(R.style.PDFTronAppTheme)
22        .build();
23startActivity(intent);

1import android.net.Uri
2import java.io.File
3import com.pdftron.pdf.controls.DocumentActivity
4
5// Set the cache location using the config to store the cache file
6val config = ViewerConfig.Builder().openUrlCachePath(this.getCacheDir().getAbsolutePath()).build();
7
8// from internal storage
9val uri = Uri.fromFile(new File("myLocalFilePath"))
10// from content uri
11val uri = Uri.parse("myContentUri")
12// from http/https
13val uri = Uri.parse("myFileLink")
14// from assets
15val uri = Uri.parse("file:///android_asset/my_file.pdf")
16
17// intent builder
18val intent: Intent = DocumentActivity.IntentBuilder.fromActivityClass(this, DocumentActivity::class.java)
19        .withUri(uri)
20        .usingConfig(config)
21        .usingTheme(R.style.PDFTronAppTheme)
22        .build()
23startActivity(intent)

Step 3: (Optional) Customize the viewer

If you would like to customize the appearance of the viewer activity, define PDFTronAppTheme in res/values/styles.xml:You can learn more about this in the customize the viewer's theme guide .

XML

1<style name="PDFTronAppTheme" parent="PDFTronAppThemeBase"> <item name="colorPrimary">@color/app_color_primary_day</item> <item name="colorPrimaryDark">@color/app_color_primary_dark_day</item> <item name="colorAccent">@color/app_color_accent</item> <!-- Action bar --> <item name="actionModeBackground">?attr/colorPrimary</item> <item name="windowActionModeOverlay">true</item> </style>

DocumentActivity uses the AppCompat theme for material colors. Make sure that the value of android:theme in your activity tag also extends the AppCompat theme.

Also, if you would like to customize the UI components in DocumentActivity, you can use ViewerConfig.Builder. For example:For details on customizing the UI and using ViewerConfig.Builder, check out the configuration tutorial .

1import com.pdftron.pdf.config.ViewerConfig;
2
3ViewerConfig.Builder builder = new ViewerConfig.Builder();
4ViewerConfig config = builder
5    .fullscreenModeEnabled(true)
6    .multiTabEnabled(true)
7    .documentEditingEnabled(true)
8    .longPressQuickMenuEnabled(true)
9    .toolbarTitle("Simple Reader")
10    .showSearchView(true)
11    .build();

1import com.pdftron.pdf.config.ViewerConfig
2
3val builder = ViewerConfig.Builder()
4val config = builder
5  .fullscreenModeEnabled(true)
6  .multiTabEnabled(true)
7  .documentEditingEnabled(true)
8  .longPressQuickMenuEnabled(true)
9  .toolbarTitle("Simple Reader")
10  .showSearchView(true)
11  .build()