PDF : PlugPDF (Not free )

Making an Android application with the PlugPDF SDK

This tutorial walks you through the necessary steps to run a simple, fully functional mobile PDF reader on an Android device. The goal is to get familiar with some basic PlugPDF concepts, as well as to build your first PDF Android application with Android Studio.

Requirements

1. An up-to-date version of Android Studio and SDK tools, which can be downloaded from Android’s Developer site.
2. The PlugPDF SDK supports Android SDK 3.2 (Honeycomb, API 13) onwards.
3. PlugPDF latest Library download  https://plugpdf.com/download/ or click this link - https://drive.google.com/file/d/0BzTjcv17QPlwc090THhOWFlDOUE/view?usp=sharing

Steps required for making your first PDF Android app

1. Download the PlugPDF SDK
2. Create a new Android project
3. Add the PlugPDF framework
4. Compile the plugpdf module
5. Initialize the PlugPDF SDK and build the sample PDF viewer

1. Download the PlugPDF SDK

Download either a free trial license or an indie license as shown in the figure below.

Figure 1. Download PlugPDF now!

You will then be redirected to a web page from which both PlugPDF for Android and iOS can be downloaded:

Figure 2. Thank you, your license key is on its way!

This is what the PlugPDF_Android folder looks like.

Figure 3. The PlugPDF_Android folder’s structure and content

On the other hand, you’ll instantly receive an email with your PlugPDF license key consisting of 56 alphanumeric characters like this example:

79F53DB9HHF9GH88EDB5297FH28FC6488AECC4EF496FB95A96CHFBF5

Please keep your license in a secure place since it will be required to initialize your PlugPDF applications, as we will show later in this paper.

2. Create a new Android project

Figure 4. Open Android Studio and choose File > New > New Project…

Figure 5. The Create New Project wizard will start. The first step is to fill the New Project dialog as shown here

Figure 6. Select API 15 (IceCreamSandwich) as the minimum SDK in the Target Android Devices dialog

Figure 7. Add a blank activity to your project

Figure 8. Finally, customize your activity as it is shown here, and click Finish

3. Add the PlugPDF framework

The next step is importing the PlugPDF SDK.

Figure 9. Choose File > New > Import Module…

Figure 10. Select the plugpdf folder from the PlugPDF_Android directory and click Finish

Now wait a few seconds until the Gradle execution finishes, at the end of this process your Android Studio should look like the image below.

Figure 11. app and plugpdf modules

By the way, at this point you may get this error: Failed to sync Gradle project ‘Sample’. Cause: failed to to find target with hash string ‘android-15’. In that case, please open the Android SDK Manager and make sure to install the SDK Platform Android 4.0.3, API level 15.

4. Compile the plugpdf module

The plugpdf module needs to be compiled so that the PlugPDF SDK’s Java object types will be recognized; otherwise, Android Studio will show the notice “Cannot resolve symbol” when trying to identify PlugPDF types such as the following:

• PlugPDF
• PlugPDFException
• SimpleDocumentReader
• SimpleDocumentReaderListener
• DocumentState

This is because the compile project(':plugpdf') dependency must be added to the (Module: app) gradle script as shown below:

1 2 3 4 5 6 7

dependencies {     compile fileTree(dir: 'libs', include: ['*.jar'])     testCompile 'junit:junit:4.12'     compile 'com.android.support:appcompat-v7:23.1.1'     compile 'com.android.support:design:23.1.1'     compile project(':plugpdf') }

5. Initialize the PlugPDF SDK and build the sample PDF viewer

Let us recapitulate. At this stage we’ve just created a new Android application with a blank activity. Well, now make sure to update the following three files in order to run the sample PDF reader:

• AndroidManifrest.xml
• content_main.xml
• MainActivity.java

As it illustrated below:

AndroidManifrest.xml file:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android"     package="com.plugpdf.com.sample">       <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>     <uses-permission android:name="android.permission.INTERNET" />       <application         android:allowBackup="true"         android:icon="@mipmap/ic_launcher"         android:label="@string/app_name"         android:supportsRtl="true"         android:theme="@style/AppTheme">         <uses-sdk android:minSdkVersion="15"/>         <activity             android:name=".MainActivity"             android:label="@string/app_name"             android:theme="@style/AppTheme.NoActionBar">             <intent-filter>                 <action android:name="android.intent.action.MAIN" />                   <category android:name="android.intent.category.LAUNCHER" />             </intent-filter>         </activity>     </application>   </manifest>

