Installing and Configuring the Citrix MDX Toolkit Build 2.2.1 v372 and Wrapping Apps

After installing and configuring the App Controller 2.9 it is time to start with application wrapping. With application wrapping you sign the application and convert/save it to an MDX file. You can upload both APK (Android) and IPA (iOS) as MDX files to the XenMobile App Controller, but with MDX files you have the additional ability to configure policies and to run the application in a sandbox.

You can wrap the applications with the Citrix MDX Toolkit . Keep in mind that this MDX Toolkit only runs on Mac OS X Lion or higher and not on a Windows machine.

In this blog I will show you how to prepare and how to wrap applications with the MDX Toolkit.

Preperations

General;

• Download Java SE Development Kit 7 for Mac OS X64
• Download the Citrix MDX Toolkit & SDK for iOS and Android Build 2.2.1 v372

For Android;

• Download the Android Software Development Kit (SDK)
• Download the Android APK Tool for Mac OSX, you need the apktool-install-macosx-r05-ibot.tar.bz2 and the apktool1.5.2.tar.bz2 files.

For iOS;

• Download your iOS Distribution Provisioning Profile
• Download Command Line Tools for Xcode

Installing Java SE Development Kit 7 for Mac OS

Double click the jdk-7u51-macosx-x64.dmg file

Double click on JDK 7 Update 51.pkg

Click on Continue

Click on Install

Click on Close

Installing the Android SDK Platform Tools

Go to the downloaded Android Software Development Kit and browse to adt-bundle-mac-x86_64-20131030 > sdk > tools and double click the android application

Click on Open

Make sure you select the following Tools;

 – Android SDK Tools Rev. 22.3
– Android SDK Platform-tools Rev. 19
– Android SDK Built-tools Rev. 18.0.1
– Android SDK Built-tools Rev. 17

Click on Install <x> packages.

On the left side select Android SDK License, on the right side select Accept License and click Install.

After the installation close the dialog boxes (3).

Installing the Android APK Tool

Double click the apktool-install-macosx-r05-ibot.tar.bz2 and the apktool1.5.2.tar.bz2 file to uncompressed the files.

Copy the following files to adt-bundle-mac-x86_64-20131030 > sdk > tools ;

–          Apktool-install-macosx-r05-ibot > aapt
–          Apktool-install-macosx-r05-ibot > apktool
–          Apktool1.5.2 > apktool.jar

To add the folders to the path variable, open Terminal and type the following command;

~/.bash_profile; open ~/.bash_profile

Add the following lines to the file;

Export PATH=”$HOME/Downloads/adt-bundle-mac-x86_64-20131030/sdk/platform-tools:$PATH”
Export PATH=”$HOME/Downloads/adt-bundle-mac-x86_64-20131030/sdk/build-tools:$PATH”
Export PATH=”$HOME/Downloads/adt-bundle-mac-x86_64-20131030/sdk/tools:$PATH”

Click File > Save a Version, and close the dialog box

To create the keystore key run the following command;

Keytool –genkey –keyalg DSA –alias <keystorename>.keystore –storepass <any-password> -keysize 1024

 NOTE: The key must have a 1024 bit keysize and a DSA key algorithm

Enter your first and last name

Enter the name of your organizational unit

Enter the name of your organization

Enter the name of your City or Locality

Enter the name of your State or Province

Enter the two-letter country code for this unit

If everything is correct, type Yes

Enter a key password

Run the following command to copy the keystore file to the downloads folder;

cp .keystore Downloads/<keystorename>.keystore

Install the Command Line Tools for Xcode

Double click the xcode462_cltools_10_76938260a.dmg file

Double click Command Line Tools (Lion).mpkg

Click Continue

Click Continue

Click Agree

Click Install

Click Close

Install the Citrix MDX Toolkit

Double click the MDXToolkit.mpkg file

Click Continue

Click Continue

Click Agree

Click Install

Click Close

Wrapping an application

For this example I will wrap WorxMail for Android. The steps to wrap an iOS application are almost the same. The only difference is that you must select an IPA file instead of an APK file and that you have to specify a iOS Distribution Provisioning Profile and iOS Distribution Certificate instead of the Android SDK and the Keystore.

Start the MDX Toolkit

Select For IT administrator and click Next

Browse to the APK file and click Next

You have to provide the path to the top-level of the Android SDK the first time you wrap an Android application. Click Browse

Select the adt-bundle-mac-x86_64-20131030 > sdk folder and click Open

Click Next

Click Next

Browse to the keystore file created in the previous steps and click Next

Enter the password you entered while creating the key and click Next

Click Create

Enter the alias password you entered while creating the key and click Create

Give the MDX file a name you want and click Create

Click Finish