com.jayway.android.robotium.remotecontrol.solo

Class SoloTestAndroidApi

java.lang.Object

com.jayway.android.robotium.remotecontrol.solo.SoloTest

com.jayway.android.robotium.remotecontrol.solo.SoloTestAndroidApi

public class SoloTestAndroidApi
extends SoloTest

This is used to test Remote Solo Implementation.
You see link Remote Solo for methods to test.
We use the sample application ApiDemos provided by Android

Due to the resolution problem, to make the test run smoothly on different
device, you need to modify the AndroidManifest.xml of ApiDemos
application by adding the following line.

After the modification, you need to rebuild it.

This test requires you set you device's "language setting" to "English"

Author:

Lei Wang, SAS Institute, Inc.
May 17, 2013 (Lei Wang) Move some codes to SoloTest

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_AUT_APK

Fields inherited from class com.jayway.android.robotium.remotecontrol.solo.SoloTest

ARG_KEY_AUT_APK, ARG_KEY_AVD, ARG_KEY_INSTRUMENT_ARG, ARG_KEY_MESSENGER_APK, ARG_KEY_NO_AUT, ARG_KEY_NO_MESSENGER, ARG_KEY_NO_RUNNER, ARG_KEY_PERSIST_AVD, ARG_KEY_REMOVE_INSTALLED_APK, ARG_KEY_RESIGN_JAR, ARG_KEY_TESTRUNNER_APK, ARG_KEY_TESTRUNNER_SOURCE, argAUTpassed, argINSTRUMENTpassed, argMESSENGERpassed, argRESIGNJARpassed, argRUNNERpassed, argRUNNERSOURCEpassed, avdSerialNo, debugEnabled, DEFAULT_INSTRUMENT_ARG, DEFAULT_MESSENGER_APK, DEFAULT_TESTRUNNER_APK, DEFAULT_TESTRUNNER_SOURCE_DIR, log, mainActivityUID, persistEmulators, removeinstalledapk, robotiumTimeout, robotiumUtils, solo, unlockEmulatorScreen, weLaunchedEmulator

Constructor Summary

Constructors

Constructor and Description
SoloTestAndroidApi()
SoloTestAndroidApi(java.lang.String[] args)
SoloTestAndroidApi(java.lang.String messengerApk, java.lang.String testRunnerApk, java.lang.String instrumentArg)

Method Summary

Modifier and Type	Method and Description
void	fail(java.lang.String message) Before you call this method, you MUST execute a command by solo. Otherwise, you will NOT get the correct result information. If you just want to print message, call super#fail(String) instead.
(package private) void	gotoCustomTitleActivity() "App -> Activity -> Custom Title" is the path to 'Custom Title Activity'.
(package private) void	gotoDateTimePicker() "Views -> Date Widgets -> 1.
(package private) void	gotoDefaultThemeActivity() "Views -> Controls -> Default Theme" is the path to 'DefaultTheme Activity'.
(package private) void	gotoDialogActivity() "App -> Dialog " is the path to 'Dialog Activity'.
(package private) void	gotoIconGrid() "Views -> Grid -> 1.
(package private) void	gotoInflateMenu() "App -> Menu -> Inflate from XML" is the path to 'MenuInflateFromXml Activity'.
(package private) void	gotoPhotoGallery() "Views -> Gallery -> 1.
(package private) void	gotoViewsList() "Views" is the path to 'Views List'.
static void	main(java.lang.String[] args)
(package private) void	showRemoteResult() Before you call this method, you MUST execute a command by solo. Otherwise, you will NOT get the correct result information. When you want to know the remote result info, call this method. Normally, when you fail, you want to know the reason, you can call this.
protected void	test() Use solo to test Android ApiDemos Test methods as: Solo.finishOpenedActivities() Solo.getCurrentActivity() Solo.waitForActivity(String) Solo.assertMemoryNotLow() Solo.getAllOpenActivities() Solo.setActivityOrientation(int) Solo.getActivityMonitor() The other Robotium-RC methods will be tested in the following methods: They are independent from one to other, so you can comment any them during the regression test.
protected void	testRelateToApplication(java.lang.String editTextIdToVerify) Solo.getString(String) Solo.getView(int) The test depends on the application itself.
(package private) void	verifyAssertActivityMethods(java.lang.String activityClass, java.lang.String activityName) Verify following methods: Solo.assertCurrentActivityClass(String, String) Solo.assertCurrentActivityClass(String, String, boolean) Solo.assertCurrentActivityName(String, String) Solo.assertCurrentActivityName(String, String, boolean)
(package private) void	verifyGetViewByIdMethods(int RID, boolean positiveTest) Tested methods: Solo.getView(int)
(package private) void	verifyWaitActivityMethods(java.lang.String activityName, boolean positiveTest) Verify following methods: Solo.waitForActivity(String) Solo.waitForActivity(String, int)
(package private) void	verifyWaitForViewUIDMethods(java.lang.String viewUID, boolean positiveTest) Tested methods: Solo.waitForViewUID(String) Solo.waitForViewUID(String, int, boolean)

