Learning & Support


Build Settings overview

Twixl Support Team Updated: - Created :


    In order to get an overview of all available build settings, select "Builds Settings" from the Twixl Publisher menu.

    Build settings consist of a number of configuration options that determine the type of app that you will be creating, and which features will be enabled in the app.

    E.g. a build setting can contain the following info: which user interface languages are supported, the artwork (app icon, etc…), whether you are you using Google Analytics, code signing information (provisioning profiles), the app type (issue-based or article-based), etc.

    Once a build setting has been saved, creating an updated build of the app only requires a few mouse clicks. A build setting can also be exported so it can be used on another Mac (right-click the build setting name to see the options).

    1. General Settings
    1. General Settings

    This tab provides the following configurations options:

    User Interface Languages

    Select the language support you want for your application - this will make sure that all language strings for the selected languages are included in the app - the language options refer to the error messages that the app will be displaying e.g. when a user is offline, etc.

    App Store rating

    When this option is checked, you can prompt the user of the app to rate it on the store.

    2. Analytics

    Twixl Publisher allows you to integrate analytics in your publications.

    There is built-in support for analytics in the Twixl Distribution Platform (for issue-based and article-based apps). Absolutely zero-config!

    3. Artwork
    3. Artwork


    The app icon that will be displayed in the Home Screen of the device. Should be 1024x1024 pixels in size. You can select a different icon for iOS and Android.

    Startup Screens

    These screens will be displayed while the app is starting up. They need to have the following dimensions:

    • iPad Portrait: 1536 x 2008 pixels (according to Apple's guidelines, the 40 pixels of the status bar should be removed)
    • iPad Landscape: 2048 x 1496 pixels
    • Android Portrait: 800 x 1232 pixels (full screen less 48 pixels of the System bar)
    • Android Landscape: 1280 x 752 pixels
    • Phones: 640 x 960 pixels, 1242 x 2208 and 2208 x 1242 pixels
    4. User interface
    4. User interface

    Tool Bar

    The tool bar is the top bar that is displayed when you single-tap in a publication, and from where you can return to the store overview. In this pane you can modify the navigation bar background colorand the color of the Text and Icons in the tool bar.

    The tool bar background color is also used for the progress bars that are displayed when downloading a publication.

    Scroller Background

    You can also modify the scroller background color for Android devices, for the Web Reader export and for the iPhone 4(s).

    This color will be used if you are using a publication with a different aspect ratio than your device. The content will be “letterboxed” and the empty area will display the background color you defined. In most cases you will want this to default to black, but you can choose to use a publication background color that fits best with your content.

    5. Inactivity Timer
    5. Inactivity Timer

    Configuring a timer consists of two things:

    • set a timeout interval (in seconds)
    • define an action URL to be triggered on time-out

    By default the timeout interval in a build setting will be set to "0", i.e. disabled.

    The URL action to be triggered can use custom URL schemes for navigation in a Twixl publication. If you want to integrate a timer in a kiosk app, you can also use the URL:


    This will make sure the app returns to the store overview window after timeout.

    6. Sharing
    6. Sharing

    Under the "Sharing" tab, you can configure the default shared message for the different platforms. You can choose your own message and insert 3 different placeholders:

    • Application Name
    • Publication Name
    • Article Title

    You can select whether to add the App Icon or the Issue Cover to the message. You can also add a (short) URL that links to the store if you wish.

    Readers will be able to share via e-mail, Twitter, Facebook, etc.

    7. Code signing
    7. 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 create, 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.


    If you backup build settings, or copy a build setting to another location, the build setting will include the provisioning profile(s) you have added, but will not include the iOS Certificate and private key, as these are taken from the Keychain upon creating the build. If you want to backup the combination of Certificates, Private Keys and Build Settings, just select "Export Developer Identity…" from the Tools menu in the Twixl Publisher OS X app.

    Android Code Signing

    Android Application ID

    This should be a reverse DNS name like com.yourdomain.yourpublication - if you are going to be creating an app for both the iPad and Android, the best practice is to use the same one as the one you used for the iPad.

    Android Keystore

    Twixl Publisher normally takes care of creating the "keystore" for you in the background. If you are migrating your app from another platform, such as e.g. Adobe DPS, you will need to import your existing keystore.

    Check our separate article for more details.

    8. App Store Kiosk - Basic Settings
    8. App Store Kiosk - Basic Settings

    Twixl Distribution Platform Application Key

    Copy the application key from the app you created on the Twixl Distribution Platform platform and enter it here.

    Newsstand (pre-iOS 9)

    Enable the option "Newsstand" if you want your app to be in Newsstand. This is no longer relevant as of iOS9 though.

    Android License Key

    Navigate to Services and APIs for your app to copy the license key for your app

    Google Cloud Messaging ID

    required for sending push notifications - also see this article about the Google Cloud Messaging ID.

    9. App Store Kiosk - Entitlements
    9. App Store Kiosk - Entitlements

    Enable entitlements in your app build. This is configured in the build settings under “App Store Kiosk - Entitlements”. You will need to enter the following parameters:

    • Entitlements URL: you'll find this in the Entitlements configuration window on the Twixl Distribution Platform
    • Entitlements URL style: defines how the urls for the Entitlements Server are constructed. For more information, see Entitlements Server URLs.

    Entitlements optiuons

    • Require on startup: if enabled, you will need to be entitled before you can access the content in the app. In other words, this allows you to create a "restricted access" app.
    • Login Menu Title: if you want a button to appear in the sidebar menu of the App Store Kiosk that can trigger the entitlements signin form, you can enter the title for the button here, e.g. "Already a subscriber?".
    • Logout Menu Title: if you want the menu title to change when the user is logged in, you can enter a different title here.

    For more info about Entitlements, refer to our separate article.

    10. App Store Kiosk - User Interface
    10. App Store Kiosk - User Interface

    Here you can change the images that will be used to style the storefront.

    You can drag and drop images in the sizes specified for the store background.

    Using an info page or an info cell (banner) in your kiosk

    You can choose to display an info page that is triggered by a menu item in the sidebar menu of the kiosk. You need to create an HTML document called "infoPage.html" and add that to the WebResources folder. The title of the menu item can be entered here.

    You can also include a banner at the top of the store. You need to create an HTML document called "infoCell.html" and add that to the WebResources folder. The infoCell height can be different for landscape/portrait and for iPads, Android tablets and phones. On phones, the kiosk only supports portrait orientation.

    For detailed information about these options, refer to this article.

    Was this article helpful?

    0 out of 1 found this helpful