Enroll to Apple Developers
In order to publish your game to iTunes you’ll need an apple developer account first. Please see below what’s needed.
What you need?
- At least one test device (an Iphone or an Ipad, best is to have both, a phone and a tablet)
- A Mac Computer
- XCode installed on a Mac Computer
- An active membership for iTunes Connect
Choose the membership
There are a few options available for the Apple Developer Membership. If you want to learn more, please see Apple’s Support page.Apple Developer - Membership
Then choose your wished membership and enroll here.Apple Developer - Enroll
Just scroll to the wished membership and click on “Learn about enrollment”. Once you have finished the enrollment and paied the fee, it may take 6-24h till your account goes live. You’ll be notifed by Apple then.
Generate your Certificates
There are two types of certificates available, one for Produktion (uploading your game to the store) and one for Development (in order to test your game without the iTunes Store). In order to create and manage your certificates, please visit your Apple Developer Account by clicking the button below.Apple Developer
Then click on “Certificates, Identifiers & Profiles”
Create a new certificate
Befor you can start uploading your apps to the store, you going to need at least one certificate of each kind. The following guides will show you how to create them. But note, you must perform those steps on your mac computer!
Select the “Development” tab in your certificate overview and click on the “+” symbol in order to add a new certificates.
Then select “iOS App Development” and click on continue.
Then follow the instructions and create the “CSR” file.
After you have created this file, upload it in the next step.
Then the platform will generate your certificate, which you can download afterwards.
This basically works the same. The only diffrent is, that you have to select “App Store and Ad Hoc“.
Identefiers must be created for each app you want to upload to the store. Those identifieres will later connected to your app submission.
Create an Identifier
In order to create an identifier, select the “App ID” tab and click the “+” smybol.
App ID Description
This can be anything. It’s just needed to identify it later. I recommend you to use the app name. My next game is called “Triangle”, so I add this name.
App ID Prefix
This value will be generated automatically.
App ID Suffix
Choose here “Explicit APP ID” and enter your Bundle ID.
The set Bundle ID must match the one you used in your Cocoon.IO iOS settings!
App ID Services
Select the services you want to use with your app and click on Continue.
Then review your information and click on Register.
After that, your new identifier will be added to the list.
In this section you can register your Apple Devices as Test Devices. In order to do so, click the “+” symbol.
Add a new Device
Enter a name to identify your device later and the UDID of the device.
Find out your Device UDID
In order to find out the UDID of your device, connect it to a computer running iTunes. Then click on the serial number till the UDID shows up.
Copy this number and add it in the corresponding field and click on “Continue“.
Provisioning Profiles & p12
Those profiles are needed to sign your application.
Add a Provisioning Profile
Select the “Development” tab in your Provisioning Profiles overview and click on the “+” symbol in order to add a new Provisioning Profile.
Then select “iOS App Development” and click on continue.
Then select your App ID and click on Continue.
Then select your Development Certificate and click Continue.
Then the device(s) you want to use for testing and click on Continue.
Give it a proper name in order to identify it later, then click Continue.
Now you can download it, save it and install it on your Mac or/and upload it to CocoonIO.
This basically works the same. The only diffrent is, that you have to select “App Store” and “Ad Hoc” (yes, add two diffrent PP’s).
Then select your wished APP ID and click on Continue.
Select your Production Certificate and click on Continue.
Then give it a proper name and click on Continue in order to download your PP. Save it, install it and upload it to CocoonIO (if you want to).
You’ll need a certificate for Production and for Development.
Just click on the corresponding tab (Development or Production) and follow the steps to create a certificate for it.
It’s not necessary to add an iOS key to your CocoonIO Account. If you do not select any key, you’ll get a xcode archive file. Open this with XCode and you can export your Game for production / development as well. But if you do add a a key, you will directly get an .ipa file.
In order to get your Provisioning Profile open XCode on your Mac Computer and select Preferences.
Then select your Developer Account and click on View Details.
Then perform a right-mouse click on your certificate and click on Show in Finder.
Hint: Rename it for better identification.
Open the Keychain Access application (in the Applications/Utilities folder) and select your certificate.
If the shown entries are missing, download your certificates from your Apple Developer Account first and then perform a double click on the corresponding certificate. This will add it to the Keychain Access App.
Perform a right mouse click on the corresponding certificate and choose “Export”.
Give it a proper name, so it can be identified later.
Then add a password. This password is the password you have to enter at CocoonIO or Intel XDK.
So now you have added all you need in order to start uploading your first game to iTunes.
In order to upload and manage your games, please visit the Itunes Connect Dashboard and sign in with your Apple ID.iTunes Connect - Dashboard
Once you have logged in, you’ll see following dashboard.
Firstly I want to describe all the shown icons (and sections) above.
Here you will find an overview of your apps. Moreover you can manage existing apps or upload new ones.
Should be self-explaining. Here you can have a sight into the analytic data of your apps, like downloads, active users and so on.
Sales and Trends
Data from your InApp or App sales.
Payments and sales Reports
Payments from your InApp or App sales.
It seems that iAd is not longer supported by Apple. Correct me if I’m wrong.
“iAd App Network will be Discontinued The iAd App Network will be discontinued as of June 30, 2016. Although we are no longer accepting new apps into the network, advertising campaigns may continue to run and you can still earn advertising revenue until June 30. If you’d like to continue promoting your apps through iAd until then, you can create a campaign using iAd Workbench. We will continue to keep you updated, but if you have any questions, contact us.” Notification by Apple
User and Roles
Here can you manage your users and their roles. Moreover you can setup and add Sandbox Test Accounts there, in order to test functions like InApp Purchases and so on.
Contracts, Taxes and Bank Transfer
This section is one of the most important one. Befor you start, fill out ALL needed information. Otherwise some features like InApp Purchase aren’t available. But more later.
Ressources and Help
Browse Apple’s Help page whenever you stuck on something.
Before you can start uploading your game for the Apple iTunes Store, please complete all needed contracts.Contracts & Tax
You cannot add stuff like “InApp” Products without setting up the Tax Contract!
Build your Application
If you have setup your iTunes Account and if you have added all needed contracts, you can start build and upload your first App to the Apple iTunes StoreBuild with cocoon.io by Ludei
We offer a guide showing you how to build your games using Construct 2 and Ludei’s CocoonIO. If you are new to that, please visit the guide and build your first application for Android and iOS!Construct 2 - How to build with CocoonIO
Why build with CocoonIO?
CocoonIO is a services provided by Ludei offering following features:
- Has the best performance for mobile games build with Construct 2 (using Canvas+)
- Free Construct 2 Plugins for Ads, InApp, and Social Services like Facebook, Google Play Games and GameCenter
- A growing and helpful community
- An online documentation
- An easy to use platform
- Small application size
Up to now Ludei offers the best way to get your mobile games to Android and iOS. Moreover Ludei is working hard to improve their platform and their services! So give it a try and register a free account here.CocoonIO
Upload a Build
There are two ways to upload your binary to the iTunes Store. Choose the one you prefer the most.
For this option, please deselect the iOS signning key in your CocoonIO Project.
Then “Compile” your game in CocoonIO.
When the compilation has finished, download the iOS build from CocoonIO and unzip it on your Mac Computer. You’ll get a “.xcarchive” file then.
Double click the archive file in order to open it mit XCode.
Click “Upload to App Store…” in order to upload this binary to your iTunes Connect Dashboard.
Select “Save for Ad Hoc Deploment” in order to install it via iTunes.
Then click on “Upload”.
Then click on Upload in order to start the upload (this may take a while).
Note: The binary will be added automatically to the corresponding app (via the Bundle ID).
Once the upload has finished, it takes some time till Apple has processed the file. You’ll get notifed via mail then. Once you got the mail that your file has been processed, you can select it for the submission or for the TestFlight.
Test before Upload
If you want to test it first on your Apple device, just click “Export…” instead. This will generate an .ipa file which you can install on your registred Apple devices via iTunes.
Select “Save for Ad Hoc Deploment” in order to install it via iTunes.
Then select your Developer Account and confirm it by clicking “Choose”.
Then unzip the package and double-click the .ipa file. This will automatically open it with iTunes. Connect your test device and install it.
New (since XCode update)
Please find the new guide for the latest XCode update here.
Via Application Loader
For this option please select your “Production – AppStore” certificate.
You find a guide here.Add Certificates to CocoonIO
Add your Application
Finally we can start to add our application to the Apple iTunes Store. In order to do this, please click on the “My Apps” icon in your dashboard or click the link below.iTunes - My Apps
Then click on the small plus (+) icon in the header menu and select “New App” (“Neue App” in German).
Now fill out all needed information for your new app.
Then click on “Create” (“Erstellen” in German)
Prepare the Store Page
If the the app was added successfully you’ll be redirected to prepare the Store entry for your game. Most of the fields are already filled out. Just add the link the your Datenschutzerklärung and select the categories for your app.
Then click on “Save” in the right upper corner of your screen. Then switch to “Price & Availability” and select the wished price for your app.
In this section you can add features to your application.
Add InApp Products to your game.iTunes - How to add InApp Products
Add a leaderboard and achievements to your game.iTunes - How to add GameCenter
Before you submit your app you should have tested it well! Otherwise you will lose a lot of time while waiting for a review of your app which will be rejected then.
First download the iOS TestFlight app on your test device(s) or any other Apple Device.
Then select your app in the My Apps Dashboard and select the “TestFlight” tab in the header menu.
Select the build which you want to use for the TestFlight and then follow the assistance.
If you feel ready, save and publish the TestFligt for your app. Once you have done that, all listed testers will get an email with a redeem code. Use this code in the TestFlight application. Now you can test your game directly on your devices.
You will not be charged if you purchase an item from an app in Testflight!
Prepare your Submission
Now it’s time to prepare the first submission of your game. In order to do this, please click on the corresponding tab in the left-side menu.
Upload here some screenshots of your game, but keep in mind that you have to upload screenshots for each display size!
For more information about the screenshots, please visit the Apple Help SectioniTunes - Add Screenshots
In this section you can describe your game. Moreover use descriptive tags, so that people can find the game in the store easily.
Please note, no HTML-Tags are allowed in this section!
Here you can select an uploaded build for the submission. Just click the plus (+) icon and select the wished build.
Here you need to add your personal information, like your address and so on. Moreover you have to upload the Store Icon here (note, this is not the Application Icon!)
Activate the GameCenter for your application (if wished). But note, you need to create the GameCenter first at the Features tab.
InApp products don’t need to be added to the Submission. They are included automatically in the first submission.
Those information are for the app review team from Apple. So provide your name and contact data. Moreover you can add a description.
Once you feel ready click on “Submit to Review” and then your app will be reviewed by Apple. If you got lucky, your game will be available in a few days after submission. But the chances are high that your first submission will be rejected, so stay cool, fix the things which were the reason for the rejection and then submit a new binary.
My first game took three submissions till it finaly went live, so don’t be disappointed 🙂
This guide was written for all newbies like me 😛 It took me very long till I knew how to publish my first application with Apple. So I decided to make this guide to help all others struggling the same then me.
If you want to show your support, please check and download my games. This helps me a lot
Or download them directly here.
Suggestions & Feedback
Every suggestion and feedback is appreciated! So don’t hesitate to get in touch with me. You can find me on
The Apple logo, iPhone, iPod touch, iPad, iTunes Connect and iTunes are trademarks of Apple Inc., registered in the U.S. and other countries.
This guide is not associated with Apple. I made this guide to help beginners to get started with developing for iOS. The content shown in the screenshots is property of Apple Inc.
If anyone feels offended by the content of this guide, don’t hesitate to contact me directly. I’ll give my very best to solve the issues then.Mail us!