Product Documentation

Adding Android Apps

Jan 31, 2011

You can add apps and files to Device Manager that you want to deploy to Android devices. You can add proprietary apps you have developed internally for your users and then deploy those apps to the Worx Store in a deployment package. You can also add app definitions of publicly available apps, so your users can access them from GooglePlay and install them on their devices.

You can make Android apps available through Worx Home in the Applications folder.

You can add Android apps in two ways:
  • Internally. Upload the application to the Device Manager database as an Android .apk file
  • Externally. Create an application definition that references the App data through a URL to the Google Play or Amazon app store.

To add an internal Android app

If you have internally developed Android apps (.apk) or Android apps that you are licensed to distribute, you can upload the apps directly to the Device Manager database and then deploy the apps.

  1. In the Device Manager web console, select the Applications tab.
  2. Click New > New app.
  3. In the Import an application into the XenMobile MDM database dialog box, click Choose File.
  4. Select the file and click Open.
  5. In the APK parameters section, enter the following information:
    1. Select the Execute APK File option if you want the app to launch immediately after is it installed on the device.
    2. Select After Installation if you want to prevent deleting the installation file from the device when the installation is done.
    3. In the Destination folder section, select the folder where you want to upload the installation file. Only Flash Storage and Device Manager Installation folders are available as a path prefix for Android devices.
    4. In the If the file already exists section, you can specify what to do if the file already exists. You can copy it if the files are different or do not overwrite the existing one.
  6. When you are finished, click Import. Once imported, the app can be added to deployment packages and pushed to Android devices.

To add an external Android app

For Android apps that you want to require users to have or want to recommend to Android users, you can define an Android app definition and then push the app to users' devices. When users open Worx Home on their device and tap the Applications folder, they can download the app to their devices. In order to add an external Android app to Device Manager, you will need the complete URL to the app from the Google Play or Amazon app store.

  1. In the Device Manager web console, select the Applications tab.
  2. On the New menu, select New > External APK App.
  3. In the Add an external Android application dialog box, enter the following information:
    1. In Application store, select either Google Play or Amazon and then specify the URL with a link to the app store.
    2. Click Go to validate the URL link and retrieve application information.
  4. If the app URL is not recognized, you can click the Credentials button to authenticate with the Google Play store so the managed devices will be recognized and you can add external Android apps to Device Manager. You need the device ID from an Android phone that is managed by Device Manager.
    1. To obtain an Android device ID from a managed Android phone, type *#*#8255#*#* on the Android device phone number pad.
    2. In the Add an external Android application dialog box, click Credentials.
    3. In the Android Market Access Credentials dialog box, enter your Google user name and password. This can be the account ID from any valid Google account.
    4. Enter the Android phone device ID you obtained in step a.
    5. Select the Save in database option to store the authentication with Device Manager.
    6. Click Save.
  5. Click Add. The external Android app definition is added to Device Manager. You can add as many apps or app definitions as you want to push to users' devices. These apps can be pushed to users' devices when you add them to a deployment package

Citrix Worx Store for Android Apps (MDM Edition Only)

You can provide users a list of recommended or required apps on their Android devices. You can add external (free or for cost) apps hosted on Google Play or Amazon Application Store, as well as internal, in-house apps that your team has developed. All apps appear inside the Citrix Worx Store for Android apps on users' Android devices.

Populating the Enterprise Application Store for Android requires performing the following tasks:

  • Add the custom or external apps from the Android Google Play or Amazon app store to Device Manager.
  • Create and push a deployment package containing the apps to the device.
  • Brand the Citrix Worx Store with your company logo or image (optional).

Users view the apps you deploy on their Android devices by opening the Connect app and then tapping the Apps icon.

To add Android apps to Device Manager

To add external apps to Device Manager, you will need the app Web addresses. For example, you can distribute the following apps to your users:

  • Nitrodesk TouchDown For Smartphones (if you have a phone). https://play.google.com/store/apps/details?id=com.nitrodesk.droid20.nitroid&hl=en
  • Nitrodesk TouchDown HD for Tablets (if you have an Android tablet). https://play.google.com/store/apps/details?id=com.nitrodesk.honey.nitroid&hl=en
  • Project Viewer. https://play.google.com/store/apps/details?id=cintelic.project.pro&hl=en

To add internal Android apps, you only need to upload Android app files with the .apk extension.

  1. In Device Manager, select the Files tab, click New and then click External APK App.
  2. Click Credentials to add your Google Play Market access credentials. Device Manager uses the credentials to access the proper version of the app you will distribute to your employees.
  3. Click Save.
  4. In the Add an external APK application dialog box, in URL, enter the app Web address and then click Go button to find the app data.
  5. Click Add.
  6. Repeat Steps 1 through 5 for the other apps. The apps appear on the Files tab in Device Manager.
  7. To upload internal apps to Device Manager, click New and then select New App or File.
  8. In the Import a file to the Device Manager database dialog box, click Choose File and then browse to select the Android app file (.apk) to import.
  9. Select from the following options:
    • Execute APK file. Select this option to execute the installation automatically when the file transfer is done.
    • After installation. Select this option to avoid deleting the installation file from the device when the installation is done.
    • Destination folder. Write down the folder where the file should be uploaded. Only Flash Storage and Device Manager Installation folder are available as path prefix for Android devices.
    • If the file already exists. Copy it if the files are different or do not overwrite the existing one. You can also decide to register a comment if needed.
  10. Click Import.

To brand the Worx Store for Android

You can change the defaul image used for the Worx store, for example if you want to provide a corporate image or branded logo. You brand the Worx store by creating a branding policy in which you upload your desired image, and then deploy that policy to your users' devices.

Note: Before you begin, make sure you have your custom image ready and accessible.

Follow these image sizing guidelines to ensure best usability across devices:

  • For retina displays, the suggested logo size is 218x36 pixels.
  • For regular displays, the suggested logo size is 109x18 pixels.
  1. From inside the Device Manager web console, select the Policies tab.
  2. From the left side of the console, under MDM Policies, select Branding.
  3. Click New Policy.
  4. In the Enterprise App Stor Branding dialog box, enter a name for the policy.
  5. Next, click Choose File to select an image to use for the branding.
  6. Click Create.
  7. Now, to deploy this package to your users' Android devices, you need to create a deployment package and deploy it to your user's devices. For more information, see To create and deploy a deployment package.

To create a deployment package for Android apps

  1. Select the Deployment tab, click New Package and then click New Android Package.
  2. In the Create New Package wizard, in the Package Name window, enter a name for the package, such as Android App Store, and then click Next.
  3. On the Groups of users window, select the group you created earlier and then click Next.
  4. On the Resources to be deployed window, under Available Resources, scroll to the Enterprise App Store - , select the check boxes for the two external and two internal apps you want to add, click the right arrow button and then click Next.
  5. On the Deployment schedule window, select the If not deployed Start Now option and then click Next.
  6. On the Deployment rules page, click Next.
  7. On the Package summary page, click Finish.
  8. In the packages list, click Deploy.