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).
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.
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).
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.
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.
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
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.
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.
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.
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.
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.
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
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.
- 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.
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.