Up

Integration for Appcelerator

Download the latest version
Download V 1.0.0 RELEASED: September 19, 2014

REQUIREMENTS:

For iOS support: requires iOS 6.0 or later.

  1. How to integrate Ubertesters SDK to your Appcelerator project

    Use the download button above or download the SDK directly from the Appcelerator marketplace:

  2. Open your Titanium Studio and navigate to “Help” -> “Install Mobile Module”

  3. Browse the path to your downloaded module, select it and click “OK”

    You will be given three options to install the Ubertesters module to your Titanium Studio depending on your needs:

    • Global installation (Choose Titanium SDK) – the module will be available for all the projects.

    • Installation to current project – the module will be available for your project only.

    • Installation to the specified location – the module will be available for the project you’ve selected.

  4. Open “tiapp.xml”, select the tab “Overview” and click “+” (“Add module”)

  5. Find your module in the list, select it and click “OK”

  6. Open http://beta.ubertesters.com/projects and select your project, go to SDK Integration

  7. Copy “Ubertesters Project ID”

  8. In your Titanium Studio open the “tiapp.xml” file, select the tab “tiapp.xml” and add the required data: your Ubertesters project ID:

    <key>ubertesters_project_id</key>
    <string>type your ubertesters project ID here...</string>
  9. Open “app.js” file and initialize Ubertesters:

    • Default initialization:

      var ubertesters = require('ubertesters.sdk');
      ubertesters.initialize();
    • Initialization with Ubertesters SDK options. You can use one or more options:

      var ubertesters = require('ubertesters.sdk');
      ubertesters.initialize(["Option1", "Option2"]);

      See below the screenshot with an example and all available options in “Ubertesters SDK references”.

  10. Ubertesters SDK references

    Initialization:

    initialize(); Initializes your Ubertesters with default options (look “Ubertesters options” below).
    (void)initializeWithOptions: (var options) Accepts an array. Initializes your Ubertesters with given options.

    Ubertesters Options:

    UbertestersOptionsDefault Default option (UbertestersOptionsSlider and UbertestersOptionsLockingModeDisableUbertes tersIfBuildNotExist will be as default options).
    (void)initializeWithOptions: (var options) Ubertesters slider will appear and user can use it for manipulations with application.
    UbertestersOptionsShake Ubertesters slider will hide and developer have to call functions showUtPage(), hideUtPage() and takeScreenshot() for manipulations with application. Also all this functions can be called with other activation modes.
    UbertestersOptionsLockingModeDisable UbertestersIfBuildNotExist Ubertesters slider will hide and developer have to call functions showUtPage(), hideUtPage() and takeScreenshot() for manipulations with application. Also all this functions can be called with other activation modes.
    UbertestersOptionsLockingModeAppIfBuildNotExist Ubertesters locks app if build does not exist.

    Ubertesters API:

    logInfo (var message) Accepts string message. Sends log of “Info” type with given message.
    logWarn (var message) Accepts string message. Sends log of “Warning” type with given message.
    logError (var message) Accepts string message. Sends log of “Error” type with given message.
    takeScreenshot(); Captures current screen
    showUtPage(); Opens Ubertesters.
    hideUtPage(); Hides Ubertesters
    Examples of using the Ubertesters API can be found in the “app.js” file, which contained in the “Example” folder in our module.
Download the latest version
Download V 1.0.0 Released: September 19, 2014

REQUIREMENTS:

For Android support: Android 2.2 or later

  1. Use the download button above or download the SDK directly from the Appcelerator marketplace:

  2. Open your Titanium Studio and navigate to “Help” -> “Install Mobile Module”

  3. Browse the path to your downloaded module, select it and click “OK”

    You will be given three options to install the Ubertesters module to your Titanium Studio depending on your needs:

    • Global installation (Choose Titanium SDK) – the module will be available for all the projects.

    • Installation to current project – the module will be available for your project only.

    • Installation to the specified location – the module will be available for the project you’ve selected.

  4. Open “tiapp.xml”, select the tab “Overview” and click “+” (“Add module”)

  5. Find your module in the list, select it and click “OK”

  6. Open http://beta.ubertesters.com/projects and select your project, go to SDK Integration

  7. Copy “Ubertesters Project ID”

  8. In your Titanium Studio open the “tiapp.xml” file, select the tab “tiapp.xml” and add the required data: your Ubertesters project ID and permissions:

    <?xml version="1.0" encoding="utf-8"?>
        <manifest xmlns:android="http://schemas.android.com/apk/res/android"
                  package="your package"
                  android:versionCode="1"
                  android:versionName="1.0">
            ...
            <!-- Ubertesters library user-permisions -->
            <uses-permission android:name="android.permission.GET_TASKS" />
            <uses-permission
                android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
            <uses-permission
                android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
            <!-- Ubertesters library user-permisions --/>
            <application>
                <meta-data android:name="ubertesters_project_id"
        android:value="type your Ubertesters project ID here..."/>
            </application>
        </manifest>
  9. Open “app.js” file and initialize Ubertesters:

    • Default initialization:

      var ubertesters = require('ubertesters.sdk');
      ubertesters.setOfflineModeEnabled(true);
      ubertesters.setIsIgnored(false);
      ubertesters.initialize();
    • You can set the locking mode manually:

      //...
      ubertesters.initialize("Choose Ubertesters locking mode...");
    • Or set both locking mode and activation mode manually:

      //...
      ubertesters.initialize("Choose Ubertesters locking mode...", "Choose
      Ubertesters activation mode...");

    See the screenshot with an example and available locking modes below.

  10. Ubertesters SDK references

    Initialization:

    initialize(); Initializes your Ubertesters with default locking mode and activation mode
    initialize(var lockingMode) Initializes your Ubertesters with given locking mode. Accepts string value.
    initialize(var lockingMode, var activationMode) Initializes your Ubertesters with given locking mode and activation mode. Accepts string values.

    Locking mode:

    LockingModeDisableUbertestersIfBuildNotExist If you do not want the library to show a lock screen when the application is not found then use this option.
    LockingModeLockAppIfBuildNotExist If you want to show lock screen, when the application is not found then use this option

    Activation mode:

    Slider Ubertesters slider will appear and user can use it for manipulations with application.
    Shake Ubertesters slider will hide and user have to shake phone to open Ubertesters page.
    Manual Ubertesters slider will hide and developer have to call functions showUtPage(), hideUtPage() and takeScreenshot() for manipulations with application. Also all these functions can be called with other activation modes.

    Ubertesters API:

    logInfo (var message) Accepts string message. Sends log of “Info” type with given message.
    logWarn (var message) Accepts string message. Sends log of “Warning” type with given message.
    logError (var message) Accepts string message. Sends log of “Error” type with given message.
    takeScreenshot(); Captures current screen
    showUtPage(); Opens Ubertesters.
    hideUtPage(); Hides Ubertesters
    setIsIgnored(boolean isIgnored); Accepts boolean value. Allows sending information about user actions (touch, click, etc.).
    setOfflineModeEnabled(boolean isEnabled) Accepts boolean value. Allows working with application without connection to server.
    Examples of using the Ubertesters API can be found in the “app.js” file, which contained in the “Example” folder in our module.