Methods inherited from class com.jayway.android.robotium.remotecontrol.solo.SoloTest

debug, error, getAUTApk, getInstrumentArg, getLogsInterface, getMessengerApk, getResignJar, getTestRunnerApk, getTestRunnerSourceDir, goBackToViewUID, info, initialize, isRemoveinstalledapk, pass, pause, preparation, prepareDevice, prepareLogsInterface, process, removeInstalledAPK, scrollToBottoum, scrollToTop, setAUTApk, setInstallAUT, setInstallMessenger, setInstallRunner, setInstrumentArg, setLogsInterface, setMessengerApk, setProtocolDebug, setRebuildRunner, setRemoveinstalledapk, setResignJar, setRunnerDebug, setTestRunnerApk, setTestRunnerSourceDir, stopEmulator, terminate, warn, wrapRegex

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_AUT_APK

public static final java.lang.String DEFAULT_AUT_APK

See Also:

Constant Field Values

Constructor Detail

SoloTestAndroidApi

public SoloTestAndroidApi()

SoloTestAndroidApi

public SoloTestAndroidApi(java.lang.String messengerApk,
                          java.lang.String testRunnerApk,
                          java.lang.String instrumentArg)

SoloTestAndroidApi

public SoloTestAndroidApi(java.lang.String[] args)

Parameters:

args - Array of String: {"messenger=XXX", "runner=XXX", "instrument=XXX"}

Method Detail

test

protected void test()

 Use solo to test Android ApiDemos
 
 
 
 Test methods as:
 Solo.finishOpenedActivities()
 Solo.getCurrentActivity()
 Solo.waitForActivity(String)
 Solo.assertMemoryNotLow()
 Solo.getAllOpenActivities()
 Solo.setActivityOrientation(int)
 Solo.getActivityMonitor()
 
 The other Robotium-RC methods will be tested in the following methods:
 They are independent from one to other, so you can comment any them during the regression test.
 

Overrides:

test in class SoloTest

See Also:

verifyAssertActivityMethods(String, String), verifyWaitActivityMethods(String, boolean), #testCustomTitleActivity(), #testDefaultThemeActivity(), #testDialogActivity(), testDatePicker(), gotoViewsList(), gotoInflateMenu(), gotoPhotoGallery(), gotoIconGrid()

testRelateToApplication

protected void testRelateToApplication(java.lang.String editTextIdToVerify)

 Solo.getString(String)
 Solo.getView(int)
 
 The test depends on the application itself.
 The parameter is got from the ApiDemos android project
 

See Also:

testEditBoxInCustomActivity()

verifyWaitActivityMethods

void verifyWaitActivityMethods(java.lang.String activityName,
                               boolean positiveTest)
                        throws java.lang.Exception

 Verify following methods:
 Solo.waitForActivity(String)
 Solo.waitForActivity(String, int)
 

