1 I. Before Publishing 1. System requirements Requirements for ios App publishing using FlyingCatBuilder Mac running OS X version or later Apple Development Account Enrollment in ios Developer Program Xcode 6.1 or later 2. Graphic assets to prepare To publish ios Apps, these graphic assets are needed: App Icon and Launch Image for packaging process 1. iphone Icons: 1024x1024, 512x512, 180x180, 120x120, 114x114, 80x80, 60x60, 58x58, 57x57, 40x40, 29x29 Launch Images: 320x480, 640x960, 640x ipad Icons: 1024x1024, 512x512, 152x152, 144x144, 100x100, 80x80, 76x76, 72x72, 58x58, 50x50, 40x40, 29x29 Launch Images: portrait(768x1024, 1536x2048), landscape(1024x768, 2048x1536) 3. Universal You need for both iphone and ipad. All assets must be in PNG format, No Transparent. App Icon and Screenshots for App Store ( At least one Large App Icon and one Screenshot are needed. 5 maximum screenshots per each device.) Large App Icon (1024 x 1024) 3.5 inch Retina Display Screenshots (960x640, 960x600, 640x960 or 640x920) 4 inch Retina Display Screenshots (1136x640, 1136x600, 640x1136 or 640x1096) 4.7 inch Retina Display Screenshots(1334x750, 1334x710, 750x1334 or 710x1334) 5.5 inch Retina Display Screenshots(2208x1242, 2208x1202, 1242x2208 or 1202x2208)
2 ipad Screenshots (1024x768, 1024x748, 768x1024, 768x1004, 2048x1536, 2048x1496, 1536x2048 or 1536x2008) App icons and Screenshots must be in.jpeg,.jpg,.tif,.tiff, or.png formats and at least 72 DPI and in RGB color space. For more detailed information please read ios Human Interface Guidelines: Icon and Image Sizes. II. Seting up publishing environments 1. Install Xcode FlyingCatBuilder internally uses Xcode to package MGL files and convert them to IPA. This substitutes you having to develop the app yourself. Installing Xcode is necessary for this process. You can simply download and install latest version of Xcode from the Mac App Store or this link : https://developer.apple.com/xcode/index.php. After installing, you need to run Xcode one more time to download the required assets. 2. Installing the Distribution Certificate To package and distribute your app, you need to get a Distribution Certificate from Apple and install it on your Mac. Distribution certificates verify that you have purchased and Apple Developer Account and that the Mac is belongs to you. Only one computer can be registered per account so we recommend using only one mac for the whole publishing process. Follow the steps below to get your certificate: Go to ios Provisioning Portal 1. Connect to ios Dev Center - ios Developer Program - Certificates, Identifiers & Profiles. https://developer.apple.com/account/overview.action 2. Go to Certificate inside ios App section. 3. If you re new and can t see any certificate. click + button right side of title. 4. Select App Store and Ad Hoc below Distribution and click continue. 5. You can see a description of what Certificate Signing Request(CSR) is and how to create it. Read and click continue. 6. Now you need to upload Certificate Signing Request (CSR). Keep your browser window open. Generating a Certificate Signing Request(CSR) in your Keychain Access 1. To generate a Certificate Signing Request you need to manually Open Keychain Access on your Mac (located in Applications/Utilities). 2. Choose Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority. 3. Enter your user address and common name. You must use the same address as you used to register in the ios Developer Program. if you type in different address it s not going to be created properly. No CA Address is required. 4. Select the options Saved to disk and click Continue. 5. Certificate Signing Request Saved. let move next. Submitting a Certificate Signing Request for Approval
3 1. Re-open browser window which we used prior in the process. If you closed the browser window, follow Go to ios Provisioning Portal once again. 2. Choose your CSR file, and click Generate. Downloading and Installing Distribution Certificates 1. After couple of seconds, certificate will be ready to download. Download it. 2. In the Finder, run downloaded.cer file. It will open Keychain Access and install your certificate in your default keychain (usually the login keychain). 3. If you can see certificate iphone Distribution: your name with your private key. (You can see pared private key by click arrow left to small certificate icon.) Now you and your Mac has valid identity to distribute app. for more information about distribution certificate, please read Maintaining Your Signing Identities and Certificates 3. Register Device to Developer Account To preview and test your book app with icon and splash screen before final upload, your test device is needed to register your developer account. You can register 100 test devices for one account. Here s step how to add your test device. Find your Device s Device ID (UDID) by itunes 1. Connect device to Mac and open itunes. 2. Find Serial Number in Device Summary 3. Click Serial Number, it will be changed to device ID 4. In latest version of itunes you can easily copy Device ID using right click. Or find your Device s Device ID (UDID) by Xcode 1. Connect devuce to Mac and opent Xcode 2. Go to Top menu - Window - Organizer 3. Click your device on left sidebar 4. Copy Identifier of your device. Add a Device ID to Your Developer Account 1. After logging in to the ios Provisioning Portal, click Devices in the sidebar. 2. Click Add Devices. 3. Enter a device name (whatever you want) and the device ID. 4. Click Submit. III. Package ios App in FlyingCatBuilder 1. Understanding Package Process in FlyingCatBuilder Show Concept drawing. 2. Before start package process
4 If you follow well above instructions, you already have all conditions. To prevent unexpected fail, please check one more time you satisfy all conditions before start. If you don t understand what it is, please read below parts and prepare assets again. your mgl file Apple Development Account with paid ios Developer Program Xcode Installed Distribution Certificate in Keychain Access Graphic assets for package process 3. Create a App ID for your App Every single app in app store has their own App ID for divide each other. It s one Unique ID throughout all apps in app store and Provisioning Portal. To distribute your app through App Store, you need to create your App s Identity and put ID into Distribution Provisioning Profile. which will be mentioned next part. Create App ID 1. Connect to ios Dev Center - ios Developer Program - Certificates, Identifiers & Profiles. https://developer.apple.com/account/overview.action 2. Go to Identifiers inside ios App section. 3. If you re new, can not see any App ID. click + button right side of title. 4. Fill App ID Description. Enter a common name or description of your App ID using alphanumeric characters. You cannot use special characters &, *, " in your description. 5. Use Default value in App Services and App Id Prefix. 6. In App ID Suffix, select Explicit App ID and Enter a unique identifier for your App ID. The recommended practice is to use a reverse-domain name style string for the Bundle Identifier portion of the App ID. Example: com.domainname.appname 4. Create a Distribution Provisioning Profile What is the Distribution provisioning profile? It s kind of identity card for each app. it include all information like who owns this app, what app ID included, and which device can be installed etc. So To pa App Store or Ad Hoc? There are two types of Provisioning profile type. App Store and Ad Hoc. App Store profile only can use for App Store upload. Ad Hoc Profile for test your app on actual device. So At first time, create a provisioning profile as Ad Hoc for test purpose. After all tests finished, create a profile as App Store again. and use that for upload to App Store. Create a Profile 1. Connect to ios Dev Center - ios Developer Program - Certificates, Identifiers & Profiles. https://developer.apple.com/account/overview.action 2. Go to Provisioning Profile inside ios App section. 3. If you re new, can not see any profiles. click + button right side of title. 4. Select Distribution method and click continue. If It s a first time to package, then we recommend to package using Ad Hoc Provisioning Profile.
5 5. Select App ID for your book. 6. Select Distribution Certificate 7. If you selected Ad Hoc as distribution method, select devices which you want to install. 8. Enter profile name. and click generate. 9. Download created profile. 5. Start Package Process Now it s time to start real package process on FlyingCatBuilder! Click publish icon on top or Select Menu > File > Publish. Once again check all things be prepared or not using check boxes on left side of FlyingCat Publish wizard. 6. Select MGL and Platform First, Select MGL file which you want to publish. After that, select platform which you want to publish. This guide is for ios Publishing select ios. If you want to read Android Publishing, please read Android Publish Process. 7. Fill App Information
6 Now it s time to start real package process on FlyingCatBuilder! You need to fill some information to show your book information to device. Title Name of your app is going to be shown on device. There s no limitation about naming, but if you type too many characters. It will be dotted by device. Tip: Here s simple way to check your title is will be dotted or not. on your device, make a app group and set a name as what you want. Target Devices If you want to package your book for ipad select ipad. or if you want to package for iphone or ipod Touch select iphone. and if you want to package for ipad, select ipad. Currently FlyingCatBuilder doesn t support universal app. Orientation Select your book s orientation. if your book is portrait book, select portrait. else, select landscape. Language
7 Select major language of your book. Version Number Set the version number of the book. If it is a first version of the book, leave them If not please read update a book section. Version Code Set the version code of the book. It s almost same as version number. If it is a first version of the book, leave them If not please read update a book section. Distribution Certificate Select valid Identity. If you can t see any selection, please read get certificate chapter in setup publish environment and restart process from there. Distribution Provisioning Profile Import Profile you create from Provisioning Portal. Save Location Set packaged file name and location. Scale Type Set scale type of your book. Currently FlyingCatBuilder has fixed canvas ratio which optimized for ipad aspect ratio. So If you package app for ipad, you don t need to care about scale type, because every type will be shown perfectly. But for the case of iphone and Android, you need to set specific scale type for ration adjustment. CenterCrop : Fit width to device width, and crop rest of top and bottom area. in portrait book, it fitted to opposite way. CenterInside : Fit height to device height, and show letterbox of rest of area. in portrait book, it fitted to opposite way. Stretch : Fit canvas width and height to device width and height. it ignore canvas width and height ratio. Known Issue : Since iphone 5 launched, There s a problem iphone guideline doesn t work properly on iphone 5 because of different ratio. 7. Add Graphic Assets App Icon is showed on device when you install app to device. Launch Image will be showed when start running application on ios Devices. Depends on Target device and orientation, App require different kinds of graphic assets. Launch Image
8 ipad Landscape : Add Launch Image for normal display (1024x768) and retina display(2048x1536). ipad Portrait : Add : Add Launch Image for normal display (768x1024) and retina display(1536x2048). iphone : iphone Launch Image doesn t require landscape Launch Image. Because iphone home screen always work on portrait mode. so regardless of orientation, always add Launch Image for normal display (320x480), retina display(640x960) and retina display for iphone 5 (640x1136). App Icons
9 App Icon does not interfere with the orientation of books, but there are lots of different sizes for different purpose. Fortunately, some icons are optional. So you don t need to fill all assets. It depends on you. itunesartwork : This icon is showed on itunes. normal size(512x512) and retina size(1024x1024) are required. Home Icon : This icon is showed on home screen of device. Icon size is different based on iphone and ipad. Case of iphone, 57x57 for normal display, 114x114 for retina display needed. and case of ipad 72x72 for normal display, 144x144 for retina display needed. Small Icon(optional) : This icon is showed on setting app or spotlight search. you can add 29x29 for normal display, 58x58 for retina display. Spotlight Search Icon for ipad(optional) : ipad has different size of spotlight search icon. You can add 50x50 for normal display, 100x100 for retina display.
10 8. Fail in package process? If you follow prior process properly, you can see packaged IPA file. But, as you know it is long and complicate process. here s frequently experienced fail case. and Known Issues. CodeSign Verification Fail Wait. Did you install Xcode and running Xcode at once? Even you download Xcode, you need to run Xcode at least once let Xcode download their assets itself. Congratulations Message doesn t appear. It is known issue. if networking is unstable it appeared from time to time. don t worry too much, if packaged file is in the folder, Then app is packaged well. IV. Test before upload 1. Add IPA on itunes There s IPA you just published, Now let s test your IPA file on Actual Device. It s really easy, find IPA file in Finder, Drag and drop to itunes. itunes automatically add you IPA file to their app list. If your IPA file published by App Store Distribution
11 Provisioning Profile, It cannot be tested and cannot installed any device except upload to App Store. 2. Sync and install App Now Connect your ipad or iphone to itunes, go to Apps tab in you device. you can find you App in left side list. drag your app to screen. and click apply. then your app will be installed. 3. Failed to Install? It means something wrong in your IPA file. usually codesign verification fail. you need to check your Certificate is correctly installed your keychain or your provisioning profile is valid. Wrong Certificate. To generate a Certificate Signing Request manually Open Keychain Access on your Mac (located in Applications/Utilities). No private key in Distribution Certificate. To generate a Certificate Signing Request manually Open Keychain Access on your Mac (located in Applications/Utilities) Invalid Provisioning Profile. To generate a Certificate Signing Request manually Open Keychain Access on your Mac (located in Applications/Utilities). 4. I ve just finished test my app Repeat test as many as possible. It s always good for your book. If you finish all test and satisfied with app. Package one more time using App Store Distribution provisioning profile and move to next chapter. V. Upload to App Store 1. Add New App Before an app can be distributed, you must have a valid distribution certificate linked to a distribution provisioning profile. Distribution certificate verify you are purchased user and your Mac is belongs to you. So it s necessary to package your book. Here s step how to get certificate. Create a new app in Apple App Store
12 To generate a Certificate Signing Request manually Open Keychain Access on your Mac (located in Applications/Utilities). 1. Log in to itunes Connect and go to Manage Your Applications 2. Click Add New App 3. Basic App Information o o o o Default Language : The primary language you will be using to enter app details for display on the App Store App Name : The name of your app as it will appear on the App Store. Note that this name cannot be longer than 255 bytes. SKU Number : A unique ID for your app. You can use letters, numbers, hyphens, periods, and underscores. The SKU cannot start with a hyphen, period, or underscore. Bundle ID : An identifier used by ios and Mac OS X to recognize any future updates to your app. Your Bundle ID must be registered with Apple and unique to your app. Bundle IDs are app-type specific (either ios or Mac OS X). The same Bundle ID cannot be used for both ios and Mac OS X apps. 4. Set Availability Date, Price, and Country you want sell it 5. Detail App Information o Version : The version number of the app you are adding. Numbering should follow typical software versioning conventions (for example, 1.0 or or 1.1). o Copyright : The name of the person or entity that owns the exclusive rights to the app, preceded by the year the rights were obtained (for example, "2008 Acme Inc."). o Category : Select Category of your book. usually book can be selected. o Rating : select ratings. o Description : add description about your book. o Keywords : add search keyword for your book. o Support URL : add your website o App Review Information : add contact information for review. o Large App Icon : add large app icon for app store. o Screenshots : add app s screenshots at least one to max If you finished to fill every single information, now it s ready to receive your IPA file. 2. Upload IPA(Binary) to AppStore After Create a slot for your app. Now It s time to upload your actual binary file(ipa you create via FlyingCatBuilder) Change App Status Ready for Upload Binary Go to itunes Connecl https://itunesconnect.apple.com Move to Manage Your Apps and select app which you want to upload IPA Click View Details button Click Ready to upload Binary Upload Ipa file via Application Loader Run Xcode on Menu, Click Xcode > Open Developer Tool > Application Loader Log in via your developer account Click Delivery Your App Choose Application which you change status below. Choose IPA file you packaged Click send button Common Fail Case Bundle ID doesn t match : When App ID in Distribution Provisioning Profile and Bundle ID doesn t match it happened. Check profile s App ID. Failed Codesign
13 Verification : When Distribution Certificate not installed properly it happened. Open Keychain Access and check certificate is properly installed. 3. Tips for Apple s Review After successfully send your app, all you can do is just wait apple s approval. Apple s review takes some time.(usually from 1 week to 1 month) after Apple s approval, you can officially sell your app on App Store. Apple has their own review guidelines, and can reject app when over the guidelines. Here are some tips for your book. Create your book interactive Simple scanned flip books, slideshows and no interaction books can be rejected. Please add lots of actions and animations in your book. Test your app enough Test app enough before upload. If there is a version difference between FlyingCatViewer, some actions may work differently and cause unexpected error, and it can be considered as bug by Apple and be rejected. Inform correct information If you fill fake information and there is a difference between your app and book information, then it can be rejected by Apple. VI. Update a book 1. Packaging app for update In order to update a book you need to use the same.mgl file that you originally used to upload the book. When you first upload a book FlyingCatBuilder stores the publishing data, so using another.mgl file won t work. You can update a book for free for the first three months after your initial publishing date. Update version packaging is much simple than the original packaging since all graphic assets and provisioning profiles are reusable. Only thing you need to change for updating is Version Number and Version Code ; both must be higher than prior version. ( for example, if your first version number and code are and 1000, next version can be and 1010 or 1001) Go back to Step 5 Start Packaging Process of section III Packaging ios App in FlyingCatBuilder and follow the exact same instructions. 2. Uploading updateded IPA(Binary) to AppStore Since you already made a slot for you app you don t need to fill in app information again. Find your current app and follow the steps below.
14 Adding new version and changing App Status to Ready for Upload Binary 1. Go to itunes Connect https://itunesconnect.apple.com 2. Move to Manage Your Apps and select the app for which you want to upload IPA 3. Click Add Version button 4. Enter version number and a brief explanation of what is new in this version 5. Click Ready to Upload Binary Button on the top right corner 6. About encryption question say No, about legal issue it s up to you. 7. Select option release update app right away or not. Uploading IPA file via Application Loader 1. Run Xcode 2. Menu -->Click Xcode > Open Developer Tool > Application Loader 3. Log in via your developer account 4. Click Deliver Your App 5. Choose Application for which youwant to change status below. 6. Choose IPA file you packaged 7. Click send button After your app has finished uploading, apple will prepare to review your app. The review system is exactly the same as your first release. If you change a large part of your contents, we recommend you check your app information once again since it may be a reason for rejection. Please check the link below for the latest updates on App upload and distributions. App Distribution Guide: About App Distribution