Step by step guide: How to submit publish your flex .ipa iphone iPad iPod iOs app to iTunes

Apple makes it difficult :). First I have to say that most of the submission steps can be performed within a browser but uploading your app will require you to have a Mac. Well that’s why I say that they make it difficult. If you are a pro then you may look at hackintosh if you don’t have Mac, but using hackintosh is out of context of this article.

This article applies to compiled ipa file, source can be anything such as Flex or XCode.

I will assume that you app is ready for submission i.e. your IPA File is distribution ready and you have tested your app thoroughly. I’ve prepared a checklist for Apple app submission as well. If you are interested you can read it

Just a little bit of insight on what’s required if you are just reading this for curiosity sake.

First up you will need an Apple iOS developer Account. You will need to spend $99/year to get that account. This account lets you use their provisioning portal for creating your app testing provisioning profile and distribution profile. It also lets you use iTunes Connect which is essential in maintaining your application. You can also check lots of resources that are only available to registered Apple developers such as Forums, latest iOS SDK etc. Again we are not going to discuss how to use your provisioning portal here that’s a separate topic.

I assume that you are now logged into your Apple Developer Center. Home screen should look like this [as of writing]




Click on iTunes connect. It will throw a login screen, just use your Developer login details to login to your iTunes connect portal. Once you are in your home screen will look like this.

In the picture above we are only interested in “Manage your Applications” part. Click on that link. you will get the screen below. On this screen we are interested in button labelled “Add new App” as shown below


Here you got three field. Please note that chose your App name carefully. The value entered here should be taken from App name in your descriptor file. You can put anything in SKU number. This is your reference to the internal database that you may maintain for all the Apps that you release.

Bundle ID will automatically appear in the drop down. You should have created a App ID from your provisioning portal and for that App ID your would have created a distribution profile against which you would have signed your App. If you have not done that and your IPA file is not ready for distribution this article will serve you no purpose I suppose. If you have compiled your App to an ipa file then fill up the values above and click Continue button. Once you click Continue button you will see the Screen below

On this window you tell apple couple of things.

  1. Availability date. [This is important if you got a publication or press release coming up and you would like to publish your App on a specific date. FYI: Apple can take many weeks to Approve your App. So be careful choosing this date]
  2. Price tier: What price your App will be available for. I am listing my App for Free so I’ve selected Free from the Drop down. Tier 85 is the maximum you can set for you App. Please choose this carefully. If your App only changes background color of your iPhone then Free is a better option :). You can Check “Discount for Educational Institutions” box if you want this app to be offered at a discount to educational institutions when they purchase multiple copies at once.

On this window you can also select what stores you would like to make this App available in. By default your App will be available in every country.

Click Continue button once you are done with above screen. You will get the screen below. I guess this is the most important screen in the whole submission process.

The most important things on this screen.

  1. Version number: Your App version number must be greater or equals 1.0. Apple do no accept beta versions. There are strong chance of rejection if your App version is say 0.01 or o.8 etc
  2. Choose the App category carefully.
  3. Put any information such as Logins etc under “Review Notes” so that Apple can try out your App without any hiccups.
  4. Upload 512×512 icon for your App
  5. Upload atleast 2 screenshots for iPhone and iPad touch and if your App is iPad only then atleast 2 screenshots of your app under iPad screenshot section. Click on little question mark to the right of the title to know what dimensions are acceptable.


Once you are done with above click “Save” button. Don’t worry Apple will not start reviewing your App at this moment because there is no binary uploaded for your App. Once you save your submission process, you will get this screen. This is the tricky part here.

On this screen click on View Details button just below your App Icon. You will get this

When you Click on “Ready to upload” button you will this screen. Click Continue.

Now if you were doing all of the above from windows machine its time to make a switch to a Mac machine because we are going to use Application Loader application in Mac.

If you don’t have Application Loader install then download it.

You should be able to search Application loader from Application browser as shown below.

Please read more about Application loader from the link below

Once you have that installed launch it and sign up with your iTunes Connect Account ID.

You will see the screen below

As you see that you App ID will automatically appear in the drop down menu. Select it and click next you’ll see screen below that shows the Application information.

Now choose your ipa file by clicking on the choose button. Locate your ipa file within the File explorer.

You will be cautioned that you are going to all an application as shown below

Click Send and wait. Do not close your window until your app gets uploaded. It can take a while so be patient.

once everything is finished uploading you will get this screen

and thats it. Your application status will now change to “Under review” and you should get an email confirming that.

Its Time to pray now 🙂 wait in between 5days to few weeks to hear back from Apple

