Developing iOS apps 编辑

You can use the MDX API to enable your mobile apps for Citrix Endpoint Management. This article describes how to integrate the MDX App SDK into your app library and the steps required to test, certify, and publish your apps.

How to use the MDX App SDK

Here are some examples of how you might use the APIs.

• Place restrictions on apps

  You can control when your app allows access to certain features or actions based on whether API calls indicate that the app is managed or wrapped. For example, if an app isn’t managed or wrapped, you might allow a user access to all features and actions. If an app is wrapped but not managed, you might then restrict certain features or actions. If an app is wrapped and managed, you might put extra restrictions on the app.

• Perform actions based on Citrix Endpoint Management policy settings

  Suppose that you want to display a notification to users if a Citrix Endpoint Management administrator sets the Require Wi-Fi policy to On. That means that the app is allowed to run only from inside the network of your organization. You can use the API to look up the policy setting and then base your code changes on the policy value.

• Perform actions based on custom policies

  You can use the APIs to read custom policies in your apps. For example, suppose that you want to enable Citrix Endpoint Management administrators to display a notification in the app. To do that, create a custom policy that is empty or contains a system message that is supplied by an administrator in the Citrix Endpoint Management console. If your app is managed, it can detect when the Citrix Endpoint Management administrator changes the policy value. If the policy value contains a message, your app displays the notification.

For API definitions, see API for iOS.

Integrating the SDK into your app library

To add the MDX App SDK to your iOS apps, link the SDK framework into your app as described in this section. The MDX App SDK for iOS, based on Objective-C, is a collection of header files and a static library.

1. If you haven’t already installed the latest MDX Toolkit, do so now.

   1. Log on to the Citrix Endpoint Management downloads page.

   2. Expand XenMobile Apps and MDX Toolkit.

   3. Locate the MDX Toolkit version you want to install and click the link to begin the download.

   4. Open MDXToolkit.mpkg with the macOS Finder tool on macOS 10.9.4 or later and Xcode 7 or later.

      For Xcode 8 and above, a known issue exists where the project file must be cleaned before pushing the app to the device.

      The installation path is Applications/Citrix/MDXToolkit.

      

   The MDX App SDK files are in Applications/Citrix/MDXToolkit/data/MDXSDK.

   After installing the MDX Toolkit on your computer, integrate MDX Framework into your Xcode project.

2. Add the data/MDXSDK folder to the Apple Xcode project. To do so, you can drag that folder to the Xcode project.

3. Revise a line of code in the pre-compiled header file in the app project to import MDX.h from MDX.framework as shown in the following example.

       #ifdef__OBJC__
       _
       //import MDX extensions
       #import <AVFoundation/AVFoundation.h>
       #import <SystemConfiguration/SCNetworkReachability.h>
       #import <MDX/MDX.h>
       #endif