This article will take you through the process of building an iOS app. In order to make sure you build your app successfully, you should refer to the following articles before you build so that the proper settings are configured:
Before you begin
- In order to create an iOS app, you must have a valid Mag+ Publish account. Visit publish.magplus.com to sign up.
- You will need a valid iTunes Connect account that you have set-up and configured in order to fill out all fields required by the Mag+ Publish portal.
- If using an analytics service, be sure to sign up for the service and get your unique key.
Note: For more information on creating an iOS distribution channel, refer to the section "Setting Up Distribution Channels."
Configuring iOS App Settings
1. Log in to the Mag+ Publish Portal at <http://publish.magplus.com> and click on your Brand.
Note: If you have only one Brand, you will immediately be presented with a tabbed interface with various options.
3. Click on the iOS tab in order to configure settings associated with iOS.
Some options may be listed as "Complete" even though you have not made any changes. That's because Mag+ will use its default settings. It's important to go through all the options the first time you build an app, since there are some things you may want to change, including the look and feel of your app.
Note: iTunes Connect Settings are configured when you set-up your iOS Distribution Channel. For more information on creating an iOS distribution channel, refer to the section "Setting Up Distribution Channels."
4. (Optional) If you have special content like Banners and Featured Content to display in your app, you can set them via the appropriate link.
- For more information on Mag+ Banners, read the article "General - Using In-app Banners."
- For more information on Mag+ Featured Content, read the article "General - Adding Featured Content to Apps."
5. Click on Assets and Configuration > Build Options to specify iOS build settings.
Note: iOS Build Options are typically configured when you set-up your iOS Distribution Channel. For more information on creating an iOS distribution channel, refer to the section "Setting Up Distribution Channels."
6. Click on "Save" at the bottom of the screen to save your Build Options.
7. (Optional) Click on an "Upload Help MIB file" link for iPhone or iPhone 5 or iPad.
Here you can upload a special Help MIB for your app. Press the"Browse" link to find the appropriate MIB to upload and which devices its resolution will serve.
- Help MIB options will vary depending on the type of app you create: iPhone, iPad, or iOS Universal. If you are building a universal iOS app but have created an iPad-specific Help MIB, you must also upload an iPhone-specific Help MIB. For more information about creating a Universal Help MIB that can be used with all devices, read the article "iOS - How to Create a Universal Help MIB."
- If you do not upload a Help MIB, your app will be built without a Help menu item.
8. (Optional) Click on Assets and Configuration > Analytics Configuration to configure third party analytics.
You are not required to include any analytics tools with your app. If you do, you will need to provide a unique key for your chosen analytics service in order for it to function properly.
For more information, read the article "Reference - Mag+ Analytics 101."
Analytics Type: This option allows you to specify an analytics service to be associated with your app. Current options include:
- None: Choose if you have no analytics service.
- Flurry: Uses the Flurry analytics service. For more information, read the article "Analytics - Using Flurry."
- Google Analytics: Uses the Google Analytics service: For more information, read the article "Analytics - Using Google Analytics."
- Localytics: Uses the Localytics analytics service. For more information, read the article "Analytics - Using Localytics."
- Omniture: Uses the Omniture analytics service. For more information, read the article "Analytics - Using Omniture."
- Analytics Key: This is the unique key provided to you when you sign up for an analytics service.
- Analytics Offline Reporting (iOS Only): This feature can be enabled if your analytics service supports offline reporting.
9. App Store Settings and Certificate and Provisioning files should already be configured.
Note: This information should be configured when you create your distribution channels. For more information on creating an iOS distribution channel, refer to the section "Setting Up Distribution Channels."
10. Configure your app customizations.
Customizations allow you to change the look and feel of your app. For a complete listing of the customization options, please read the article "iOS - How to Customize your App's Look and Feel."
11. Apple Push Notifications should already be configured.
Note: This information should already be configured when you created your distribution channels. For more information on creating an iOS distribution channel, refer to the section "Setting Up Distribution Channels."
12. Build your app.
As you finish each section of the Market Settings and Assets and Configuration screens, a status message will tell you if the section is complete or incomplete.
Note: You can only generate a build when all required sections are labeled "Complete."
When each section is listed as complete, you may build your app by pressing the "Generate new Build" button. The Mag+ Publishing portal will begin creating your app on the Mag+ servers. Note that the page will not refresh automatically. You may refresh the Build page every few minutes to check if it is complete, but you will also receive an email to the designated administrator email address when the build is done.
Note: The Build History area of the page will indicate whether a build was created successfully or if there were any errors.
Once finished, the Build History area of the screen will offer you two ways to download a completed app:
- The filename of the successfully created app will be available as a link you may click to download. This app package will contain both an ad hoc version of your app that you can install on test devices and the actual app which can be submitted to iTunes Connect.
- A Send E-Mail link will allow you to send an e-mail to a user with a link they may click on to download the ad hoc version of your app. They may install this ad hoc version on their device for testing.
In order to test a generated app, you should download it to a device you have included in your Ad Hoc Provisioning Profile in Apple's iOS Provisioning Portal. For more information on testing, read the article "iOS - Testing Your App Before Distribution."
For more information on delivering your app to the iTunes App Store, refer to the articles in the section "Delivering Your App."