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.
- Eclipse (ADT Bundle)
- Android SDK 3.2 (Honeycomb – API 13)
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.
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.
- The PlugPDF library files to be linked with your app
- The base viewer source files and resources
- API reference documentation generated by Doxygen
- 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:
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.
Now you’ll be able to select both
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.
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