content_main.xml file:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"     xmlns:app="http://schemas.android.com/apk/res-auto"     xmlns:tools="http://schemas.android.com/tools"     android:layout_width="match_parent"     android:layout_height="match_parent"     android:paddingBottom="@dimen/activity_vertical_margin"     android:paddingLeft="@dimen/activity_horizontal_margin"     android:paddingRight="@dimen/activity_horizontal_margin"     android:paddingTop="@dimen/activity_vertical_margin"     app:layout_behavior="@string/appbar_scrolling_view_behavior"     tools:context="com.plugpdf.com.sample.MainActivity"     tools:showIn="@layout/activity_main">       <Button         android:layout_width="wrap_content"         android:layout_height="wrap_content"         android:text="Select a PDF file"         android:id="@+id/selectFileButton"         android:layout_alignParentTop="true"         android:layout_centerHorizontal="true" /> </RelativeLayout>

MainActivity.java file:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114

package com.plugpdf.com.sample;   import android.app.Activity; import android.content.Intent; import android.net.Uri; import android.os.Bundle; import android.util.Log; import android.view.View; import android.webkit.MimeTypeMap; import android.widget.Button; import android.widget.Toast;   import com.epapyrus.plugpdf.SimpleDocumentReader; import com.epapyrus.plugpdf.SimpleDocumentReaderListener; import com.epapyrus.plugpdf.SimpleReaderFactory; import com.epapyrus.plugpdf.core.PlugPDF; import com.epapyrus.plugpdf.core.PlugPDFException; import com.epapyrus.plugpdf.core.viewer.DocumentState;   import java.io.File;   public class MainActivity extends Activity {       // private ReaderView mReader;     private SimpleDocumentReader mReader;     private Button selectFileButton;     final int ACTIVITY_CHOOSE_FILE = 1;       @Override     protected void onCreate(Bundle savedInstanceState) {           super.onCreate(savedInstanceState);         setContentView(R.layout.activity_main);           // init PlugPDF         try {             PlugPDF.init(getApplicationContext(),                     "6AB4CF59HG4CFH34ED347F2EF48EGE596HA2639D4B588HH2DH5FFBF5");         } catch (PlugPDFException.InvalidLicense ex) {             Log.e("PlugPDF", "Invalid license exception", ex);         }           selectFileButton = (Button) findViewById(R.id.selectFileButton);           selectFileButton.setOnClickListener(new View.OnClickListener() {             @Override             public void onClick(View arg0) {                 Intent chooseFile = new Intent(Intent.ACTION_GET_CONTENT);                 chooseFile.setType("application/pdf");                 startActivityForResult(Intent.createChooser(chooseFile, "Choose a file"), ACTIVITY_CHOOSE_FILE);             }         });       }       @Override     protected void onActivityResult(int requestCode, int resultCode, Intent data) {         // Check which request we're responding to         if (requestCode == ACTIVITY_CHOOSE_FILE) {             // Make sure the request was successful             if (resultCode == RESULT_OK) {                 // get the file uri                 Uri fileUri = data.getData();                 // validate the file                 String validationMssg = validateFile(fileUri);                 if(validationMssg != null) {                     Toast toast = Toast.makeText(getApplicationContext(), validationMssg, Toast.LENGTH_LONG);                     toast.show();                 }                 else {                     // launch the PDF viewer                     mReader = SimpleReaderFactory.createSimpleViewer(this, listener);                     mReader.openFile(fileUri.getPath(), "");                 }             }         }     }       /**      * listener implemented to receive event notifications on completion of PDF document loading on a {@link SimpleDocumentReader}      */     private SimpleDocumentReaderListener listener = new SimpleDocumentReaderListener() {           @Override         public void onLoadFinish(DocumentState.OPEN state) {             Log.i("PlugPDF", "[INFO] Open " + state);         }     };       private String validateFile(Uri uri) {         String mssg = null;         String extension = MimeTypeMap.getFileExtensionFromUrl(uri.toString());         File file = new File(uri.getPath());         // is the file readable?         if(!file.canRead()) {             mssg = "File selected: ".concat(uri.getPath()).concat("\nPlease, select a PDF file from your SD card");         }         // simple extension check         else if (!extension.toLowerCase().equals("pdf")) {             mssg = "File selected: ".concat(uri.getPath()).concat("\nPlease, select a PDF file from your SD card");         }         return mssg;     }       @Override     protected void onDestroy() {         if (mReader.getDocument() != null) {             mReader.save();             mReader.clear();         }         super.onDestroy();     }   }

Running the Simple Document Reader

Congratulations! Finally we are ready to run the application. As you will notice this simple yet effective PDF reader comes out of the box with these powerful features.

• Rotate
• Page display mode
• Brightness
• Outline
• Search
• Edit

Figure 12. The user is asked to pick a file from their SD card

Figure 13. The PDF document selected is then displayed

Figure 14. The user taps on the screen and the navigation bar is shown