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 AppStore 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.
Configuring iOS App Settings
1. Log in to the mag+ Publish Portal at and click on your Brand.
Note: If you have only one Brand, you will immediately be presented with a tabbed interface with various options.
2. Click on the Apps tab.
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.
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."
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:
- 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.
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 AppStore 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 AppStore App Store, refer to the articles in the section "Delivering Your App."