Product Documentation

Wrapping Android Mobile Apps

Dec 03, 2014

Before you wrap an Android mobile app, download and install the following items:

  • Java Development Kit (JDK) Version 1.7
  • Android Software Development Kit (SDK)
  • Android APK Tool

If you do not install the JDK on your computer, when you attempt to wrap an app, you receive a message prompting you to install or enable the JDK.

Note: If you upgrade the MDX Toolkit, ensure you save a copy of the android_settings.txt file to avoid reconfiguring after the upgrade.

To wrap Android mobile apps

  1. In your computer, open Applications > Citrix > MDXToolkit and then click the MDXToolkit icon to open the MDX Toolkit.
  2. On the Deployment page, choose one of the following options and then click Next.
    • For IT administrators. Deploy from XenMobile to upload a .mdx file intended for IT administrators to manage with XenMobile App Edition.
    • For Independent Software Vendors (ISVs). Deploy app from App Store to upload an .apk file intended for inclusion as unmanaged apps in an app store.
  3. If you chose to deploy the app from the app store, on the Deploy from App Store page, browse to a file on your computer depending on the following conditions and then click Next.
    • Browse to an .apk file if you want to deploy the app from Google Play Store.
    • Browse to an .mpx file if you are running the tool to change the app URL in the MDX package metadata.
    If you do not have the JDK and the Android SDK or APK tool installed, you are prompted to install or enable these tools before the next screen appears.
  4. On the User Settings page, under App Transition, choose one of the following options and then click Next.
    • MDX apps to automatically manage apps without notifying users.
    • App Store apps to prompt users before transitioning an unmanaged app to a managed app.
  5. On the Verify Apps Details page, complete the following fields:
    1. In App Name, type a name for the mobile app. This step is required.
    2. (Optional) In Description, type a description.
    3. (Optional) In Minimum OS version, view the minimum operating system version on which the app can run.
      Important: Citrix recommends that you leave the value as it appears in the tool. If you change the value to a lower number, for example, the app may not function correctly.
    4. (Optional) In Maximum OS version, type the maximum operating system version on which you want to allow the app to run.
    5. (Optional) In Excluded devices, type the devices on which you do not want to allow the app to run. For Android devices, enter the manufacturer and model name, such as Samsung Galaxy Tab. The tool does not support version numbers for these devices. Separate device names by using a comma, such as Samsung Galaxy Tab, Motorola HTC.
  6. Click Next.
  7. On the Keystore selection page, do one of the following:
    • Select Use debug keystore and then click Create.
    • In Location, click Browse and then navigate to the keystore file on your computer.
  8. On the Key alias selection page, in Alias, select the key and then click Create.
  9. In Key password, enter the password for the keystore and then click Create.
  10. In Save MDX, enter the name of the mobile app and in Where, select the location on your computer to save the wrapped app.

    The MDX Toolkit appends the name of the app automatically with _andr. Citrix recommends that you leave this designation for the app.

  11. Click Create and then click Finish when the app is wrapped successfully. A status bar appears that shows the tool is signing the app. The MDX Toolkit generates the wrapped MDX (.mdx) file. You can then upload the file to XenMobile App Edition and configure settings in the App Controller management console.
    Important: If an error appears, you can identify the error by viewing the logs.