Parameters:

activityName - String, The current activity's name

positiveTest - boolean, true for positive test, the activityName should be valid. false for negative test, the activityName should NOT be valid.

Throws:

java.lang.Exception

verifyAssertActivityMethods

void verifyAssertActivityMethods(java.lang.String activityClass,
                                 java.lang.String activityName)
                          throws java.lang.Exception

 Verify following methods:
 Solo.assertCurrentActivityClass(String, String)
 Solo.assertCurrentActivityClass(String, String, boolean)
 Solo.assertCurrentActivityName(String, String)
 Solo.assertCurrentActivityName(String, String, boolean)
 

Parameters:

activityClass - The current activity's class name

activityName - The current activity's name

Throws:

java.lang.Exception

gotoCustomTitleActivity

void gotoCustomTitleActivity()
                      throws java.lang.Exception

 "App -> Activity -> Custom Title" is the path to 'Custom Title Activity'.
 This method will open the 'Custom Title Activity', then it will call #testEditBox() to
 test some methods related to EditBox, finally it will go back to the first page of ApiDemos.
 During this process, it will test the following methods
 
 Tested methods:
 Solo.waitForView(String)
 Solo.waitForView(String, int, long)
 
 Solo.getView(String, int)
 
 Solo.clickOnText(String)
 Solo.clickOnText(String, int)
 Solo.clickOnText(String, int, boolean)
 
 Solo.clickInList(int)
 
 Solo.goBackToActivity(String)
 
 

All tests are positive.

Throws:

java.lang.Exception

gotoDialogActivity

void gotoDialogActivity()
                 throws java.lang.Exception

 "App -> Dialog " is the path to 'Dialog Activity'.
 This method will open the 'Dialog Activity' and make some test
 finally it will go back to the first page of ApiDemos.
 During this process, it will test the following methods
 
 Tested methods:
 Solo.clickInList(int)
 Solo.clickInList(int, int)
 Solo.clickLongInList(int)
 Solo.clickLongInList(int, int)
 Solo.clickLongInList(int, int, int)
 
 

All tests are positive.

Throws:

java.lang.Exception

See Also:

testProgressBar(), testButtons()

gotoDefaultThemeActivity

void gotoDefaultThemeActivity()
                       throws java.lang.Exception

 "Views -> Controls -> Default Theme" is the path to 'DefaultTheme Activity'.
 This method will open the 'DefaultTheme Activity', 
 then it will call #testEditBox() to
 test some methods related to EditBox, finally it will go back to the first page of ApiDemos.
 During this process, it will test the following methods
 
 Tested methods:
 Solo.clickOnText(String, int, boolean)
 Solo.clickOnText(String, int)
 Solo.clickOnText(String)
 
 Solo.getText(int)
 Solo.getText(String)
 Solo.getText(String, boolean)
 
 Solo.getView(String, int)
 Solo.waitForView(String)
 
 Solo.getTopParent(String)
 
 

All tests are positive.

Throws:

java.lang.Exception

verifyWaitForViewUIDMethods

void verifyWaitForViewUIDMethods(java.lang.String viewUID,
                                 boolean positiveTest)
                          throws java.lang.Exception

 Tested methods:
 Solo.waitForViewUID(String)
 Solo.waitForViewUID(String, int, boolean)
 

Parameters:

viewUID - String, the view's uid

positiveTest - boolean, true for positive test, the viewUID should exist. false for negative test, the viewUID should NOT exist.

Throws:

java.lang.Exception

verifyGetViewByIdMethods

void verifyGetViewByIdMethods(int RID,
                              boolean positiveTest)
                       throws java.lang.Exception

 Tested methods:
 Solo.getView(int)
 

Parameters:

RID - int, The id used to get the view. This is the generated ID during compilation of AUT.

positiveTest - boolean, true for positive test, the RID should exist; false for negative test, the RID should NOT exist.

Throws:

java.lang.Exception

gotoDateTimePicker

