Wrapping Android mobile apps 编辑

This article describes how Citrix Endpoint Management administrators wrap third-party enterprise apps and how developers wrap ISV apps. To wrap Android mobile apps, use the MDX Toolkit, which includes a macOS graphical interface tool and a Java command-line tool. The command-line tool has customization options, can be referenced from scripts that automate the app wrapping process, and lets you preset some MDX policies.

The file type for a wrapped app is .mdx. You upload the .mdx file to the Endpoint Management console where you then configure specific app details and policy settings that the Endpoint Management Store enforces. When users sign on, the app appears in the app store. Users can then subscribe, download, and install the app on their device.

The following figure provides an overview of the app wrapping steps, from installation of the MDX Toolkit through testing mobile productivity apps. Related topics are listed under the diagram.

For details on number one, see:

• System requirements
• Other requirements for wrapping Android mobile apps
• Endpoint Management compatibility
• Installing the MDX Toolkit

For details on number two, see:

• ISV Android app wrapping with the command line
• Enterprise Android app wrapping with the command line
• Command Options
• Presetting MDX policies for Android apps
• Identifying Android app wrapping errors
• Collecting app logs from the command line
• Add an MDX app

Important:

Make sure that your user devices are updated with a version of Secure Hub that is compatible with the version of MDX Toolkit used to wrap apps. Otherwise, users receive an error message about the incompatibility. For details, see Endpoint Management compatibility.

ISV app wrapping with the graphical interface

The following steps describe the general process for wrapping an ISV app that you will deploy from the Google Play Store.

1. Before you use the toolkit to wrap apps, be sure to back up the original version of those apps so you can return to them if needed.

2. Start the MDX Toolkit from your iOS Applications folder, select For Independent Software Vendors (ISVs), and then click Next.

   

3. In the Deploy from App Store screen, select your app and click Next.

4. In the User Settings screen, if you already have the app store URL, enter it. If you don’t have the URL, enter a placeholder such as https://play.google.com/store/apps/details?id=com.citrix. You can update the URL later.

   For Premium apps, select MDX apps. For General apps, select App Store apps.

   

5. In the Verify App Details screen, update the details as needed.

6. Browse to your keystore and click Create.

   

7. Save your app.

   

   When the GUI tool finishes wrapping an app, the app file name includes _andr.

Enterprise Android app wrapping with the command line

You can use enterprise app wrapping to wrap custom (in-house) apps and some third-party apps. You should acquire third-party apps directly from the app vendor. For enterprise app wrapping, begin with an Android application (.apk). Before you use the toolkit to wrap apps, back up the original version of those apps so you can return to them if needed.

The following example shows a basic app wrapping command using default settings. The app is signed with the provided keystore. A keystore is a file that contains certificates used to sign your Android app. If the keystore contains multiple private keys, you can specify the key alias. You create a keystore one time. Then, you can use the keystore to sign the apps that you wrap. If you do not use the same keystore to wrap the new version of an app you previously deployed, upgrades of that app will not work. Users will need to manually remove the old version before they can install the new one.

Modify the bold information for your specific system. The trailing backslash signifies that the command continues to the next line. Please remove these symbols before running the command.

Note:

Because the /Applications/ directory is restricted, you may need to run the following command in super user mode. To do this, add sudo in front of the command. You will be prompted for your computer password when running from this restricted directory.

java -jar /Applications/Citrix/MDXToolkit/ManagedAppUtility.jar \
wrap \
-in ~/Desktop/SampleApps/Sample.apk \
-out ~/Desktop/SampleApps/Sample.mdx \
-keystore ~/Desktop/MyCompany.keystore \
-storepass MyKeystorePassword \
-keyalias MyCompanyKeyAlias \
-keypass MyKeyAliasPassword
<!--NeedCopy-->