Liquid UI - WS Reference Library

3.2 Installation


The Liquid UI client application for Android is available either directly through Synactive, or from the Google Play Store. To acquire the client from Synactive, please email Synactive Sales at rfi@guixt.com. To install Liquid UI from the Google Play Store, please follow the directions in the Installing Liquid UI from the Google Play Store section. To install the client manually, please follow the instructions in the Installing Liquid UI Manually section below

Installing Liquid UI from the Google Play Store

  1. On your Android device, locate the Play Store icon.

  2. Open the Play Store by tapping on the icon. Then tap the Search icon in the upper right corner.

  3. Type in 'Liquid UI' and press 'Done' on your keyboard.

  4. The Liquid UI app will be returned in the Search results screen. Tap on the app to begin the download.

Installing Liquid UI Manually

To manually install the Liquid UI Android client, you will need to first obtain the APK file from Synactive, and then push it to your device. Please note that you will need to have both the Android Software Development Kit (SDK) and the Android Debug Bridge (ADB) package in order to manually install Liquid UI on your Android device. The instructions for manually installing Liquid UI are as follows.

  1. First, install the Android SDK. You can find detailed instructions for installing the SDK on the Google Android developer website. You will need the Java runtime environment (JRE) and developer kit (JDK) as well. You can find these at the Oracle Java SE Downloads website.

    Note: Make sure you install the 32-bit (x86) version of the Android SDK, even if your system is 64-bit.
  2. Install the ADB package. It should be included as part of the Android Developer Toolkit in the <sdk>/platform-tools/ directory.

  3. You must now activate the developer tools on your device. These are not active by default, but in order to manually install apps, we will need to enable them. To do this, go to your Android device, and locate the build number. This is typically found in the 'About Tablet' option in the System settings. Tap this number until you see a message stating that the Developer Tools are enabled.

  4. You will now see a new option in the System Tools called 'Developer options'. Tap this option and enable the 'USB debugging' and the 'Verify apps over USB' options.

  5. Now open up a command prompt and type in the path to your SDK directory. By default the path should look similar to the following example.

    C:\Users\<yourname>\AppData\Local\Android\android-sdk\platform-tools
  6. Connect your Android device via its USB cable and then type the following command.

    adb devices

    This should result in a list of all the attached devices. Each device will be displayed as a long number, followed by the word 'device' as in the following example.

    015d21098658181a		device
  7. If your device does not appear, you will probably need to download the device drivers. They may be in the 'Extras' section of the SDK, or you may have to download them from the device manufacturer's website. Once you have downloaded the correct drivers, go to the Device Manager on your system, right-click on the device, and open the Properties dialog.

  8. Go to the Drivers tab, and click the Update Driver button. Then navigate to the folder where your drivers are located and install them as you would any other drivers.

  9. After installing the drivers, retry the 'adb devices' command in your command prompt. Your device should be listed and you can now use ADB to install apps.

  10. Now we need to install the Liquid UI app on the device. In the command prompt, type the following command.

    adb install <path>\<filename>.apk

    In our example, the path is as follows,

    C:\Android_APKs\guixt_1.0.1.0.apk
  11. Wait for the install to succeed - you will see a success or failure message in your command prompt.

  12. The Liquid UI application should now be installed on your device. Open the device and go to the list of applications to verify that it is installed and ready to use.