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.
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.
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)
- 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
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.
- Android Studio must be installed on your PC
- Download it here https://developer.android.com/studio/?gclid=EAIaIQobChMI_JyRspKC5AIVBLTtCh3r3gAIEAAYASAAEgIzSPD_BwE
- Run the install process
- Once installed open terminal on your PC
- Find the IP address of your Android TV or Amazon Fire TV device from the device menu
- Make sure the PC and TV device are on the same WiFi or wired network
- In terminal run the command
adb connect IPaddressofTVdevice
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
andadbkey.pub
- In terminal type
adb kill-server
thenadb 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
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)