Adobe PDF Library

Getting Started

What you Receive with the Product

The most recent version of Adobe PDF Library is version 15, released in the spring of 2016. We also support version 10 of the product.

Files and folders

Datalogics will provide you with the compressed files and directories for the Adobe PDF Library SDK as a self-extracting executable file, and appropriate to your platform:

  • EXE file for Windows
  • TAR for Unix or Linux
  • DMG for Macintosh

The file download will include program code, samples, and supporting materials for the core Adobe PDF library and for interfaces for Java and Microsoft .NET.  The CPlusPlus folders hold the DLL or JAR files, resources, and sample programs for the core PDF library.  The DLL files for .NET (including C# and VB.NET) and .jar files for Java are found in the “Binaries” folders under /Java and /DotNET.

If you purchase a copy of the Adobe PDF Library, Datalogics will provide you with an account name and password so that you can download a licensed installation file of the software from our FTP site. You can also use this FTP site to transfer files to and from Datalogics.  A free evaluation of the software is also available for Windows and Linux users.

Programming Reference for Java and .NET

In addition to the release code and sample programs, the download will include the online programming reference for Java and .NET. This is a pair of HTML resources that describe how to work with Java and with .NET code, with detailed descriptions of namespaces, classes, files, and elements.  This dual Programming Reference also provides license information and release notes, and is auto-generated using Doxygen from the Java and .NET program code.  You can open this tool by clicking on Index.html, in the directory:

APDFL15.0.4/Documentation/DotNET
or
APDFL15.0.4/Documentation/Java

Other PDF and Adobe PDF Library resources

Finally, you can also access these resources online:

  1. The PDF Reference, ISO 32000-1:2008, Document Management-Portable Document Format-Part 1: PDF 1.7, a comprehensive guide for developers to work with the PDF format. This document, published in 2008, is over 750 pages long and will likely answer any questions you have about creating software to work with PDF files.
  2. Adobe Systems PDFL SDK 15 HTML Help, Adobe Systems’ online help tool for Adobe PDF Library version 15.
  3. Adobe Systems ReadMe document for APDFL 15, Readme_for_PDFL_SDK_XV_15.0.4.

Supported Platforms and Compilers

The following table lists the supported platforms, operating system and compiler versions for the most recent release of the Adobe PDF Library. All of them are compatible with both 32 and 64 bit platforms.

Platform Operating System Version Compiler and Version
IBM AIX 6.1 (6L), 7.1 XL C/C++ v13.1, gcc 4.6 and higher, including 5.x
Hewlett Packard HP-UX 11i v3 (11.31 BOE) HP aCC, A.06.28.01, gcc 4.6 and higher, including 5.x
Linux Redhat Enterprise Linux 6, Linux 7 gcc 4.4 and higher, including 5.x
Ubuntu 12.04 LTS, 14.04 LTS gcc 4.6 and higher, including 5.x
Macintosh Mac OS X v10.8 (Mountain Lion) and later XCode 5.x, 6.x, 7.x
Windows Windows 7, 8.1, 10 Visual Studio 2013, Visual Studio 2015
Server 2008 R2 (SP2) Visual Studio 2013, Visual Studio 2015
Server 2012, 2012 R2 Visual Studio 2013, Visual Studio 2015
Server 2016 Visual Studio 2013, Visual Studio 2015
Oracle Intel Solaris 10, 11 gcc 4.6 and higher, including 5.x
Oracle SPARC Solaris 10, 11 gcc 4.6 and higher, including 5.x; 64 bit also supports Oracle Studio 12.4

Datalogics distributes Adobe PDF Library with International Components for Unicode (ICU) v4.0. Depending on your application and system configuration, it may be easier for you to use your own ICU build.

Evaluating a free version of the Adobe PDF Library

If you would like to test a free trial version of the Adobe PDF Library fill out an application on the Datalogics web site.

Note: To evaluate an Apple Mac version of the Adobe PDF Library, or to evaluate any version of the product on a machine without access to the Internet, please contact your Datalogics Support representative.

For Windows or Linux, we will send you an email in response, including a hyperlink to download an evaluation copy of the system and a 16-digit license key number.

In the command shell, run Activate.exe (or Activate for Linux) from the root directory. When you are prompted, enter the key that was included in your email message. The program generates a license file called apdfl15.lic. This license file is initially set to expire in three days, is limited to the machine on which it is activated. You will be contacted by a Datalogics sales representative who can extend your evaluation license as needed for your proof of concept. The evaluation license file must be present at run time.

Then, either:

  • Copy the apdfl15.lic file to the current working directory when running your APDFL process, where the application will find it automatically, or
  • Set the datalogics_LICENSE environment variable to point to the file location.

For Windows platforms, especially if you are running multiple APDFL applications on various locations, we recommend that you set a Windows environment variable.

Windows and the apdfl15.lic license file

You will be able to use the APDFL system until the expiration date shown in the license file.  You can open apdfl15.lic in a text editor, such as the Windows notepad, to read the expiration date.  You can move the apdfl15.lic file to a different directory if you like, but you will need to set the license environment variable to point to it.

Open the System Settings dialog in Windows.

At the Advanced tab, click DLE_Eval4

Environment Variables

Click DLE_Eval6 to create a new user variable.

New variable, 1

For the Variable name, use  datalogics_LICENSE.

Enter the license as the name of the variable, in the form of the path for the apdfl15.lic file.  For example, the path and file name for the datalogics_LICENSE value might look like this:

C:\Datalogics\APDFL15.0.4\CPlusPlus\apdfl15.lic

So your User Variable screen would look like this.

New variable, 2

Click OK.

Variable result

Close the screen.

Working with a proxy server

The activation program you use to generate the license file makes use of the proxy server running at your location. For Windows systems, the Activate.exe program will automatically attempt to detect your proxy server.

If the activation program can’t find your local proxy server, you will need to create an environment variable, HTTP_PROXY or http_proxy, to define the hostname and port number for that server.  For example, if your proxy server is running on “myproxyhost” using port 8765, enter this UNIX command:

% setenv HTTP_PROXY myproxyhost:8765

If your proxy server requires authentication, you will need to set up the HTTP_PROXY_CREDENTIALS environment variable to provide these credentials, the user name and password, to the proxy server.

For example, if your user name is “joe” and the password is “password” the command would look like this:

% setenv HTTP_PROXY_CREDENTIALS joe:password

Note that the activation program only uses the BASIC authentication type.