This documentation is for WSO2 IoT Server 3.0.0. View the documentation for the latest release.
Due to a known issue do not use JDK1.8.0_151 with WSO2 products. Use JDK 1.8.0_144 until JDK 1.8.0_162-ea is released.
iOS Client Configurations - IoT Server 3.0.0 - WSO2 Documentation
Skip to end of metadata
Go to start of metadata


Follow the instructions below to configure and build the iOS client application:

  1. Compile the Agent source code, which was sent via email by importing it to Xcode.

    The link to the agent source repository was sent to you via email when obtaining the signed CSR file. You need to clone the repository and then compile the agent source code. For more information, see Obtaining the iOS Features and CSR File.

  2. Export the project as an iOS application. This will generate an.ipa file. Rename this file as ios-agent.ipa and move it to the <IoTS_HOME>/core/repository/deployment/server/jaggeryapps/ios-web-agent/app/pages/ directory.

    • Carry out this step to Beta test your iOS apps using the iOS ad-hoc distribution, which generates an ad hoc IPA file. In order to Beta test the apps you have to be enrolled in the Apple Developer Program as an individual or organization.
    • The generated IPA file can be distributed as follows:
  3. Optionally, update the iOS server configurations in the config.json file, which is in the <IoT_HOME>/core/repository/deployment/server/jaggeryapps/ios-web-agent/app/conf directory.

    • Add the.ipa file path as the iOS location.

    • Add the package name as the iOS bundle ID.
    • Add the version of the package.
    • Add the app name.

    Use the bundleid and version defined here when building the product.

      "device": {
        "ios": {
          "location": "%https.ip%/mdm/public/asset-download-agent/iOSMDMAgent.ipa",
          "bundleid": "org.wso2.carbon.emm.iOSMDMAgent",
          "version": "1.0",
          "appname": "MDM Agent"

What's next?

Next, configure the iOS Platform Configurations as mentioned in the iOS configurations guide.

Related Links

  • No labels