com.robotium.solo

Class RCSolo

java.lang.Object

com.robotium.solo.Solo

com.robotium.solo.RCSolo

public class RCSolo
extends com.robotium.solo.Solo

From release4.0, Robotium has removed the API getAllOpenedActivities(). We want to keep supporting this API in Robotium RemoteControl. As in class Solo, there is a protected field Solo.activityUtils, which provides the API getAllOpenedActivities(), so RCSolo is created as subclass of Solo. But ActivityUtils is only visible within package com.robotium.solo (com.jayway.android.robotium.solo is the old package name before Robotium 5.0.1), so the class RCSolo is put in the same package.
As from Robotium 5.0.1, the package name 'com.jayway.android.robotium.solo' has been changed to 'com.robotium.solo', we have to change the package for this class RCSolo.

There are also some other protected fields, which are useful, such as:
Solo.checker
Solo.asserter
Solo.clicker
Solo.dialogUtils
Solo.getter
Solo.presser
Solo.screenshotTaker
Solo.scroller
Solo.searcher
Solo.sender
Solo.setter
Solo.sleeper
Solo.textEnterer
Solo.viewFetcher
Solo.waiter
Solo.webUrl
Solo.webUtils

But these fields can ONLY be used in this class or its subclass within package com.robotium.solo (com.jayway.android.robotium.solo the old package name before Robotium 5.0.1).

Since:

May 21, 2013
May 17, 2013 (LeiWang) Update to add removed method finishInactiveActivities() in Robotium 4.1

Author:

Lei Wang, SAS Institute, Inc

Nested Class Summary

Nested classes/interfaces inherited from class com.robotium.solo.Solo

com.robotium.solo.Solo.Config

Field Summary

Fields inherited from class com.robotium.solo.Solo

activityUtils, asserter, checker, clicker, CLOSED, DELETE, dialogUtils, DOWN, ENTER, getter, instrumentation, LANDSCAPE, LEFT, MENU, OPENED, PORTRAIT, presser, RIGHT, rotator, screenshotTaker, scroller, searcher, sender, setter, sleeper, swiper, systemUtils, tapper, textEnterer, UP, viewFetcher, waiter, webUrl, webUtils, zoomer

Constructor Summary

Constructors

Constructor and Description
RCSolo(android.app.Instrumentation instrumentation)
RCSolo(android.app.Instrumentation instrumentation, android.app.Activity activity)

Method Summary

Modifier and Type	Method and Description
void	finishInactiveActivities() Deprecated.
java.util.List<android.app.Activity>	getAllOpenedActivities() This method is removed from Solo from Robotium4.1 release. Expose it in RCSolo to keep the backward compatibility.
android.view.View	getWaitedView() Get the latest view that has been waited for.
boolean	waitForView(int id, int minimumNumberOfMatches, int timeout, boolean scroll) Just copy the same method in super class and save the waited view to a local field. Waits for a View matching the specified resource id.
boolean	waitForView(java.lang.Object tag, int minimumNumberOfMatches, int timeout, boolean scroll) Just copy the same method in super class and save the waited view to a local field. Waits for a View matching the specified tag.

Methods inherited from class com.robotium.solo.Solo