void gotoDateTimePicker()
                 throws java.lang.Exception

 "Views -> Date Widgets -> 1. Dialog" is the path to 'Date Time Picker'.
 This method will open the DatePicker and TimePicker, and test related methods.
 
 Tested methods:
 Solo.clickLongOnText(String)
 Solo.clickLongOnText(String, int)
 Solo.clickLongOnText(String, int, int)
 Solo.clickLongOnText(String, int, boolean)
 
 Solo.getView(String, int)
 Solo.waitForView(String)
 
 

All tests are positive.

Throws:

java.lang.Exception

gotoViewsList

void gotoViewsList()
            throws java.lang.Exception

 "Views" is the path to 'Views List'.
 Tested methods:
 
 Solo.getView(String, int)
 Solo.waitForView(String)
 
 Solo.clickOnText(String, int, boolean)
 
 

All tests are positive.

Throws:

java.lang.Exception

gotoInflateMenu

void gotoInflateMenu()
              throws java.lang.Exception

 "App -> Menu -> Inflate from XML" is the path to 'MenuInflateFromXml Activity'.
 This method will open the 'MenuInflateFromXml Activity', then it will call testMenu(String) to
 test some methods related to Menu, finally it will go back to the first page of ApiDemos.
 During this process, it will test the following methods
 
 Tested methods:
 Solo.waitForView(String)
 Solo.waitForView(String, int, long)
 
 Solo.getView(String, int)
 
 Solo.clickOnText(String)
 Solo.clickOnText(String, int)
 Solo.clickOnText(String, int, boolean)
 
 Solo.clickInList(int)
 
 Solo.goBackToActivity(String)
 
 

All tests are positive.

Throws:

java.lang.Exception

See Also:

#testMenu()

gotoPhotoGallery

void gotoPhotoGallery()
               throws java.lang.Exception

 "Views -> Gallery -> 1. Photos" is the path to 'Gallery1 Activity'.
 This method will open the 'Gallery1 Activity', then it will call testDrag() to
 test some methods related to drag, finally it will go back to the first page of ApiDemos.
 During this process, it will test the following methods
 
 Tested methods:
 Solo.waitForView(String)
 Solo.waitForView(String, int, long)
 
 Solo.getView(String, int)
 
 Solo.clickOnText(String)
 Solo.clickOnText(String, int)
 Solo.clickOnText(String, int, boolean)
 
 Solo.clickInList(int)
 
 Solo.goBackToActivity(String)
 
 

All tests are positive.

Throws:

java.lang.Exception

See Also:

testDrag()

gotoIconGrid

void gotoIconGrid()
           throws java.lang.Exception

 "Views -> Grid -> 1. Icon Grid" is the path to 'Grid1 Activity'.
 This method will open the 'Grid1 Activity', then it will call testGrid() to
 test some methods related to grid, finally it will go back to the first page of ApiDemos.
 During this process, it will test the following methods
 
 Tested methods:
 Solo.waitForView(String)
 Solo.waitForView(String, int, long)
 
 Solo.getView(String, int)
 
 Solo.clickOnText(String)
 Solo.clickOnText(String, int)
 Solo.clickOnText(String, int, boolean)
 
 Solo.clickInList(int)
 
 Solo.goBackToActivity(String)
 
 

All tests are positive.

Throws:

java.lang.Exception

See Also:

testGrid()

fail

public void fail(java.lang.String message)

Before you call this method, you MUST execute a command by solo.
Otherwise, you will NOT get the correct result information.
If you just want to print message, call super#fail(String) instead.

Overrides:

fail in class SoloTest

showRemoteResult

void showRemoteResult()

Before you call this method, you MUST execute a command by solo.
Otherwise, you will NOT get the correct result information.
When you want to know the remote result info, call this method.
Normally, when you fail, you want to know the reason, you can call this.

main

public static void main(java.lang.String[] args)

Parameters:

args - Array of String passed from commnand line: messenger=XXX runner=XXX instrument=XXX