org.safs.android

Class DUtilities

java.lang.Object

org.safs.android.auto.lib.DUtilities

org.safs.android.DUtilities

public class DUtilities
extends DUtilities

Utilities for the Droid testing environment and Android Developer SDK tools.

Author:

Carl Nagle

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	rootRunDir SAFSDIR variable export from STAFEnv.sh script

Fields inherited from class org.safs.android.auto.lib.DUtilities

androidsdk, anttool, bridge, DEFAULT_DEVICE_SERIAL, DEFAULT_EMULATOR_AVD, DEFAULT_INSTALL_APK_TIMEOUT, DEVICE_STRING, installAUT, installMessenger, installRunner, IS_TEST_TARGET_PACKAGE_SET, MANIFEST_XML_FILENAEM, mon, OFFLINE_STRING, rebuildRunner, rebuildRunnerAntArgs, rebuildRunnerForce, REMOTE_DROID_LAUNCH_TIMEOUT, REMOTE_LAUNCH_TIMEOUT, RESIGN_JAR_ENV, RESIGN_JAR_FULL_NAME, ROOT_ANT_SDK_DIR, ROOT_DROID_PROJECT_DIR, ROOT_DROID_SDK_DIR, ROOT_DROID_SDK_TOOLS, SAFS_SERVICE_APP, SAFS_SERVICE_PACKAGE, TEST_RUNNER_APP, TEST_RUNNER_APP_SOURCE, TEST_RUNNER_INSTRUMENT, TEST_RUNNER_PACKAGE, TEST_TARGET_APP, TEST_TARGET_PACKAGE, timeoutWaitInstallAPK, USE_DEVICE_SERIAL, utils, XML_MODIFIED_FAIL, XML_MODIFIED_NO_CHANGE, XML_MODIFIED_SUCCESS

Constructor Summary

Constructors

Constructor and Description
DUtilities()

Method Summary

Modifier and Type	Method and Description
static DTestRecordHelper	captureRemoteResultsProperties(RemoteResults results, DTestRecordHelper data) Modifies the TestRecordHelper statuscode and statusinfo from the remote results properties.
static int	convertRemoteControlStatus(int status) Convert SoloRemoteControl status codes to equivalent SAFS StatusCodes.
protected void	debugI(java.lang.String message)
static DTestRecordHelper	getAppMapRecognition(DTestRecordHelper droiddata) Attempts to fill the DTestHelper winGuiID and compGuiID fields as well as the Keyword Properties KEY_WINREC and KEY_COMPREC properties using the Keyword Properties and STAFHelper in the provided DTestRecordHelper.
protected static GenericProcessMonitor	getProcessMonitor() Returns a blank instance of ProcessMonitor on which to call the necessary static methods.

Methods inherited from class org.safs.android.auto.lib.DUtilities

addDeviceSerialParam, argsToString, buildAPK, copyFile, debug, error, getAndroidDebugBridge, getAndroidTools, getAntTool, getAttachedDevices, getDeviceScreenImage, getIDevice, getResignJarFileName, getTargetPackageValue, initAndroidTools, initAntTool, installEnabledAPKs, installReplaceAPK, isDeviceOffline, killADBServer, launchEmulatorAVD, launchTestInstrumentation, launchTestInstrumentation, modifyAndroidManifestXml, rebuildRunner, rebuildTestRunnerApk, resetADBServer, resignAUTApk, resignAUTApk, setAndroidToolsHome, setAntToolsHome, shutdownEmulatorProcess, shutdownLaunchedEmulators, startADBServer, uninstallAPK, uninstallAPKPackage, unlockDeviceScreen, waitDevice

Methods inherited from class java.lang.Object

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

Field Detail

rootRunDir

public static java.lang.String rootRunDir

SAFSDIR variable export from STAFEnv.sh script

Constructor Detail

DUtilities

public DUtilities()

Method Detail

debugI

protected void debugI(java.lang.String message)

Overrides:

debugI in class DUtilities

getProcessMonitor

protected static GenericProcessMonitor getProcessMonitor()

Returns a blank instance of ProcessMonitor on which to call the necessary static methods. Subclasses should override to get an appropriate subclass of GenericProcessMonitor.

convertRemoteControlStatus

public static int convertRemoteControlStatus(int status)

Convert SoloRemoteControl status codes to equivalent SAFS StatusCodes. Currently, we handle:

 Message.STATUS_REMOTE_NOT_EXECUTED = StatusCodes.SCRIPT_NOT_EXECUTED
 Message.STATUS_REMOTERESULT_OK = StatusCodes.NO_SCRIPT_FAILURE
 Message.STATUS_REMOTERESULT_WARN = StatusCodes.SCRIPT_WARNING
 

Everything else is converted to StatusCodes.GENERAL_SCRIPT_FAILURE

captureRemoteResultsProperties

public static DTestRecordHelper captureRemoteResultsProperties(RemoteResults results,
                                                               DTestRecordHelper data)

Modifies the TestRecordHelper statuscode and statusinfo from the remote results properties. Only changes the statuscode and statusinfo if KEY_ISREMOTERESULT exists and is true. After that, statuscode will be set to SCRIPT_NOT_EXECUTED unless modified by KEY_REMOTERESULTCODE. statusinfo will be set to null unless modified by KEY_REMOTERESULTINFO.

The routine will also attempt to instantiate and store any message and details sent as ResourceMessageInfos stored in the RemoteResults.

Parameters:

props -

data -

Returns:

same data object with statuscode, statusinfo, and any message and detail ResourceMessageInfo objects set.

See Also:

DTestRecordHelper.getMessage(), DTestRecordHelper.getDetailMessage(), ResourceMessageInfo

getAppMapRecognition

public static DTestRecordHelper getAppMapRecognition(DTestRecordHelper droiddata)

Attempts to fill the DTestHelper winGuiID and compGuiID fields as well as the Keyword Properties KEY_WINREC and KEY_COMPREC properties using the Keyword Properties and STAFHelper in the provided DTestRecordHelper.

The routine expects the STAFHelper, windowName, compName, and appMapName fields have valid values prior to this call.

If the named App Map does NOT contain entries for the window and/or component then the window and/or component names themselves are used as the recognition information. This helps support recognition like "CurrentWindow" and unused window or component values like "Anything", "AtAll".

Parameters:

droiddata -

Returns:

droiddata with updated Keyword Properties and GuiID entries.