If you are reading this Online Help, it means that you have decided to compile your iOS app by yourself.  

After going through this process, you will be able to test your native iOS app on your phone before submitting it to Apple's App Store.

First, go to the page Publish > Publication > iOS in your Apollo Apps back office.

To do the process by yourself, select the option with the Ninja picture by clicking the green button “Begin submission”.

1. Step 0 : First Time?

At Step 0, you will be asked if your app is an update of a first submission.

- Select New if this is the first time ever this iOS app is published on the store.
- Select Update if the app is already published on the store.

Then, go to the next step.

2. Step 1 : Developer Account

To be able to complete the process, remember to create your Apple Developer account.
When your account is valid, you can go on with the process.

You can either create a new distribution certificate, or using an existing distribution certificate (only if you have already created another iOS app before).

Case n°1: You don’t have an existing distribution certificate :
Create a new one and go to the next step.

Case n°2: You have already submitted another app with Apollo Apps, using the same account ID, and its distribution certificate is still valid:
Select I want to use an existing distribution certificate and choose the other app from the list.

Case n°3: You have a .p12 file associated to a valid distribution certificate
Select I want to use an existing distribution certificate and upload your .p12 file.
In order for it to work in the backend, the associated password of this .p12 file needs to be: duoapps. This is very important, otherwise the import may fail.

NOTE: If you don't know what a .p12 is, or don't know how to get it, Apollo Apps can not do it for you.
In this case, select "I want to create a new distribution certificate" in order to continue.

3. Step 2 : Certificate

If you haven’t done it already, the following screen will prompt you to create your Apple Developer Account (2.1). If you already have a valid account, you can go to step 2.2.

2.2: Click on the green button to generate a .CSR file, which will automatically be downloaded on your computer.

2.3: Login to your Apple Developer account https://developer.apple.com/account/ios/certificate/
Under the menu Certificates, use the top right + sign to add a new certificate.
Choose under the Production section “App Store and Ad Hoc”.  Then follow the steps until you are required to upload a .CSR file.

2.4: Upload the .CSR file previously downloaded from your Apollo Apps backend, and click on "Generate".
This will generate a .CER file.
Download that .CER file and go back to the submission process in your Apollo Apps backend.  

2.5: Upload the .CER file you have just downloaded, then go to the following step.

4. Step 3 : App ID

You can create several applications with the same Apple Developer account, which is why each application has a unique App ID.

If the app already exists on the store, skip this step and go directly to Step 4.  

If this is a new app:

3.1: Go to your Apple Developer Account, https://developer.apple.com/account/ios/identifier/bundle, under the menu Identifiers > App IDs, and use the + sign at the top right of the screen to add a new App ID.

3.2: We provide a default App ID Information at step 3.2 in the submission process: the App ID Description (by default, the name of your project) and the App ID Suffix, also called Bundle ID (by default com.Apollo Apps.yourprojectname).

NOTE : You are free to use a different App ID than the one we provide, as long as the Bundle ID respects the format: com.yourcompany.yourapp

Copy (or create) the values in the Apple Developer account, and at the bottom check the box “Push Notifications”, and then select Continue.

3.3 : Validate. Your App ID is now created, you can go to the next step in the backend.

5. Step 4: Push

At this point of the process, you will create your Push Certificate, so your iOS app can receive push notifications.

4.1: Generate the .CSR file in your Apollo Apps backend. The file will be automatically downloaded to your computer.

4.2: In your Apple Developer account https://developer.apple.com/account/ios/certificate/  , under the menu Certificates, use the top right + sign to add a new certificate.

4.3: Select Production > Apple Push Notification service SSL (Sandbox & Production)

The push certificate is associated with the App ID.
NOTE : Be very careful with this step. If you choose the wrong App ID, the push notifications won’t work in your app!  

If the app is new, select the App ID you have just created in step 3.
If this is an update of an existing app, select the App ID of the existing app.

4.4: Continue until you can upload the .CSR file downloaded in your backend, and click "Generate".

4.5: When the Apple Push Service certificate is generated, click on "Continue" and then on "Download" to save the .CER file on your computer.

4.6: In your backend upload the .CER file and go to the next step.

6. Step 5: Mobile Provision

The mobile provision file is a certificate authenticating your application on your behalf on the App Store.

5.1: In the Apple Developer Account, https://developer.apple.com/account/ios/profile/ under the menu Provisioning Profiles > All, use the + sign on the top right to create a new provisioning profile.

Select Distribution > App Store.

The mobile provision file App Store is associated with:

A - The App ID
NOTE : Be very careful with this step. If you choose the wrong App ID, you will have problems to publish the app on the store!

