Progress will discontinue Telerik Platform on May 10th, 2018. Learn more

Run Your App in the Native iOS Simulator

Filter by IDE
Select the Progress AppBuilder client you are currently using for development.

IDE

To be able to run your apps in the native iOS Simulator, you need access to a macOS system with Xcode 7 or newer.

The iOS SDK for native iOS development provides the iOS Simulator, a native iOS emulator. In AppBuilder, you can run your hybrid apps in the native iOS Simulator.

To test your app during development, you can build and deploy it in the native device emulator. This way you can test your app on the predefined device configurations without actually deploying the app on a physical device.

When you select to run your app in the native emulator, AppBuilder builds an application package (IPA) and loads it in the emulator on a macOS system. The command-line interface recognizes the iOS Simulator as a connected device.

In this version of AppBuilder, you cannot run Apple Watch bundles in the iOS Simulator.

To apply code changes to your app, you need to re-deploy your app.

Prerequisites

  • Verify that your preferred AppBuilder client is running and you are logged in.
  • Verify that you have opened the code for your app in AppBuilder.

Procedure

In-Browser

This operation is not available in the in-browser client.

Windows

  1. Verify that you have have access to a properly configured macOS system.
    1. Verify that you have installed the command-line interface on the macOS system.
    2. Verify that you have installed Xcode on the macOS system.
      The version of Xcode must be compatible with the version of the ios-sim-portable npm package on which AppBuilder relies.
      For more information, see ios-sim-portable in the NPM Registry.
    3. Verify that the Windows system on which you are running the classic Windows desktop client can reach the macOS system.
  2. Configure a remote server on the macOS system.

    1. (Optional) Check which ports are open on the macOS system. For more information, see OS X Mountain Lion: Check for open TCP ports.
    2. To launch the app on a default device, in the terminal, run the following command.

      appbuilder remote <Port>
      

      <Port> is the port on which the command-line interface listens for requests from the classic Windows desktop client. The port must be above 1023.
      Make sure that the port is open and that your firewall allows traffic on it, if configured.
      Make sure that your Windows system can reach and send traffic to the macOS system on the specified port.

    3. To launch the app on a selected device, in the terminal, run the following commands.

      isim device-types
      appbuilder remote <Port> --device <Device Name>
      

      <Device Name> is the name of the device that you want to use as listed by isim device-types

      <Port> is the port on which the command-line interface listens for requests from the classic Windows desktop client. The port must be above 1023.
      Make sure that the port is open and that your firewall allows traffic on it, if configured.
      Make sure that your Windows system can reach and send traffic to the macOS system on the specified port.

  3. In the classic Windows desktop client, select RunNative Emulator.

  4. Select iOS and click Next.
  5. In the Address text box, provide the address of the macOS system. The address must be in any of the following formats.

    http://192.168.32.22
    http://mymac
    

    You can provide the IP address or the name of the machine.

  6. In the Port text box, provide the port you have configured in Step 2.
  7. Select target device.
  8. Click Launch Emulator and wait for the build to complete.
    If you have set a device in Step 2, AppBuilder disregards your choice from Step 7 and launches your app in the device selected with the appbuilder remote command.

On the macOS system, the command-line interface launches the iOS Simulator and loads your app.

To apply code changes to your app, you need to re-deploy your app. To re-deploy your app, you need to repeat Steps 3-8.

Visual Studio

  1. Verify that you have have access to a properly configured macOS system.
    1. Verify that you have installed the command-line interface on the macOS system.
    2. Verify that you have installed Xcode on the macOS system.
      The version of Xcode must be compatible with the version of the ios-sim-portable npm package on which AppBuilder relies.
      For more information, see ios-sim-portable in the NPM Registry.
    3. Verify that the Windows system on which you are running the classic Windows desktop client can reach the macOS system.
  2. Configure a remote server on the macOS system.

    1. (Optional) Check which ports are open on the macOS system. For more information, see OS X Mountain Lion: Check for open TCP ports.
    2. To launch the app on a default device, in the terminal, run the following command.

      appbuilder remote <Port>
      

      <Port> is the port on which the command-line interface listens for requests from the extension for Visual Studio. The port must be above 1023.
      Make sure that the port is open and that your firewall allows traffic on it, if configured.
      Make sure that your Windows system can reach and send traffic to the macOS system on the specified port.

    3. To launch the app on a selected device, in the terminal, run the following commands.

      isim device-types
      appbuilder remote <Port> --device <Device Name>
      

      <Device Name> is the name of the device that you want to use as listed by isim device-types

      <Port> is the port on which the command-line interface listens for requests from the extension for Visual Studio. The port must be above 1023.
      Make sure that the port is open and that your firewall allows traffic on it, if configured.
      Make sure that your Windows system can reach and send traffic to the macOS system on the specified port.

  3. In the extension for Visual Studio, select AppBuilderRun Native Emulator.

  4. Select iOS and click Next.
  5. In the Address text box, provide the address of the macOS system. The address must be in any of the following formats.

    http://192.168.32.22
    http://mymac
    

    You can provide the IP address or the name of the machine.

  6. In the Port text box, provide the port you have configured in Step 2.
  7. Select target device.
  8. Click Launch Emulator and wait for the build to complete.
    If you have set a device in Step 2, AppBuilder disregards your choice from Step 7 and launches your app in the device selected with the appbuilder remote command.

On the macOS system, the command-line interface launches the iOS Simulator and loads your app.

To apply code changes to your app, you need to re-deploy your app. To re-deploy your app, you need to repeat Steps 3-8.

CLI

This operation is available only on macOS systems. The command-line interface recognizes the iOS Simulator as a connected device.

  1. Verify that you have installed Xcode on the macOS system.
    The version of Xcode must be compatible with the version of the ios-sim-portable npm package on which AppBuilder relies.
    For more information, see ios-sim-portable in the NPM Registry.
  2. To launch your app on the default device, run the following command.

    appbuilder emulate ios
    
    
  3. To launch your app on a selected device, run the following commands.

    appbuilder emulate ios --available-devices
    appbuilder emulate ios --device <Device Name>
    

    <Device Name> is the name of the device that you want to use as listed by appbuilder emulate ios --available-devices

  4. Wait for the iOS Simulator to load.

Your app launches automatically in the emulator.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.