Login

Learning & Support

Documentation

Creating an issue-based app for iOS

Twixl Support Team Updated: - Created :

    Use the build settings wizard to go through the process step by step

    When creating an app build for the first time, a configuration wizard will walk you through the different steps and options of the build process. Once you saved that setting, you will be able to re-use it later for generating an update of that app.

    Below is an overview of the different steps involved for creating an issue-based iPad app.

    1. Choose a name for your setting

    Usually the build setting name will refer to the publication name.

    Choose a name for your setting
    2. App type

    Here you can select the type of app you wish to build:

    App Store Kiosk

    App Store Kiosk

    This will generate a kiosk app that will essentially be an empty shell.

    3. General Settings
    General Settings

    3.1. General

    Application name

    This is the name users will see on the home screen of the device.

    Build For

    Choose whether you want an app that supports Tablets, Phones, or both.

    3.2. UI Languages

    Here you can select the languages your app will support - alerts and error messages in your app will then be displayed in the system language specified on the device. 

    3.3. App Store Rating

    If you want to prompt the reader to rate your app on the app store, you need to check this option.

    4. Analytics

    For multi-issue apps, the Twixl Distribution Platform will gather an extensive list of analytics data for you automatically.

    5. Artwork
    Artwork

    5.1. App Icon

    The app icon that will be displayed in the Home Screen of the device. Should have a size of 1024x1024 pixels.

    5.2. Startup Screens for Tablets

    These screens will be displayed while the app is starting up (if you do not select any images, the default ones will be used). They need to have the following dimensions:

    • iOS Porttrait: 1536 x 2008 pixels (according to Apple's guidelines, the 40 pixels of the status bar should be removed)
    • iOS Landscape: 2048 x 1496 pixels

    5.3. Startup Screens for Phones

    These screens will be displayed while the app is starting up (if you do not select any images, the default ones will be used). They need to have the following dimensions:

    • Portrait (4:3): 640 x 960 pixels
    • Portrait (16:9): 1242 x 2208 pixels
    • Landscape (16:9): 2208 x 1242 px
    6. Code Signing
    Code Signing

    Code signing is a security measure to provide proof that you are indeed the publisher of an app.

    iOS Code Signing

    Apple uses a process called "provisioning" for code signing your apps.

    For more details about provisioning, please refer to the article Creating a provisioning profile.

    Depending on the type of build you want to generate, you may need to create and add different provisioning profiles. For an overview of the different types of iOS builds, please refer to this page.

    7. App Store Kiosk Settings

    Before you can enter the details below, you will first need to go through the process of adding an app in the Twixl Distribution Platform.

    Once you've done that, copy the application key for that app and enter it here.

    Select whether or not you want the app to be available in Apple's Newsstand. Note that checking this box also means you need to define a subscription.

    App Store Kiosk Settings
    8. Create build
    Create Build

    Your are now ready to create a build of your app, according to the settings you specified. Later on you can also check the "Advanced Settings" to adjust settings that are not part of the default wizard.

    9. Application options
    Application options

    When you create a build, you will get different options for your build, as shown below:

    Version

    Allows you to increment the version when you are updating your app

    Platforms

    iPad - make sure that you have at least one provisioning profile available in the build setting. For an overview of the different iPad app builds, check this article.

    Publication

    As a multi-issue app starts as an empty app, there is no need to select a publication.

    Options

    "Generate Over-the-Air install files": check the article iPad deployment for more info.

    10. Build process…
    Build process...

    The app will display information about the current build status.

    11. Build succesful!
    Build succesful!

    When the build process has completed, you will be able to navigate to the resulting file in the Finder.

    12. Resulting file
    Resulting file

    When you open the folder called "iPad" you'll find the app named according to the reverse DNS of your app id, and with an extension ".ipa".

    You are now ready to deploy your app in-house or to the App Store.

    Was this article helpful?

    0 out of 0 found this helpful