- 1. Enroll for an Apple Developer Account
- 2. Download Xcode from the Developer Portal
- 3. Gain access to publish.magplus.com
- 4. Create a Distribution Certificate
- 5. Add test devices that can install your app on their iPad
- 6. Create an App ID and your App
- 7. Create in-app purchases for your paid issues
- 8. Create an in-app purchase for subscription
- 9. Create your Provisioning Distribute Certificates and p12 key
1. Enroll for an Apple Developer Account
Go to developer.apple.com and enroll for a paid Apple Developer Program, in 24 hours you will gain access the iOS Provisioning Portal.
2. Download Xcode from the Developer Portal
Go to developer.apple.com and download the latest version of Xcode. It is about 4GB in size so it is good to start downloading it sooner than later if you have an unstable internet service.
3. Gain access to publish.magplus.com
Contact sales@magplus.com to gain access to Publish.magplus.com
4. Create a Distribution Certificate
If you plan to use Push Notifications in your app, complete this step at publish.magplus.com first in order to create your push notification certificate. If you do not wish to be able to send Push Notifications in your app or have already completed that step, go to Apple Developer Distribution Certificate Support and read the points:
Obtaining your iOS Distribution Certificate,
Generating a Certificate Signing Request
Submitting a Certificate Signing Request for Approval
Please note that these steps have to be done on the same apple computer (iMac, MacBook etc.) that you will use for important interaction with App Store. (Apple will identify that computer, and you will be able to transfer access, but recommendation is keeping it to one computer).
Obtaining your iOS Distribution Certificate,
Generating a Certificate Signing Request
Submitting a Certificate Signing Request for Approval
Please note that these steps have to be done on the same apple computer (iMac, MacBook etc.) that you will use for important interaction with App Store. (Apple will identify that computer, and you will be able to transfer access, but recommendation is keeping it to one computer).
5. Add test devices that can install your app on their iPad
Go to the iOS Provisioning Portal and click on Devices. Click Add Devices and enter the devices Name and UDIDs. The easiest way to find your iPad’s UDID is to use apps such as UDID+ and mail it to yourself, it contains several characters and if one is wrong it will not work.
6. Create an App ID and your App
An App ID is a unique identifier that iOS uses to allow your application to connect to the Apple Push Notification service, share key chain data between applications, and communicate with external hardware accessories you wish to pair your iOS application with. In order to install your application on an iOS based device, you will need to create an App ID.
Go to your iOS Provisioning Portal. Click the tab App IDs.
Click Add New App ID
Description - Enter the name of your app
Bundle Seed ID (App ID Prefix) - If you are creating a suite of applications that will share the same Keychain Access, use the same bundle Seed ID for each of your application’s App IDs. Otherwise, choose Generate New.
Bundle Identifier (App ID Suffix) – Enter a unique identifier for your app ID. Preferably use the Brand ID you created in MAGProd.
E.g. com.brand.publication
Never use a wildcard ID! (i.e. *.brand.publication or com.brand.*)
Click Submit
The next step is to create your app:
Go to iTunes Connect, log in using your Apple Developer credentials and click Manage Your Applications. In the Manage Your Apps menu, click Add New App.
App name – Enter the name of your App as it will appear in the App Store (this is not the name that appears under the icon—that is set in Publish).
SKU Number – Unique identifier for your app. This is only for your tracking purposes on revenue payments from Apple.
Bundle ID - Select the ID that was created when you made your App ID in the iOS Provisioning Portal.
Click Continue
Version # – Set the version number that matches Mag+’s current version.
Description – this is the copy that will appear in the iTunes store for your app. Note that you can change this anytime after the app is approved.
Categories – This is the iTunes store category your app will be placed in. This can only be changed with an app update.
Keywords – These are the words that will trigger your app to come up when people search the iTunes store. The limit is around 120 characters and you don’t need spaces between commas. Note that your app’s name is automatically searchable, so don’t waste characters on that. These too can only be changed on an app update.
Contact email – This should be the email of someone in your organization who can answer questions from Apple should they come up. If we at support@magplus.com recieves support tickets from your customers, we will have to charge you accordingly. So please set this up correctly.
Support URL – Typically a page on your company’s site that users can go to learn more or get answers to questions. Please use our Customer FAQ (that you can get from our support@magplus.com) that contains the top 20 questions and answers you should provide to your customers.
Privacy policy – A URL for your company’s privacy policy. Needed if you provide subscriptions. Apple links to this URL on the customers receipts.
Icon – Load the 512×512 pixel PNG version of your icon. Apple will automatically round the corners. This can only be changed on an app update.
iPad Screenshots – Typically screenshots of pages from your issue. These can be changed anytime.
iPhone Screenshots – Don’t upload any Screenshots for iPhone.
In-App purchases – It’s a good idea to create the in-app purchase for at least your first issue as well as subscriptions if you are planning on selling them and choose them here to submit for approval with your app. That way everything is approved at once.
Now your app is created. Do not submit/upload your App to Apple yet. We will have to connect the app to Publish first.
Go to your iOS Provisioning Portal. Click the tab App IDs.
Click Add New App ID
Description - Enter the name of your app
Bundle Seed ID (App ID Prefix) - If you are creating a suite of applications that will share the same Keychain Access, use the same bundle Seed ID for each of your application’s App IDs. Otherwise, choose Generate New.
Bundle Identifier (App ID Suffix) – Enter a unique identifier for your app ID. Preferably use the Brand ID you created in MAGProd.
E.g. com.brand.publication
Never use a wildcard ID! (i.e. *.brand.publication or com.brand.*)
Click Submit
The next step is to create your app:
Go to iTunes Connect, log in using your Apple Developer credentials and click Manage Your Applications. In the Manage Your Apps menu, click Add New App.
App name – Enter the name of your App as it will appear in the App Store (this is not the name that appears under the icon—that is set in Publish).
SKU Number – Unique identifier for your app. This is only for your tracking purposes on revenue payments from Apple.
Bundle ID - Select the ID that was created when you made your App ID in the iOS Provisioning Portal.
Click Continue
Version # – Set the version number that matches Mag+’s current version.
Description – this is the copy that will appear in the iTunes store for your app. Note that you can change this anytime after the app is approved.
Categories – This is the iTunes store category your app will be placed in. This can only be changed with an app update.
Keywords – These are the words that will trigger your app to come up when people search the iTunes store. The limit is around 120 characters and you don’t need spaces between commas. Note that your app’s name is automatically searchable, so don’t waste characters on that. These too can only be changed on an app update.
Contact email – This should be the email of someone in your organization who can answer questions from Apple should they come up. If we at support@magplus.com recieves support tickets from your customers, we will have to charge you accordingly. So please set this up correctly.
Support URL – Typically a page on your company’s site that users can go to learn more or get answers to questions. Please use our Customer FAQ (that you can get from our support@magplus.com) that contains the top 20 questions and answers you should provide to your customers.
Privacy policy – A URL for your company’s privacy policy. Needed if you provide subscriptions. Apple links to this URL on the customers receipts.
Icon – Load the 512×512 pixel PNG version of your icon. Apple will automatically round the corners. This can only be changed on an app update.
iPad Screenshots – Typically screenshots of pages from your issue. These can be changed anytime.
iPhone Screenshots – Don’t upload any Screenshots for iPhone.
In-App purchases – It’s a good idea to create the in-app purchase for at least your first issue as well as subscriptions if you are planning on selling them and choose them here to submit for approval with your app. That way everything is approved at once.
Now your app is created. Do not submit/upload your App to Apple yet. We will have to connect the app to Publish first.
7. Create in-app purchases for your paid issues
If you do not plan to sell any issues in your app, skip this step.
Because Apple must approve all in-app purchases—not the content, just that the “token” associated with it is set up correctly—we recommend to create in-app purchases for all issues they plan to release during the year and submit them all for approval, just leaving the “Cleared for sale” box checked “no” until they are ready to publish that issue.
Go to iTunes Connect and log in using your credentials. On the iTunes connect start page click Manage Your Applications.
Click on your app you wish to make an in-app purchase for.
Now you will see your apps’ information such as Bundle ID, Apple ID, version etc. Click Manage In-App Purchases and on the following page, click Create New.
Because you wish to create an in-app purchase for an issue, choose Non-Consumable.
Details
Reference Name – This name is only for your own reference, it will be viewed in iTunes Connect and in sales and trend reports.
Product ID – Preferably follow the setup that you have used before when creating your Brand ID. For example: com.brand.publication.issue01. This is the Apple product identifier you will be asked to enter when you are adding a new issue in Publish.
Add Language – Click Add Language.
Language – If your language is not listed, select English and enter Name and Description in desired language.
Display Name – This is the name that will be viewed on your customers iTunes receipt. The name of the issue viewed in the app is the title you choose for your issue in Publish later.
Display Description – This is the description that will be viewed on your customers iTunes receipt. The description of the issue viewed in the app is the description you enter for your issue in Publish later.
Pricing
Cleared for Sale – Select Yes if the issue is correctly uploaded to Publish and you wish to publish the issue as soon as possible. Select No if you plan to publish this issue later.
Price Tier – View the Pricing Matrix, then choose price tier for the issue.
Screenshot for Review
Before you submit your In-App Purchase for review, you must upload a screenshot. This screenshot will be for review purposes only. It will not be displayed on the App Store. Screenshots must be at least 320×460 pixels and at least 72 DPI.
Click Save.
Because Apple must approve all in-app purchases—not the content, just that the “token” associated with it is set up correctly—we recommend to create in-app purchases for all issues they plan to release during the year and submit them all for approval, just leaving the “Cleared for sale” box checked “no” until they are ready to publish that issue.
Go to iTunes Connect and log in using your credentials. On the iTunes connect start page click Manage Your Applications.
Click on your app you wish to make an in-app purchase for.
Now you will see your apps’ information such as Bundle ID, Apple ID, version etc. Click Manage In-App Purchases and on the following page, click Create New.
Because you wish to create an in-app purchase for an issue, choose Non-Consumable.
Details
Reference Name – This name is only for your own reference, it will be viewed in iTunes Connect and in sales and trend reports.
Product ID – Preferably follow the setup that you have used before when creating your Brand ID. For example: com.brand.publication.issue01. This is the Apple product identifier you will be asked to enter when you are adding a new issue in Publish.
Add Language – Click Add Language.
Language – If your language is not listed, select English and enter Name and Description in desired language.
Display Name – This is the name that will be viewed on your customers iTunes receipt. The name of the issue viewed in the app is the title you choose for your issue in Publish later.
Display Description – This is the description that will be viewed on your customers iTunes receipt. The description of the issue viewed in the app is the description you enter for your issue in Publish later.
Pricing
Cleared for Sale – Select Yes if the issue is correctly uploaded to Publish and you wish to publish the issue as soon as possible. Select No if you plan to publish this issue later.
Price Tier – View the Pricing Matrix, then choose price tier for the issue.
Screenshot for Review
Before you submit your In-App Purchase for review, you must upload a screenshot. This screenshot will be for review purposes only. It will not be displayed on the App Store. Screenshots must be at least 320×460 pixels and at least 72 DPI.
Click Save.
8. Create an in-app purchase for subscription
If you do not plan to offer subscriptions in your app, skip this step.
Creating a subscription in-app purchase is easy. The Auto-Renewable Subscription in-app purchase creates a “Subscription” icon in the issues list in which the subscription options are listed in.
Go to iTunes Connect and log in using your credentials. On the iTunes connect start page click Manage Your Applications.
Click on your app you wish to make an in-app purchase for.
Now you will see your apps’ information such as Bundle ID, Apple ID, version etc. Click Manage In-App Purchases and on the following page, click Create New.
Because you which to create an in-app purchase for a subscription, choose Auto-Renewable Subscription.
Reference Name and Languages
Reference Name – The reference name will be displayed in iTunes Connect and in sales and trends reports. It will not be displayed on the App Store.
Click Add Language
Select Language – If a language is not listed, select English and enter Name and Description in desired language.
Display Name – This is where you enter the name of your “subscription link” in your app*. E.g. Subscriptions, Subscribe etc.
*Do not include duration or price, this will be done later.
Display Description – This is the description that will be viewed on your customers iTunes receipt. Do not include any information regarding price or length of subscription, this will be done later in
Publication Name – Enter the name of your publication.
Click Save
Subscription Durations and Pricing
Here is where you add your different subscription duration offers to your readers. You can add as many durations as you wish. In Publish you will enter title and description for each subscription duration using the Product ID created here to connect the two systems.
Click Add Duration
Duration – A subscription duration is the length of time between auto-renewals. Note that each duration can only be used once per family.
Product ID – Enter a Product ID for your subscription duration.
E.g. com.brand.publication.subscription1month*.
*This is the Apple product identifier you will be asked to enter when you are setting up your subscription in Publish.
Offer a marketing opt-in incentive? – Select Yes to give customers a free subscription extension if they initially choose not to share their personal information. Incentive durations possible appear when Yes is checked.
Cleared for Sale – Select Yes if the subscription is correctly uploaded to Publish and you wish to enable the subscription duration as soon as possible. Select No if you plan to enable this duration later.
Price Tier – View the Pricing Matrix, then choose price tier for the subscription duration.
Screenshot for Review
Before you submit your auto-renewable In-App Purchase subscription for review, you must upload a screenshot. This screenshot will be for review purposes only. It will not be displayed on the App Store. Screenshots must be at least 320×460 pixels and at least 72 DPI. This could for example be a cover of your magazine.
Click Save
Creating a subscription in-app purchase is easy. The Auto-Renewable Subscription in-app purchase creates a “Subscription” icon in the issues list in which the subscription options are listed in.
Go to iTunes Connect and log in using your credentials. On the iTunes connect start page click Manage Your Applications.
Click on your app you wish to make an in-app purchase for.
Now you will see your apps’ information such as Bundle ID, Apple ID, version etc. Click Manage In-App Purchases and on the following page, click Create New.
Because you which to create an in-app purchase for a subscription, choose Auto-Renewable Subscription.
Reference Name and Languages
Reference Name – The reference name will be displayed in iTunes Connect and in sales and trends reports. It will not be displayed on the App Store.
Click Add Language
Select Language – If a language is not listed, select English and enter Name and Description in desired language.
Display Name – This is where you enter the name of your “subscription link” in your app*. E.g. Subscriptions, Subscribe etc.
*Do not include duration or price, this will be done later.
Display Description – This is the description that will be viewed on your customers iTunes receipt. Do not include any information regarding price or length of subscription, this will be done later in
Publication Name – Enter the name of your publication.
Click Save
Subscription Durations and Pricing
Here is where you add your different subscription duration offers to your readers. You can add as many durations as you wish. In Publish you will enter title and description for each subscription duration using the Product ID created here to connect the two systems.
Click Add Duration
Duration – A subscription duration is the length of time between auto-renewals. Note that each duration can only be used once per family.
Product ID – Enter a Product ID for your subscription duration.
E.g. com.brand.publication.subscription1month*.
*This is the Apple product identifier you will be asked to enter when you are setting up your subscription in Publish.
Offer a marketing opt-in incentive? – Select Yes to give customers a free subscription extension if they initially choose not to share their personal information. Incentive durations possible appear when Yes is checked.
Cleared for Sale – Select Yes if the subscription is correctly uploaded to Publish and you wish to enable the subscription duration as soon as possible. Select No if you plan to enable this duration later.
Price Tier – View the Pricing Matrix, then choose price tier for the subscription duration.
Screenshot for Review
Before you submit your auto-renewable In-App Purchase subscription for review, you must upload a screenshot. This screenshot will be for review purposes only. It will not be displayed on the App Store. Screenshots must be at least 320×460 pixels and at least 72 DPI. This could for example be a cover of your magazine.
Click Save
9. Create your Provisioning Distribute Certificates and p12 key
The .p12 file saves your certificate and private key information. Creating the .p12 certificate requires you to use the Apple Developer site to create and download a certificate and then use the Keychain Access utility to export the certificate and private key of that certificate as a .p12 certificate. Follow these steps to set up your provisioning profiles and creating your .p12 certificate.
Go to developer.apple.com, log in using your credentials, once in the iOS Provisioning Portal, click on the Provisioning tab and then Distribution. We are now going to create two profiles, one for reviewing your app and publications (Ad Hoc) and one for App Store (App Store). Click New Profile.
First we create the distribution profile for AppStore.
Distribution Method – Check App Store
Profile Name – Enter the name of your app, add AppStore in the end.
E.g. AppName AppStore
App ID - Select the App ID of the app you are creating the provisioning profile for.
Click Submit
Now we are going to create the distribution provisioning profile for AdHoc. But before we start, click the Devices tab. Here you can add devices that you wish to review your publications on. Add devices by clicking Add Device and then enter the iPads UDID and desired name of the device. See “1.5. Add test devices that can install your app on their iPad.” on page 2.
Go back to Provisioning > Distribution. Click New Profile.
Distribution Method – Check Ad Hoc
Profile Name – Enter the name of your app, add AdHoc in the end.
E.g. AppName AdHoc
App ID - Select the App ID of the app you are creating the provisioning profile for.
Devices (optional) – Select up to 100 devices for distributing the final application; the final application will run only on these selected devices.
Click Submit
Now click Certificates and then the Distribution tab. Now you should see your certificate with your distribution provisioning profiles that you just created listed.
Before you continue you have to have the WWDR intermediate certificate installed, you can download it using the link under your certificate.
After you have installed the WWDR intermediate certificate, download your Distribution Certificate.
Now open your Keychain Access application which is Apple’s password management system in Mac OS.
Select the Keys category.
Control-Click on the private key associated with your iOS Development Certificate and click Export Items in the menu. The private key is identified by the iOS Developer: <First Name> <Last Name> public certificate that is paired with it.
Save your key in the Personal Information Exchange (.p12) file format.
You will be asked to create a password but leave it blank and click OK.
Now you have created your .p12 file to upload to Publish
Go to developer.apple.com, log in using your credentials, once in the iOS Provisioning Portal, click on the Provisioning tab and then Distribution. We are now going to create two profiles, one for reviewing your app and publications (Ad Hoc) and one for App Store (App Store). Click New Profile.
First we create the distribution profile for AppStore.
Distribution Method – Check App Store
Profile Name – Enter the name of your app, add AppStore in the end.
E.g. AppName AppStore
App ID - Select the App ID of the app you are creating the provisioning profile for.
Click Submit
Now we are going to create the distribution provisioning profile for AdHoc. But before we start, click the Devices tab. Here you can add devices that you wish to review your publications on. Add devices by clicking Add Device and then enter the iPads UDID and desired name of the device. See “1.5. Add test devices that can install your app on their iPad.” on page 2.
Go back to Provisioning > Distribution. Click New Profile.
Distribution Method – Check Ad Hoc
Profile Name – Enter the name of your app, add AdHoc in the end.
E.g. AppName AdHoc
App ID - Select the App ID of the app you are creating the provisioning profile for.
Devices (optional) – Select up to 100 devices for distributing the final application; the final application will run only on these selected devices.
Click Submit
Now click Certificates and then the Distribution tab. Now you should see your certificate with your distribution provisioning profiles that you just created listed.
Before you continue you have to have the WWDR intermediate certificate installed, you can download it using the link under your certificate.
After you have installed the WWDR intermediate certificate, download your Distribution Certificate.
Now open your Keychain Access application which is Apple’s password management system in Mac OS.
Select the Keys category.
Control-Click on the private key associated with your iOS Development Certificate and click Export Items in the menu. The private key is identified by the iOS Developer: <First Name> <Last Name> public certificate that is paired with it.
Save your key in the Personal Information Exchange (.p12) file format.
You will be asked to create a password but leave it blank and click OK.
Now you have created your .p12 file to upload to Publish