Building the Sample Project with Eclipse

To develop a simple PDF reader for Android devices such as PDF based eBook or eBrochure, starting from the sample project which is bundled with the SDK package would be a good choice.

You need to have the following software installed on your computer before going through this tutorial.

This guide assumes you are using v4.2 (Juno) or later with a default install. You also need Java v1.6 or later.

This guide also assumes that you have basic knowledge and experiences with Android development.

Building the Sample Project with Eclipse

Download the PlugPDF_Android.zip file

The PlugPDF SDK for Android can be downloaded from https://plugpdf.com/download/.

Once you unzip the PlugPDF_Android.zip file in the folder of your choice, you’ll notice the PlugPDF_Android folder consists in the following.

plugpdf

  • The PlugPDF library files to be linked with your app
  • The base viewer source files and resources
  • API reference documentation generated by Doxygen

sample

  • The sample project used in this tutorial

Get your License Key

A license key is required in order to use the PlugPDF SDK. There are three different types of licenses available:

  • Retail
  • Trial
  • Free

If you are an indie developer you can download for free the Free License Key from https://plugpdf.com/download/; otherwise either download a Trial license key for evaluation, or purchase a Retail license key.

All license types provide you with a fully functional PlugPDF SDK without any restrictions other than the evaluation period of the Trial key which is limited to 30 days.

Import the SDK

To import the SDK library along with the sample project click the File > Import menu option and select General / Existing Projects into Workspace.

Select your SDK folder (in this tutorial we unpacked the SDK package into the /Users/dave/PlugPDF_Android folder) and click Finish.

Eclipse Import Dialog

Now you’ll be able to select both plugpdf and sample in the Package Explorer.

If the Android SDK 3.2 (API 13) is not installed on your development environment, you’ll get some compiler warnings and/or errors in which case you have to install the Android SDK 3.2 (API 13).

Finally, make sure the Is Library option is checked in the Properties for plugpdf dialog as shown below.

android_tutorial_6

You are now ready to run the sample PDF viewer app! Run the sample project as an Android Application.

Last but not least, if you change the bundle ID in the sample project, please make sure that you enter the valid license key in PlugPDFLauncherApplication.java.

0 replies

Leave a Reply

Want to join the discussion?
Feel free to contribute!

Leave a Reply

Your email address will not be published. Required fields are marked *