How to Run your Sencha Touch App on iOS Simulator .

Problem Statement :

In this article we will discuss how to test the Sencha Touch application in IOS Simulator.

Pre-Requisites :

  • Sencha Touch SDK 2.2.1
  • Sencha CMD 3.1
  • Sencha Touch knowledge
  • Sencha Cmd Knowledge
  • Working Sencha Touch application

Details :

We will discuss how to run the application in IOS Simulator  and the Device in  step by step.

In this article am taking our Voodoo Music App as an example. i.e working Sencha Touch application

Step 1:  Install Sencha Cmd and create Sencha Touch Project

If your project is not created with the sencha Cmd then

Install Sencha Cmd and create Sencha Touch project

Step 2 : Build your Application

Build the application using sencha app build  Command, and move all the required images and build output files to single folder.

For More Information refer : Create, Build & Package Sencha Touch project using Sencha Cmd

Step 3: Install IOS Simuator

Download and install Ios Simulator in Mac

Step 4 : Create App Identifier in Ios Provisioning Portal

  • Log in to the iOS Development Center at

  • Enter Provisioning Portal
    Click on Certificates,Identifiers and Portals on the right side of the page under iOS Developer ProgramScreen Shot 2013-06-17 at 1.25.37 PM
  • Click on Identifierss on the left side of the pageScreen Shot 2013-06-17 at 2.40.27 PM
  • Click on + button to add new app Id on the top of the page
    Screen Shot 2013-06-17 at 2.42.51 PM
    Which will Open a Register iOS App ID Form. Fill the form
    App ID Description with the app name which you want to show in the device home screen, And click on continue to register.
    In My case i have entered App ID as Voodoo Music.
    You can see the created App Id in  the App ID’s Under the Identified Group on the left side of the page.confirmappidScreen Shot 2013-06-17 at 2.47.50 PM

Step 5: Create a Development Certificate

  • Expand certificates in the Certificates, Identifiers & Profiles portal and select All.
    click on button to create a certificateScreen Shot 2013-06-17 at 4.09.06 PM
  • First tab is Select Type. Here select the certificate type as iOS Development
    Screen Shot 2013-05-04 at 2.34.52 PM
  • Generate a Certificate Signing Request (CSR) with a public key, Follow the Instructions on the Second Tab
  • Generate Certificate through submitting the CSR file
    Screen Shot 2013-05-04 at 2.38.22 PM
  • Download the Certificate from the last tab, And install it in your machine by double click on the file. The installed certificate will be shown in the key chain accessScreen Shot 2013-06-17 at 4.55.45 PM

Step 6: Create Provision profile for you App

  • Expand Provisioning Profiles under Certificates, Identifiers & Profiles  portal
    Screen Shot 2013-06-17 at 4.41.45 PM
  • Click on + Button Available on the top , in  iOS Provisioning Profiles (Development)
  • Select the Provision Profile type as iOS Development
    Screen Shot 2013-06-17 at 4.45.05 PM
  • Select the AppID for this Provision . Select the recently create App ID
    Screen Shot 2013-06-17 at 4.45.24 PM
  • Select the certificates you wish to include in the provisionScreen Shot 2013-06-17 at 4.46.31 PM
  • Select the Devices you wish to include in this provision. I.e on which devices you want to install the app build with this Provision Profile.(This step is optional to run the app in simulator)
    Screen Shot 2013-06-17 at 4.47.22 PM
  • Name this profile and GenerateScreen Shot 2013-06-17 at 4.47.43 PM
  • Download the Provision Profile
    Screen Shot 2013-06-17 at 4.48.05 PM
    Download the provision profile and remember the path of the file. Extension of the file will be.mobileprovision.

Step 7: Create packaging Configuration Template File

Open Terminal

cd to the project root folder.

issue the following command to generate the template for native build configuration file

$ sencha app package generate 
This will generate iospackager.json file in project root directory .

Step 8: Update the configuration file with your details

open the iospackager.json in your favorite editor. Fill the valid configurations with the valid values


Name of the application to be displayed on the app,And it should match the Name of your app Id generated in the provisioning Portal. in my case Voodoo Music
Screen Shot 2013-06-17 at 5.03.31 PM


This is the name namespace for your application, This should match with the ID of the appId generated in the provisioning Portal

Screen Shot 2013-06-17 at 5.03.12 PM


A ten character string which should match exactly with the prefix of the AppId generated in Provision Portal

Screen Shot 2013-06-17 at 5.03.22 PM


This is the version of your application, initially it will  be 1.0






Note : paths of the icons should be relative to the config file


This is location of your Sencha Touch 2 application, relative to this configuration file, in my case ./build/VoodooMusic/production


 This is where the built application file with be saved. Make sure that output path is not in your input path, you may get into endless recursive copying. Provide the absolute path of the output folder


This is configuration for your application. `Debug` should always be used unless you are submitting your app to an online store – in which case `Release` should be specified. For the first time to test the app in Emulator provide Debug.


 This is the platform where we will be running the application . For now it will  iOSSimulator, as we are building the application to run in iOS Simulator


For Mac OS this config is not required.


This can be just a simple matcher.  In our case certificate is installed in key chain access with the name  iPhone Developer: Ajit Kumar (3H556WAT49). I just specified iPhone Developer


The path to the provision profile (APP_NAME.mobileprovision) which you can create and then download from Apple’s provisioning portal

device Type 

This is device type that your application is targeted to run on .

Available Options are

– iPhone
– iPad
– Universal


Indicates the device orientations in which the application can run. Options are:

  • portrait
  • landscapeLeft
  • landscapeRight
  • portraitUpsideDown

Note. If this omitted, default orientations setting is all four orientations.


Step 9: Run your app on iOS Simulator

The final step is to run your app in iOS Simulator.

Sencha Cmd helps  to build the .app file for you application and run in the Active iOS Simulator in your Machine.

Cd to the project root directory, And issue the below command

$ sencha  app package run .json

Path to the Configuration file which is prepared in the earlier steps.

After Issuing this command you can see the app opening in iOS Simulator.
Screen Shot 2013-06-17 at 5.26.40 PM Screen Shot 2013-06-17 at 5.26.32 PM



In this article, I have explained how to run Sencha Touch application in iOS Simulator,I hope by going through this article you are able to test your Sencha touch application in iOS Simulator in your machine’s.

At Walking Tree we practice and recommend Sencha Products like ExtJS and Sencha Touch to build amazing web / touch apps. In case you are looking for training or professional assistance, contact us by visiting our website.


I am an experienced software architect involved in architecture, design, and implementation of full-stack Mobile and Web Application, and have significant experience and expertise in Sencha ExtJS/Touch, Angular, MEAN and Java/J2EE. I love to play with my son when I am not working.

Tagged with: , , , , ,
Posted in Sencha Touch
2 comments on “How to Run your Sencha Touch App on iOS Simulator .
  1. David Alvarez says:

    Step 9: Run your app on Android Emulator ???? Android?

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

We Have Moved Our Blog!

We have moved our blog to our company site. Check out for all latest blogs.

Sencha Select Partner Sencha Training Partner
Xamarin Authorized Partner
Do More. With Sencha.

Recent Publication
%d bloggers like this: