We’re here to help

Build Settings overview

Follow

TIP:

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

2. Analytics

Twixl Publisher allows you to integrate analytics in your publications.

One the one hand, there is built-in support for analytics in the Twixl Distribution Platform (for kiosk apps only).

On the other hand, it is possible to integrate third party analytics: Google Analytics (both single and multi-issue apps) and Localytics (multi-issue apps only).

You can either use the same key for iOS, Android and the Web Reader, or you can define separate keys for each.

For Localytics, which allows you to send messages to a subset of your readers, you can enter the keys for iOS and Android.You need to create account with the provider of your choice first.

The following information will be tracked:

  • Every page viewed
  • Slide shows: every state of a slide show (not for autoplay)
  • Movies: all movies without autoplay
  • Sounds: all sounds without autoplay
  • Web Overlays: all overlays that are displayed
  • Web links: all links that are opened

To make your analytics more readable, the Twixl Publisher plug-in allows you to provide your own analytics name to certain interactive objects, such as for slide shows, audio, video, and web overlays.

3. Artwork

3. Artwork

Icon

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:

tp-store://show

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.

IMPORTANT NOTE:

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 0 found this helpful