I hope this helps


  1. Kaliyarajalu says

    Thank you very much. Keep to post like this… Thanks for your helping sense

  2. Nazim Beltran says

    Would anyone know why my new Bundle IDS are not showing up in Itunes Connect when I try to add my App?. Have already sent Apple an inquiry into this. I had set up my App submittal but incurred in the dreaded Bundle ID mismatch message. The problem is that I decided to delete the App application via Itunes Connect and start from scratch but the old mismatch BundleID is the only one that shows up in the drop down. Now it seems that since I deleted the App I cannot reuse the app name originally inserted (apart from doing the resubmittal with UK English option). Also requested Apple to see if they could recover my deleted App submittal (which was still pending approval) but if the Bundle IDs are mismatched I assume that you cannot change it in Itunes Connect..

  3. Last question, When I open up View Details page, then Right Side “Ready to Upload Binary” is not visible. Why? Please help me out of this. I am getting fed up with this.

  4. Thank you very much.

  5. Hello jaspreet,
    Is there any compulsary to use xcode to upload binary to appstore through MAC? or only applicationloader will be enough. I am flex-flash builder4.5.1 user. Please I request to help me to out of this.
    Thanx in advance.

  6. Only .IPA file should I have to upload through application loader on MAC? or else i require somethimg more? Please help me.

    I have created my application using flash builder 4.5.1. I am windows user.
    It running in my own iPad. I have created all distribution certificate and distribution provisioning profile. I have created profile in itunes connect also.
    Now, I want to upload binary(.ipa file). What should I have to do now? Doesn’t it possible through windows?

  8. Would you know where I would be uploading the splash screen (default.png)?


    • Your app splash image is local to your app package can can be stored in say “assets/default.png”. In your ViewNavigator element reference it like this

      <s:ViewNavigatorApplication xmlns:fx=""

      splashScreenScaleMode property has other values such as letterbox | stretch | zoom

      I hope that the question you are asking. Sorry for the late reply as I was on holidays.

  9. Dear Jaspreet,
    Thank you very much for a quick reply, I would like to bring to your notice, that we are using adobe air to port our application on IOS (ipad). while uploading the details of our app on itunes, i used 1024 x 1024 size for our app icon (which the itunes asked for)
    As you mentioned above, should we be adding all the possible image sizes too i.e from 16 x 16 to 512 x 512??
    We changed our icon size within ipa file from 50x 50 to 57x 57.. but still the problem persists…
    Looking forward for your comments and suggestions.

  10. Hi Jaspreet,

    Thank you so much for this article, really helpful. I tried exactly the same as you mentioned, but when i use application loader to upload my ipa file, it gets uploaded then when i click send button : it gives me a following message : iPhone/iPod Touch : Icon-Small-50.png : icon dimentions (50×50) don’t meet the size requirements.
    The icon file must be 57×57 pixels, in. Png format. Can you please help us on this at your earliest

    Please Note : I am uploading the ipa file for IPAD Application, so i did not upload any screenshot for iphone/ipod

    • Hi Vikram
      Make sure that your icons are right size in pixels and are referenced in right element. This is very important. image57x57 cannot carry 50×50 pixel icon reference.
      I hope that your config file does have required dimension icons.
      For a record I would always include these

      to be on safe side for both iPhone and iPad apps.

      Read a helpful article here

  11. Great instructions Jaspreet. Thank you!

  12. Great post jespereet, Will let you know how it goes when I post my app

    Thank you

  13. Hello. Thank you for your post. Your tutorial has gotten me closer than anyone else… After I have selected the .ipa and click send, I get the following error

    Application failed codesign verification. The signature was invalid, or it was not signed with an iPhone Distribution Certificate.

    Any ideas would be grateful. Thanking you in advance

    • You will have to build your App with “Distribution Provisioning Profile” and “Distribution Certificate”
      Under your provision portal you will find these under left hand menu titled “Provisioning” and “Certificates”
      So from Certificates > Distribution download you already issued certificate if applicable or Click on How-to tab to see how to create one.
      And from Provisioning > Distribution download the “distribution profile” file or Create a new iOS Distribution Provisioning Profile against your above created Distribution certificate.

      After you have both the Items, build and sign your App with these and you should be fine. I hope it helps.

  14. This is really helpful, thank you. I’m wondering once you have an established app in your developer account, do you just overwrite the ipa file with each new release? How long does it usually take to propagate a new version release through the submission system?

    • Well it all depends how busy apple guys are. Your new version release should show up in iTunes within 5 days but this varies. It goes like this. When you submit an App to Apple its queued for approval exactly same thing applies to your new version i.e. it get queued for approval. You always submit an App with a new version number (such as 1.1,1.2 etc), so your ipa file name can stay the same.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.