assertCurrentActivity, assertCurrentActivity, assertCurrentActivity, assertCurrentActivity, assertMemoryNotLow, clearEditText, clearEditText, clearLog, clearTextInWebElement, clickInList, clickInList, clickLongInList, clickLongInList, clickLongInList, clickLongOnScreen, clickLongOnScreen, clickLongOnText, clickLongOnText, clickLongOnText, clickLongOnText, clickLongOnTextAndPress, clickLongOnView, clickLongOnView, clickOnActionBarHomeButton, clickOnActionBarItem, clickOnButton, clickOnButton, clickOnCheckBox, clickOnEditText, clickOnImage, clickOnImageButton, clickOnMenuItem, clickOnMenuItem, clickOnRadioButton, clickOnScreen, clickOnScreen, clickOnText, clickOnText, clickOnText, clickOnToggleButton, clickOnView, clickOnView, clickOnWebElement, clickOnWebElement, clickOnWebElement, clickOnWebElement, drag, enterText, enterText, enterTextInWebElement, finalize, finishOpenedActivities, getActivityMonitor, getButton, getButton, getButton, getConfig, getCurrentActivity, getCurrentViews, getCurrentViews, getCurrentViews, getCurrentViews, getCurrentViews, getCurrentWebElements, getCurrentWebElements, getEditText, getEditText, getEditText, getImage, getImageButton, getString, getString, getText, getText, getText, getTopParent, getView, getView, getView, getView, getView, getView, getView, getViews, getViews, getWebElement, getWebElements, getWebElements, getWebUrl, goBack, goBackToActivity, hideSoftKeyboard, isCheckBoxChecked, isCheckBoxChecked, isRadioButtonChecked, isRadioButtonChecked, isSpinnerTextSelected, isSpinnerTextSelected, isTextChecked, isToggleButtonChecked, isToggleButtonChecked, pinchToZoom, pressMenuItem, pressMenuItem, pressSoftKeyboardNextButton, pressSoftKeyboardSearchButton, pressSpinnerItem, rotateLarge, rotateSmall, scrollDown, scrollDownList, scrollDownList, scrollListToBottom, scrollListToBottom, scrollListToLine, scrollListToLine, scrollListToTop, scrollListToTop, scrollToBottom, scrollToSide, scrollToSide, scrollToSide, scrollToTop, scrollUp, scrollUpList, scrollUpList, scrollViewToSide, scrollViewToSide, scrollViewToSide, searchButton, searchButton, searchButton, searchButton, searchEditText, searchText, searchText, searchText, searchText, searchText, searchToggleButton, searchToggleButton, sendKey, setActivityOrientation, setDatePicker, setDatePicker, setMobileData, setNavigationDrawer, setProgressBar, setProgressBar, setSlidingDrawer, setSlidingDrawer, setTimePicker, setTimePicker, setWiFiData, sleep, startScreenshotSequence, startScreenshotSequence, stopScreenshotSequence, swipe, takeScreenshot, takeScreenshot, takeScreenshot, typeText, typeText, typeTextInWebElement, typeTextInWebElement, typeTextInWebElement, unlockScreen, waitForActivity, waitForActivity, waitForActivity, waitForActivity, waitForCondition, waitForDialogToClose, waitForDialogToClose, waitForDialogToOpen, waitForDialogToOpen, waitForEmptyActivityStack, waitForFragmentById, waitForFragmentById, waitForFragmentByTag, waitForFragmentByTag, waitForLogMessage, waitForLogMessage, waitForText, waitForText, waitForText, waitForText, waitForView, waitForView, waitForView, waitForView, waitForView, waitForView, waitForView, waitForView, waitForView, waitForWebElement, waitForWebElement, waitForWebElement

Methods inherited from class java.lang.Object

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

Constructor Detail

RCSolo

public RCSolo(android.app.Instrumentation instrumentation)

RCSolo

public RCSolo(android.app.Instrumentation instrumentation,
              android.app.Activity activity)

Method Detail

getAllOpenedActivities

public java.util.List<android.app.Activity> getAllOpenedActivities()

This method is removed from Solo from Robotium4.1 release.
Expose it in RCSolo to keep the backward compatibility.

finishInactiveActivities

public void finishInactiveActivities()

Deprecated.

This method is removed from Solo from Robotium4.1 release.

The Activity handling has changed since that method was introduced. Only weak references of Activities are now stored and Activities are now also removed as soon as new ones are opened. Due to these changes finishInactiveActivities has lost its purpose. The old implementation introduced crashes as keeping references to Activities resulted in memory not being freed.

Expose it in RCSolo as a do-nothing to keep the backward compatibility.

getWaitedView

public android.view.View getWaitedView()

Get the latest view that has been waited for.

As this field waitedView is set in the method waitForView(int, int, int, boolean) or waitForView(Object, int, int, boolean) , so before we can get the View by this method, we need to call firstly waitForView(Object, int, int, boolean), waitForView(int, int, int, boolean) or the methods waitForView() who call them. To avoid the thread-influence, we should call these 2 methods in a synchronized block. Such as following:

 
   boolean found = false;
   View view = null;
   synchronized(solo){
     found = solo.waitForView(tag);
     if(found) view = solo.getWaitedView();					
   }
 
 

See Also:

Solo.waitForView(int), Solo.waitForView(int, int, int), waitForView(int, int, int, boolean), Solo.waitForView(Object), Solo.waitForView(Object, int, int), waitForView(Object, int, int, boolean)

waitForView

public boolean waitForView(java.lang.Object tag,
                           int minimumNumberOfMatches,
                           int timeout,
                           boolean scroll)

Just copy the same method in super class and save the waited view to a local field.
Waits for a View matching the specified tag.

Overrides:

waitForView in class com.robotium.solo.Solo

Parameters:

tag - the tag of the View to wait for

minimumNumberOfMatches - the minimum number of matches that are expected to be found. 0 means any number of matches

timeout - the amount of time in milliseconds to wait

scroll - true if scrolling should be performed

Returns:

true if the View is displayed and false if it is not displayed before the timeout

waitForView

public boolean waitForView(int id,
                           int minimumNumberOfMatches,
                           int timeout,
                           boolean scroll)

Just copy the same method in super class and save the waited view to a local field.
Waits for a View matching the specified resource id.

Overrides:

waitForView in class com.robotium.solo.Solo

Parameters:

id - the R.id of the View to wait for

minimumNumberOfMatches - the minimum number of matches that are expected to be found. 0 means any number of matches

timeout - the amount of time in milliseconds to wait

scroll - true if scrolling should be performed

Returns:

true if the View is displayed and false if it is not displayed before the timeout