App Versions

An app version is the binary code that is uploaded to the store and then downloaded to the mobile / TV device. Each version has a unique version number that identifies it. To be able to use a version you'll need to build it first. When adding or removing plugins you'll need to rebuild the version for the changes to take affect. Once a version was released to the store you won't be able to rebuild that version. Instead you'll need to create a new version.

Create a new version

Click the New Version button and pick Create Blank.

info

If you would like to copy an existing version pick the From version option.

Fill out the New Version form

Set the app's version number - if it's your first version set it to 1.0.0. If not, set it with a higher number than your latest version.

Fill in your app's Bundle Identifier - make sure you follow the specific platform (e.g. iOS) guidelines.

note

If you are migrating from a different app provider, please keep the same bundle identifier. This will make sure that app updates and payment subscriptions continue to work.

Fill out the SDK version - Your customer success representative will guide you what version to use.

Check the Use QuickBrick checkbox and pick the latest available Quick Brick Version.

Set your app's URL Schemes - Type comma separated list of supported schemes for the app. Using those schemes you'll be able to target specific screens when sending push notifications or when indexing your app universal search.

Build Prerequisites

Before you build a version for debug / release make sure you completed the list of steps bellow:

  • Upload custom fonts - If your app is using custom fonts.
  • Upload relevant assets
  • Create a layout and activate it for the version you would like to build
  • Install and configure your installed plugins (Follow the specific plugin docs to see what configurations need to be done before build and what configurations can be changed at runtime)
note
  • If you want to build a store (release) version you'll need to make sure you add the relevant store info. see the Build section below for more info

Build mobile versions

Select debug or debug and release. Follow any guidance on plugin version warnings

Debug Dialog

iOS Release Dialog

See help text for more info and link to Apple's help center.

Android Release Dialog

See help text for more info and link to the Google Play help center.

Download Debug version to your device

When the build is complete select the download button for your app and choose the debug or store version

Download the apk / ipa file or use the QR code to load the app on a device

note

If this is the first time you are downloading an iOS debug version, you will need to approve Applicaster provision profile under your device general settings.

On Android, make sure you setup your phone to allow app downloads outside of the Google Play store. - Settings may very according your Android device.

Build TV versions

Select debug build or debug and release build. Follow any guidance on plugin version warnings.

Build Dialog Apple TV

See help text for more info and link to Apple's help center.

Build Dialog Android TV

See help text for more info and link to their help center.

Build Dialog Amazon Fire TV

See help text for more info and link to their help center.

Build Dialog Samsung TV

See help text for more info and link to their help center.

Build Dialog LG TV

See help text for more info and link to their help center.

Download app and side-load to your TV device

When the build is complete select the download button for your app and save the file to your PC.

Side Load to Apple TV

Use the Apple Configurator 2 app (Mac only) to side load your app. https://support.apple.com/en-gb/apple-configurator

Side Load to Android TV and Amazon Fire TV

You will need to install Android Studio and use the command line editor to transfer apps to these devices.

Then

  • adb install dragapkfilefrompchere

File transfer can take around 60secs and there is no progress visible until the transfer completes

If you get the error message $ADB_VENDOR_KEYS is not set;

  • try adb kill-server
  • then adb start-server
  • and try again

If that does not work then follow the procedure below:

  • On your PC go to this directory in Finder: ~/.android/adbkey/
  • Delete the 2 files adbkey and adbkey.pub
  • In terminal type adb kill-server then adb start-server
  • Then type adb connect IPddressofTVdevice
  • Look for the message on the Android TV device to accept the connection
  • Accept the connection and then in terminal type adb install dragapkfilehere

Side Load to LG TV

Download the WebOS development SDK to your PC and the Developer App to your TV. Follow these instructions https://webostv.developer.lge.com/develop/app-test

Side Load to Samsung TV

Method 1: Sign up to the Samsung Seller Office https://seller.samsungapps.com/tv/portal/main and then contact your local Samsung representative to get access to the USB memory-stick side load tool as an add-on within the seller portal

Method 2: Install the Tizen TV developer SDK. Follow these instructions https://developer.samsung.com/smarttv/develop/getting-started/setting-up-sdk/installing-tv-sdk.html and then install apps via the command line.

View Samsung and LG Apps In Your Browser

tip

For Samsung and LG TV apps only you can preview in your PC browser.

Select Open Web App via the Build Download button.

  • Move your mouse cursor out of the way of the screen or it will interfere with the content
  • Navigate the app using the arrow keys and enter
  • There is no back button in the browser (this is usually a hardware mapped button on the remote control so has no browser equivalent)