Skip to main content

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​

In order to test LG app you will need:

  • CLI (Command-Line Interface) of WebOS. Follow the procedure from LG Developer website to download and install CLI on your computer.

  • Memebr ID of the LG Developer site. If you are not a member yet, you can create an account here.

  • Developer Mode App installed on your LG device. Here's the link where you can find the info on how to do it.

Connecting TV with PC​

Before you begin, ensure that your TV is turned on and that you have launched the Developers Mode App. You'll need to refer to this app to obtain certain information and use it to establish a connection.

To connect your computer with the TV, open webOS TV CLI terminal on your computer and execute command ares-setup-device. Then follow the steps below:

After adding your TV as a target device, type in the command in CLI ares-setup-device -list. It will show that the device is connected and registered.

On your TV open the Developer Mode App and click the Key Server button in the Developer Mode app.

Get the key file from your webOS TV with the following command on your PC:

ares-novacom --device LGTV --getkey

A command prompt will appear to enter Passphrase. Enter the exact characters (case sensitive) as displayed on your TV screen.

Check the connection with your TV and PC with the following command:

ares-install --device LGTV --list

Installing the app on the TV device​

Download IPK file from zapp and use command ares-install -d in CLI to upload the app to the TV. Copy the path to the version on your PC and add it to the command ares-install -d. It should look like this:

ares-install -d LG /users/yourusername/downloads/com.apptheapp_3.0.3-build.35.ipk

Once the app is installed you will see it in the the MY APPS bar at the bottom of the home screen.

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)