Skip to content
TestyDroid is a small command line tool, to handle running your unit tests on an android device during CI builds.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitignore
LICENSE
README.md

README.md

TestyDroid

TestyDroid makes automating your android tests (Xamarin Tests App) on an android device really easy.

Getting Started

See here: https://github.com/dazinator/Xamarin.TestyDroid/wiki/Getting-Started

What does it do?

TestyDroid handles all of the following for you:

  1. Starting the android emulator. (Or can use an existing instance)
  2. Loading the desired AVD and detecting when it has successfully booted.
  3. Installing the APK package containing your tests
  4. Launching your tests and collating the report.
  5. Ensuring the emulator is terminated appropriately afterwards.

Test Results are written to STDOUT (console out) by default, however there is the option to specify TeamCity as the reporter, in which case test results will be reported in Team City format and so will appear in the Team City user interface if invoked during a Team City build.

Open to supporting other build systems via custom Reporters.

Usage

After adding the Xamarin.TestyDroid NuGet package to your Android Tests App project, you can find TestyDroid.exe in the NuGet packages tools directory.

Call Xamarin.TestyDroid.exe from the command line, with the following arguments:


  -r, --reporter-type               (Default: None) The type of reporter used
                                    to report progress. Specify teamcity if you
                                    would like to see progress in TeamCity
                                    builds.

  -t, --emulatortype                (Default: sdk) The type of emulator to run
                                    the tests on. In future may support
                                    Microsoft's Emulator.

  -e, --emulatorexepath             Required. The full path to the emulator
                                    exe.

  -d, --debugbridgepath             Required. The full path to android debug
                                    bridge (adb.exe)

  -f, --apkfile                     Required. The full path to the APK file
                                    containing your tests that should be run.

  -i, --imagename                   Required. The name of the avd image to
                                    launch in the emulator.

  -n, --name                        Required. The package name of your APK
                                    package as per it's manifest.

  -c, --instrumentationclasspath    Required. The class path to the
                                    instrumentation class inside your tests
                                    APK. This should include the namespace (in
                                    lower case) and then the class name (case
                                    sensitive). E.g
                                    xamarin.testydroid.testtests.TestInstrumentation

  -w, --emulatorwaittime            (Default: 120) The maximum number of
                                    seconds to wait for the emulator to start
                                    up before timing out.

  -v, --verbose                     Enable verbose output to the console during
                                    execution.

  -p, --portnumber                  (Default: 5554) The port number that the
                                    android console will be listening on, on
                                    localhost.
                                    
  -s, --single-instance-mode        (Default: Abort) Controls what happens if there is 
                                    an existing device detected already running on
                                    the same console port. Options are: Abort,
                                    KillExisting, ReuseExisting and ReuseExistingThenKill

  --help                            Display this help screen.

Example TestyDroid.exe usage:

Xamarin.TestyDroid.exe -e "C:\Program Files (x86)\Android\android-sdk\tools\emulator.exe" -d "C:\Program Files (x86)\Android\android-sdk\platform-tools\adb.exe" -f "C:\Users\Darrell\Repo\Xamarin.TestyDroid\src\Xamarin.TestyDroid.TestTests\bin\Release\Xamarin.TestyDroid.TestTests-Signed.apk" -i "AVD_GalaxyNexus_ToolsForApacheCordova" -n "xamarin.testydroid.testtests" -c "xamarin.testydroid.testtests.TestInstrumentation" -w 120 -v

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.