Up

Integration for Phonegap (Cordova)

Requirements

For iOS support: requires iOS 6.0 or later.

For Android support: requires android 4.0 or later.

Release notes
  • Updated iOS and Android frameworks
  • Updated the native frameworks
  • Added the ability to access the functions within the “window.ubertesters”
  1. Add Ubertesters plugin to your project

    • Run this command from your project folder to add plugin:

      cordova plugin add Ubertesters
  2. Integrate Ubertesters with your iOS project

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

    • Copy “Ubertesters organization token”

    • Navigate to your project folder, then /platforms/ios/<project_name>/ and open <project_name>-Info.plist

    • Add “Ubertesters Organization token” to your app’s “Info.plist” with key “ubertesters_organization_token”

  3. Integrate Ubertesters with your Android project

    • Navigate to your project folder, then /platforms/android/ and open AndroidManifest.xml

    • Add permissions into tag

      <?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 --/>
      
                ...
              </manifest>
    • Open http://beta.ubertesters.com/projects and select your project, go to SDK Integration

    • Copy “Ubertesters Organization token”

    • Add “Ubertesters Organization token” to project manifest file into <application> tag

      <application>
      
          ...
      
          <meta-data android:name="ubertesters_organization_token" android:value="your organization token"/>
      
          ...
      
      </application>
  4. Ubertesters interface integration

    1. In your project catalog copy \plugins\com.ubertesters.sdk\www\ubertesters.js to \www\js\

    2. Edit \www\index.html in your project folder and add the following line to <body>:

      <script type="text/javascript" src="js/ubertesters.js"></script>
  5. Use Ubertesters Initialize function

    • Please, create your own Application class (or use existing) and add into onCreate:

      @Override
      public void onCreate() {
        super.onCreate();
            Ubertesters.initialize(this);
            ... 
      }
    • To specify locking or activation methods use initialization parameters as show below:

      ubertesters.initialize(null, null, [<LOCKING_MODE>, <ACTIVATION_MODE>]);

      Locking modes:

      DisableUbertesters This option will not lock your application if the build is not uploaded on our server, but the Ubertesters SDK will be disabled.
      LockApplication Ubertesters SDK locks the app completely if the build is not located on our server, it is impossible to navigate through the app

      Activation modes:

      Widget The Ubertesters widget (an orange bubble) is shown, and you need to click on it to call a bug submission screen.
      Shake The widget is not shown, you need to shake your phone to call a menu for a bug submission or take a screenshot.
      Manual The Ubertesters widget is not shown, a menu should be called with the help of our API methods. You can specify the conditions under which the Ubertesters menu will be shown.
      Additional Ubertesters functions can be found in \plugins\com.ubertesters.sdk\www\ubertesters.js