Using iOS Simulators
The iOS simulator is distributed by Apple as part of Apple’s Developer Suite, which can be downloaded from Apple’s website. To download the development kit, you must be registered as an Apple Developer. The sections below outline the registration process, as well as additional information on how to install applications and run the simulator. The iOS SDK/simulator is only available for Apple Mac OS-based computers. Therefore, an Apple computer or VM is required for a successful installation.
This section describes how to install, configure, and use iOS simulators to run a AppStudio app in the following topics:
Registering for an Apple Developer Account
To register for an Apple Developer Account, visit the following link: http://developer.apple.com/programs/register/ and click on the ‘Get Started’ button to initiate the registration process.
An Apple ID is required as part of the registration process. You can choose to create a new Apple ID or use an existing. Creating a new Apple ID will allow the user to define their personal and professional profiles.
**Note from Apple: If you intend to enroll in a paid Developer Program for business purposes, you may prefer to create a new Apple ID that is dedicated to your business transactions and used for accounting purposes with Apple. If your Apple ID is associated with an existing iTunes Connect account, please create a new Apple ID to avoid accounting and reporting issues.
Downloading and Installing the SDK
Once registered, you will be prompted with the Apple Developer Dashboard or main website. Click on the “iOS Dev Center” link to download the SDK. Alternatively, you can go directly to this URL: http://developer.apple.com/devcenter/ios/. Follow the instructions to download the most current version of XCode available from the Mac App Store.
Using the iOS Simulator
The iOS simulator is located deep within the Xcode/SDK installation. To locate it, go to: HD > Developer > Platforms > iPhone Simulator Platform > Developer > Applications. Create an alias referencing it or drop it on the Dock to provide easy access.
The iOS simulator offers developers a real device feel to test developed applications. Utilizing the cursor simulate touch actions, as well as holding down the mouse button simulates hold down a touch action on a real device.
The Hardware menu provides additional gestures and rotation capabilities. In addition, the OS version and hardware (iPad vs iPhone) can be selected within this menu.
Installing the AppStudio client on an iOS simulator
To load applications to the iOS simulator, just place the unpackaged application in the Applications folder under User > Library > Application Support > iPhone Simulator > 5.0 (or the iOS version you plan to use) > Applications. The unpackaged application folder has the following components:
- The .app file for the application.
The following figure shows the installed client app:
You can get a generic iPad or iPhone client application to test your installation from the AppStudio platform ZIP file on the download page. Expand the ZIP file:
The files are stored in the Client Files\7.3.x directory:
These client application are for use only on an iOS simulator. They are not for use on an actual device. Contact Appery if you need a client application for a device.
Run an app in the iOS simulator
This section describes how to start an app in an iOS simulator.
To run the app in the iOS simulator:
- On the system hosting the AppServer, use the Windows ipconfig command to determine the system’s ip address.
- Start the iOS simulator on a Mac.
- At the top of your Mac display, you should see a menu line that includes the items “iOS simulator...File....Edit...Hardware...Window...Help”
- Click Hardware > Device.
- Choose the device with which you want to work, e.g. iPhone or iPad.
- Click the device menu button.
- Click the Settings app.
- Click GSClient (the AppStudio app).
- Set the Server URL to the ipaddressOfAppServer/AppStudioApps/mp, for example
- Set the app ID. Ensure it is set to the eleVate app ID shown in AppStudio. It should be 1001.
- Click the menu button to return to the main display.
- Click GSClient. The login screen appears below:
- Login as an app user.
Reloading the app configuration on an iOS simulator
After you make a change to an app in AppStudio and save it, you must exit and restart the app. you must reload the configuration on the client app before you can see the changes in the simulator.
Managing app data on an iOS simulator
On of the easiest way to manage app data on an iOS simulator is to add an About menu item to the startup screen. If the user selects the About menu item from the startup screen, they can then clear the data cache, clear data records, and reload the app configuration. For more information on adding an About menu item, see Working with Menus.