If the app is new, select the App ID you have just created in step 3.  
If this is an update of an existing app, select the App ID of the existing app.

B - The Distribution Certificate
NOTE : Be very careful with this step. If you choose the wrong Distribution certificate, you won’t be able to generate your app!

If you have created a new Distribution Certificate for this app, select it. If you have more than one, it is the one with today’s date.

If you have used an existing Distribution Certificate, select the one with the same date as the Distribution Certificate you see in the Publish > Certificates > iOS menu in your backend.

5.2: Give the mobile provision the name of your project.

5.3: Download the mobile provision from the Apple Developer account.

5.4: Download the mobile provision in the backend and go to the next step.

7. Step 6: Ad Hoc Mobile Provision

The Ad Hoc mobile provision file will allow you to install the Ad Hoc version of your app on registered device(s), in order to test all is native features (like the push notifications for example).

The Ad Hoc version of the app is its exact copy of the app you will later on submit to the store, but it can only be tested on the devices registered in your Apple Developer account and associated to the Ad Hoc mobile provision file.

This is why you start by getting and registering the UDID(s) of the device(s) on which you will install your Ad Hoc version.

8. Registration of the test device(s)

6.1: To get the UDID of an iOS device, you need to have iTunes installed on your computer.
Any other method will give you an invalid UDID, and you won’t be able to test your app on the device.

 

Open iTunes, and plug your device to your computer.
Click on the device icon to open a page with the device information.
On the right, under the capacity and your phone number, click on the information until it displays the UDID, and copy it.

If you do not have an iOS device (iPhone or iPad), use this UDID: f571e678683641fab3bf162c8be61e3deefee9b6
Note : Without an iPhone, you will not be able to test the AdHoc version.

6.2: In the Apple Developer Account, https://developer.apple.com/account/ios/device/ under the menu Devices > All, use the + sign on the top right to register a new device.

6.3: Give a name to your device, paste the UDID copied from iTunes and register the device.
Do the whole process for each new device on which you want to test your app.

Note: If you don’t have an iOS device, you still need to register a device to generate the Ad Hoc mobile provision file, so do the process with the default UDID:
f571e678683641fab3bf162c8be61e3deefee9b6

6.4: In the Apple Developer Account, https://developer.apple.com/account/ios/profile/ under the menu Provisioning Profiles > All, use the + sign on the top right to create a new provisioning profile.

Select Distribution > Ad Hoc.

Just like the mobile provision App Store, the mobile provision file Ad Hoc is associated with:

A -The App ID
NOTE : Be very careful with this step. If you choose the wrong App ID, you will have problems to publish the app on the store!

If the app is new, select the App ID you have just created in step 3.  
If this is an update of an existing app, select the App ID of the existing app.

B -The Distribution Certificate
NOTE : Be very careful with this step. If you choose the wrong Distribution certificate, you won’t be able to generate your app!

If you have created a new Distribution Certificate for this app, select it. If you have more than one, it is the one with today’s date.
If you have used an existing Distribution Certificate, select the one with the same date as the Distribution Certificate you see in the Publish > Certificates > iOS menu in your backend.

AND ALSO:

C - The Registered Device(s)  
NOTE : Be very careful with this step. If you don’t select your device at this step, you won’t be able to install your app on it.

6.5: Generate the Ad Hoc mobile provision file.

6.6: Download the Ad Hoc mobile provision file.

6.7: Upload it in the backend, and validate the last step.

If you all did correctly until now, this screen should appear, and allow you to build the app.
Click on the green button, and wait for your app to be generated. It can take several minutes.

9. Test, then Modify or Submit the app

After a few minutes, a new screen will appear to inform you your iOS app is ready to be tested.  

To test it, click on the green “Test my application” button to display a pop-up window with the full instructions.
Open the url from the browser of your device to install the app.  

Remember, you can test your app on registered device(s) ONLY.

10. Download and test the Ad Hoc version

11. Continue editing or Submit to the store

Once you have tested your app, go back to this page (you can access it by going to Publish > Publication > iOS).  

  • To continue editing your app, click on Modify. 

The Ninja picture with the “Build my application” green button will show again.
When you are done editing your app, you will be able to build it again from this step.

- To submit your app to iTunes Connect and publish it on the store, click on Submit.
Then, follow this tutorial on how to submit your iOS app to Apple's App Store.  

NOTE : Be very careful with this step, and only hit the button when you are ready to submit the app.
Once you have clicked on Submit, your backend will be partly locked: you will still be able to work on your app, but you won’t be able to update the latest changes from the Publish > Update > Changelog menu, as long as the app hasn’t been published on the store.

Did this answer your question?