Building with RMSDK 10

This page documents the build process for working with the RMSDK 10 64-bit port.

Note:The current release version of Adobe Systems Reader Mobile SDK is RMSDK 11. Adobe Systems and Datalogics no longer distribute RMSDK 10. RMSDK 10 64 bit iOS is no longer supported. We provide the instructions on this page for customers who might still have a need to install a copy of RMSDK 10 using a copy of the installation package that was downloaded previously.

Supported tools and Software

We recommend the Mac OS 10.9.5 or Mac Yosemite (OS 10.10.3) as the minimum version of the Mac operating system for your device.

iOS SDK Version 8.1

RMSDK 11 is built based on iOS 7.1.

DL Reader uses iOS SDK version 8.1.

Normally you would install Xcode 6.1.1 with iOS SDK 8.1. But you can install an earlier version of Xcode if you like, and you can update both the Xcode software and the iOS SDK independently of each other.

iOS SDK 7.1

We tested the product using the older iOS SDK 7.1, installing it within Xcode, Xcode:Preferences:Downloads.

Xcode: 6.1.1 Integrated Development Environment (IDE)

Check to see if the Xcode tool is already installed on your Mac. In the Applications folder open Utilities and Terminal, and type:
xcode-select –p
You should see the developer folder returned:

You can also go to Xcode:Preferences:Locations to see the command line tool option listed.

To install the Xcode command line tool, run
xcode-select --install

Apache Ant

To build RMSDK Book2png you need to install the Apache Ant software build tool (ant.apache.org).

You can use either the full path or set a path environment variable so your terminal session can run the Ant command.

OpenSSL

Download OpenSSL.

Download the tar.gz format. Feel free to upgrade a more recent version when available. When new versions of OpenSSL are available we will mention them in the release notes for updates to RMSDK.

cURL

Download the most recent cURL zip file. Feel free to upgrade a more recent version when available.

Build RMSDK and DL Reader

OpenSSL and cURL

Copy the DLBuildIOSExternals.mak file and the Makefile to the RMSDK root folder.

Unzip cURL and OpenSSL in the RMSDK root directory. Rename the folders that result to "curl" and "openssl" under the RMSDK root directory.

Open a Mac terminal session, and change folder to RMSDK root folder. Run the makefile (DLBuildiOSExternals.mak) from the RMSDK root directory:
make -f DLBuildiOSExternals.mak
To verify that both libraries are built open this directory:
thirdparty/openssl/public
You should see iPhone folders for various architectures, and similarly for curl libraries.

If you see this error:
Error: "We can't compile without socket() support!"
Make sure that you have Xcode commandline tool installed, using the Xcode commandline tool installed, using the "xcode-select --install" command.

Including libadept library

If you are building for projects other than DL Reader, make sure that you include the libadept library in your project to avoid linking errors in adept classes. Look for the libadept.a file in this directory:
RMSDK Root/drm/adept/build/xc3/
Build the folder for various build configurations.

Building iPhone_lpr Sample

Note:The iPhone_lpr sample was only provided with RMSDK versions 9 and 10. It was removed from RMSDK 11.

If you want to give the project a quick build test so far, open the project file:
iphone_lpr.xcodeproj
from the directory
/samples/iphone_lpr/build/xc3
You can build for simulators or devices.

If you get an error that the build can't create folders, in Eclipse open File->Project Settings, and choose Advanced.

Under the Build Location, select "Shared Folder" and type "RMSDK" (use all capitals).

Make sure that you select the device architecture to build for. By default, it may be building for your Mac.

On Simulators, it should open up a book automatically. Tap on the screen will allow the pages to turn. Performance is slow in this sample, give it a couple of seconds to render the next page.

One tap: Turn pages.
Two taps to the right: Zoom in
Two taps to the left: Zoom out
Three taps: Activate with a hard-coded special account for iPhone_lpr.

Building DL Reader

You should have a zip file that contains the DL Reader source code for iOS. Datalogics will send this file to you after you pay for a license for RMSDK. Unzip this file so that the folder it contains is added under the RMSDK Samples folder.

For example:
/Samples/DLReader-3-2
When you create folders, avoid using spaces in either RMSDK folder names or the DL Reader subfolder path names.

Use Xcode to open the DLReader.xcworkspace found in the DL Reader root folder. Follow the instructions for build configurations shown in the ReadMe.MD file found in the DL Reader iOS root folder. Start with building with the Debug build configuration.

Adobe RMSDK and DL Reader