If you do not already have an existing application, create a new Visual Studio Xamarin.Android project with Single View App.

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

2. Enable largeHeap and usesClearTextTraffic:

   <application
       ...
       android:largeHeap="true"
       android:usesCleartextTraffic="true">
       ...
   </application>

3. 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 version="1.0" encoding="utf-8"?>
   <manifest ...>
       <!-- Required permissions are added here -->
       <uses-permission android:name="android.permission.INTERNET"/>
       <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
       <uses-permission android:name="android.permission.RECORD_AUDIO" />
   
       <!-- Add multidex support, enable largeHeap, and enable usesCleartextTraffic -->
       <application 
           ...
           android:largeHeap="true"
           android:usesCleartextTraffic="true">    
           
           <!-- Add license key in meta-data tag here. This should be inside the application tag. -->
           <meta-data
               android:name="pdftron_license_key"
               android:value="INSERT_COMMERCIAL_LICENSE_KEY_HERE_AFTER_PURCHASE"/>
               
           <!-- Document viewer activity declaration-->
           <activity android:name="com.pdftron.pdf.controls.DocumentActivity"
               android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
               android:windowSoftInputMode="adjustPan"
               android:theme="@style/CustomAppTheme"/>
           ...
       </application>
   </manifest>

4. Add the following two lines at the end of the OnCreate method in MainActivity.cs:

   var config = new pdftron.PDF.Config.ViewerConfig.Builder().OpenUrlCachePath (this.CacheDir.AbsolutePath).Build();
     pdftron.PDF.Controls.DocumentActivity.OpenDocument(this, Android.Net.Uri.Parse("https://pdftron.s3.amazonaws.com/downloads/pdfref.pdf"), config);

   Note that using the cache is a temporary solution and you should request runtime permissions for external storage.
5. Build your project and deploy it to your Android Device/Emulator. You should see the viewer start up:

linkNext step

CustomizeAdd a PDFTron license key