This page documents the build process for working with the RMSDK 10 64-bit port.
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
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.