Learn how to export your iOS app to the App Store with the help of Kotobee Author and test the app after you upload it to the App store.


If you haven't already, first read how to Export Mobile Apps, for general instructions on creating any mobile app with Kotobee, and Set Up Your App Information, for instructions to help you enter your app's general information. Then return here for specific instructions on creating and adding apps to the Apple App Store.

Free alternatives

  1. Export your ebook as an EPUB file, and send it to your users to open it through the free Kotobee Reader app available on the App Store.
  2. Directly upload your ebook to the Kotobee Official Library through Kotobee Author. Your users will be able to access the library through the free Kotobee Reader app available on the App Store.

Requirements to Create iOS Apps 

Kotobee Author requires three things to export a mobile app:

  1. A Provisioning Profile that comes with the extension .mobileprovision.
  2. A Certificate file (with a password) that comes with the extension .p12.
  3. An App ID to represent your app on the App Store.

To get all those, you need to have an Apple Developer Account. Below we provide you with brief instructions for each one.

While a Mac machine is recommended for some of the steps listed here, this video tutorial created by one of our users can show you how it's possible to create p12 certificate files on Windows without needing a Mac machine.

To begin, click Enable in the iOS apps export window. 
The required information for iOS apps will appear and the Required Mobile Credits in the lower header will be calculated for you.

Create the p12 certificate file.

  1. Login to http://developer.apple.com.
  2. Click on Certificates, Identifiers & Profiles.
  3. Click on All under Certificates since you need a Production Certificate.
  4. Click on the + icon at the top right. Select App Store and Ad Hoc under Production to create a new certificate  and click on Continue.
  5. Follow the displayed instructions on your Mac to create a CSR file and hit Continue.
  6. Select the CSR file you just created and hit Continue.
  7. Click Download to download the certificate in CER extension.
  8. Double-click the certificate file you just downloaded on your Mac desktop. 
  9. Open the Keychain Access app, and find your certificate. 
    Make sure you are in the Certificates category (selected from the bottom left panel). 
  10. Command-click on the certificate and select Export. Choose to export it as a p12 certificate. 
    You will be asked to enter a password of your choice. You will need this password in a minute.

    Be sure to have the certificate itself selected and not the private key; the private key becomes visible only when you expand the certificate by click on its arrow icon. The p12 certificate will need to be created just once. So it will be handy to keep it on your computer to use for other ebooks. 

  11. Go back to Kotobee Author, and click Add Certificate (p12) file to add the p12 file you just created.
  12. Enter the Certificate Password you just created. 

Create an app ID

  1. Click on App IDs under Identifiers.
  2. Click on the sign at the top right to create a new App ID.
  3. Enter a Name for your certificate.
  4. Enter a Unique ID string under Explicitly App ID to be used to identify your app. Make sure you read the instructions and recommendations. If you are planning to create several ebook apps then it may be better to create a Wildcard App ID, so that you don't have to repeat the process for each app.
  5. Click on Continue to go to the next page.
  6. Confirm the information displayed is correct and click on Register.
  7. You will need the App ID in the next step, creating a a provisioning profile.

Create the provisioning profile
  1. Click on All under Provisioning Profiles.
  2. Click on the + sign at the top right to create a new Provisioning Profile.
  3. Select App Store under Distribution and click Continue
    If you want to distribute the app to specific devices then select Ad Hoc instead. In the Testing your app section below, the Development profile type will be mentioned if you are interested in creating a test version of your app first.
  4. Select the App ID you've just created from the list and hit Continue.
  5. Select the appropriate certificate from the list and hit Continue.
  6. Enter a profile name and hit Continue.
  7. Click on Download to download the provisioning profile to your computer.
    The Provisioning Profile will have to be created for each app your export, unless you are using a wildcard App ID.
  8. Back to Kotobee Author, click on Add Provisioning file.

If you find yourself lost somewhere along these steps, you can refer to this helpful video.

Upload your app

It will take a few minutes from Kotobee's servers to generate the app for you. Until that's done, log into iTunes Connect and create a new iOS app there. If the app is already existing and you're simply creating an app update, then make sure you've added a new version to the app.

Once the app is generated by Kotobee, you will receive a notification email with a download link to the app's IPA file. Download the IPA file and save it somewhere on your computer.

To start uploading your app, you will need to use the Transporter app. If you don't have it, you may download it from the Mac App Store.

Transporter will first require that you sign in with your Apple ID. Once you've signed in with your Apple ID, simply drag the IPA file onto the Transporter app, and follow the instructions.

Troubleshooting

A common error you may experience when uploading the app is the following:

This indicates that some packages on your Mac are outdated and need updating. To do so, open Terminal, and type in xcode-select --install . This will display a popup asking if you would like to install Command Line Developer Tools.

Click Install and wait for the updates to finish installing. After installation is complete, upload the app again on Transporter.

Test your app

If you've already uploaded your app to the App Store, but haven't published it yet, you can test your app using TestFlight

TestFlight allows you to test your app before adding it to the App Store, as well as invite other testers to test with you. You'll need to download the TestFlight App on your iPhone or iPad device. TestFlight's settings in your iTunes connect account may be accessed from here:

Some gotchas

If you are providing secure access to your ebooks with promo codes using Kotobee Cloud or Kotobee Library, it is possible that Apple will reject your app, with the reason that apps may not use their own mechanisms to unlock content or functionality. In this case, it is important to mention in the demo instructions while you're submitting the app on iTunesConnect that the promo code is the term we use for the access code. It is merely an alternative for email/password login, and not used to unlock features and functionality. You may provide a sample promo code for them to test with as well.