class Mobile():
"""
"""
def __init__(self, android_serial = None):
# logger.info("Importing Android library")
# print "Importing Android library"
# clm.message("Importing Android library")
self.adb = ADB(android_serial)
self.device = Device(android_serial)
self.test_helper = TestHelper(android_serial)
def set_serial(self, android_serial):
"""
Set device serial
"""
self.adb = ADB(android_serial)
self.device = Device(android_serial)
self.test_helper = TestHelper(android_serial)
def get_info(self):
"""
Retrieve the device info
"""
return self.device.info
#Key Event Actions of the device
"""
Turn on/off screen
"""
def turn_on_screen(self):
"""
Turn on screen
"""
self.device.screen.on()
def turn_off_screen(self):
"""
Turn off screen
"""
self.device.screen.off()
def wakeup_the_device(self):
"""
wakeup the device
"""
self.device.wakeup()
"""
Press hard/soft key
"""
def press_key(self, *key):
"""
press *key* keycode
"""
self.device.press(*key)
def press_home(self):
"""
press home key
"""
self.device.press.home()
def press_back(self):
"""
press back key
"""
self.device.press.back()
def press_left(self):
"""
press left key
"""
self.device.pres.left()
def press_right(self):
"""
press right key
"""
self.device.press.right()
def press_up(self):
"""
press up key
"""
self.device.press.up()
def press_down(self):
"""
press down key
"""
self.device.press.down()
def press_center(self):
"""
press center key
"""
self.device.press.center()
def press_menu(self):
"""
press menu key
"""
self.device.press.menu()
def press_search(self):
"""
press search key
"""
self.device.press.search()
def press_enter(self):
"""
press enter key
"""
self.device.press.enter()
def press_delete(self):
"""
press delete key
"""
self.device.press.delete()
def press_recent(self):
"""
press recent key
"""
self.device.press.recent()
def press_volume_up(self):
"""
press volume up key
"""
self.device.press.volume_up()
def press_volume_down(self):
"""
press volume down key
"""
self.device.press.volume_down()
def press_camera(self):
"""
press camera key
"""
self.device.press.camera()
def press_power(self):
"""
press power key
"""
self.device.press.power()
#Gesture interaction of the device
def click(self, x, y):
"""
click (x, y) on screen
"""
self.device.click(x, y)
def swipe(self, sx, sy, ex, ey, steps=10):
"""
swipe from (sx, sy) to (ex, ey) with steps
"""
self.device.swipe(sx, sy, ex, ey, steps)
# Swipe from the center of the ui object to its edge
def swipe_left(self, obj, steps=10):
"""
swipe the *obj* from center to left
"""
obj.swipe.left(steps=steps)
def swipe_right(self, obj, steps=10):
"""
swipe the *obj* from center to right
"""
obj.swipe.right(steps=steps)
def swipe_top(self, obj, steps=10):
"""
swipe the *obj* from center to top
"""
obj.swipe.top(steps=steps)
def swipe_bottom(self, obj, steps=10):
"""
swipe the *obj* from center to bottom
"""
obj.swipe.bottom(steps=steps)
def drag(self,sx, sy, ex, ey, steps=10):
"""
drag from (sx, sy) to (ex, ey) with steps
"""
self.device.drag(sx, sy, ex, ey, steps)
#Wait until the specific ui object appears or gone
# wait until the ui object appears
def wait_for_exists(self, timeout=0, *args, **attribute):
"""
true means the object which has *attribute* exist
false means the object does not exist
in the given timeout
"""
return self.device(**attribute).wait.exists(timeout=timeout)
# wait until the ui object gone
def wait_until_gone(self, timeout=0, *args, **attribute):
"""
true means the object which has *attribute* disappear
false means the object exist
in the given timeout
"""
return self.device(**attribute).wait.gone(timeout=timeout)
def wait_for_object_exists(self, obj, timeout=0):
"""
true means the object exist
false means the object does not exist
in the given timeout
"""
return obj.wait.exists(timeout=timeout)
# wait until the ui object gone
def wait_until_object_gone(self, obj, timeout=0):
"""
true means the object disappear
false means the object exist
in the given timeout
"""
return obj.wait.gone(timeout=timeout)
# Perform fling on the specific ui object(scrollable)
def fling_forward_horizontally(self, obj):
"""
return whether the object can be fling or not
"""
return obj.fling.horiz.forward()
def fling_backward_horizontally(self, obj):
"""
return whether the object can be fling or not
"""
return obj.fling.horiz.backward()
def fling_forward_vertically(self, obj):
"""
return whether the object can be fling or not
"""
return obj.fling.vert.forward()
def fling_backward_vertically(self, obj):
"""
return whether the object can be fling or not
"""
return obj.fling.vert.backward()
# Perform scroll on the specific ui object(scrollable)
def scroll_to_beginning_vertically(self, obj, steps=10):
"""
"""
return obj.scroll.vert.toBeginning(steps=steps)
def scroll_forward_horizontally(self, obj, steps=10):
"""
return whether the object can be fling or not
"""
return obj.scroll.horiz.forward(steps=steps)
def scroll_backward_horizontally(self, obj, steps=10):
"""
return whether the object can be fling or not
"""
return obj.scroll.horiz.backward(steps=steps)
def scroll_to_horizontally(self, obj, *args,**attribute):
"""
return whether the object can be fling or not
"""
return obj.scroll.horiz.to(**attribute)
def scroll_forward_vertically(self, obj, steps=10):
"""
return whether the object can be fling or not
"""
return obj.scroll.vert.forward(steps=steps)
def scroll_backward_vertically(self, obj, steps=10):
"""
return whether the object can be fling or not
"""
return obj.scroll.vert.backward(steps=steps)
def scroll_to_vertically(self, obj, *args, **attribute):
"""
return whether the object can be fling or not
"""
msg = ''
for key, value in attribute.iteritems():
msg += ' %s=%s ' % (key, value)
print msg
# print 'args:' + args[0]
return obj.scroll.vert.to(**attribute)
#Screen Actions of the device
def screenshot(self, scale=None, quality=None):
"""
Take a screenshot of device and log in the report with timestamp
"""
output_dir = BuiltIn().get_variable_value('${OUTPUTDIR}')
ts = time.time()
st = datetime.datetime.fromtimestamp(ts).strftime('%Y%m%d%H%M%S')
screenshot_path = '%s%s%s.png' % (output_dir, os.sep, st)
self.device.screenshot(screenshot_path, scale, quality)
logger.info('\n<a href="%s">%s</a><br><img src="%s">' % (screenshot_path, st, screenshot_path), html=True)
#Watcher
# def register_click_watcher(self, watcher_name, attributes, *condition_list):
# """
# The watcher click on the object which has the attributes when conditions match
# """
# print type(attributes)
# watcher = self.device.watcher(watcher_name)
# for condition in condition_list:
# watcher.when(**condition)
# watcher.click(**attributes)
# self.device.watchers.run()
# print 'register watcher:%s' % watcher_name
# return
def __unicode_to_dict(self, a_unicode):
a_dict = dict()
dict_item_count = a_unicode.count('=')
for count in range(dict_item_count):
equal_sign_position = a_unicode.find('=')
comma_position = a_unicode.find(',')
a_key = a_unicode[0:equal_sign_position]
if comma_position == -1:
a_value = a_unicode[equal_sign_position + 1:]
else:
a_value = a_unicode[equal_sign_position + 1:comma_position]
a_unicode = a_unicode[comma_position + 1:]
a_dict[a_key] = a_value
return a_dict
def register_click_watcher(self, watcher_name, attributes, *condition_list):
"""
The watcher click on the object which has the *attributes* when conditions match
"""
watcher = self.device.watcher(watcher_name)
for condition in condition_list:
watcher.when(**self.__unicode_to_dict(condition))
watcher.click(**self.__unicode_to_dict(attributes))
self.device.watchers.run()
def register_press_watcher(self, watcher_name, press_keys, *condition_list):
"""
The watcher perform *press_keys* action sequentially when conditions match
"""
def unicode_to_list(a_unicode):
a_list = list()
comma_count = a_unicode.count(',')
for count in range(comma_count + 1):
comma_position = a_unicode.find(',')
if comma_position == -1:
a_list.append(str(a_unicode))
else:
a_list.append(a_unicode[0:comma_position])
a_unicode = a_unicode[comma_position + 1:]
return a_list
watcher = self.device.watcher(watcher_name)
for condition in condition_list:
watcher.when(**self.__unicode_to_dict(condition))
watcher.press(*unicode_to_list(press_keys))
self.device.watchers.run()
def remove_watchers(self, watcher_name = None):
"""
remove watcher with *watcher_name* or remove all watchers
"""
if watcher_name == None:
self.device.watchers.remove()
else:
self.device.watchers.remove(watcher_name)
def list_all_watchers(self):
"""
return the watcher list
"""
return self.device.watchers
#Selector
def get_object(self, *args, **attribute):
"""
get the ui object with attribute *attribute*
"""
msg = ''
for key, value in attribute.iteritems():
msg += ' %s=%s ' % (key, value)
print msg
return self.device(*args, **attribute)
def get_info_of_object(self, obj):
"""
return info dictionary of the *obj*
The info example:
{
u'contentDescription': u'',
u'checked': False,
u'scrollable': True,
u'text': u'',
u'packageName': u'com.android.launcher',
u'selected': False,
u'enabled': True,
u'bounds':
{
u'top': 231,
u'left': 0,
u'right': 1080,
u'bottom': 1776
},
u'className': u'android.view.View',
u'focusable': False,
u'focused': False,
u'clickable': False,
u'checkable': False,
u'chileCount': 1,
u'longClickable': False,
u'visibleBounds':
{
u'top': 231,
u'left': 0,
u'right': 1080,
u'bottom': 1776
}
}
"""
return obj.info
def click_on(self, *args, **attribute):
"""
click on the object with *attribute*
"""
self.device(**attribute).click()
def long_click_on(self, *args, **attribute):
"""
click on the object with *attribute*
"""
self.device(**attribute).long_click()
def call(self, obj, method, *args, **attribute):
func = getattr(obj, method)
return func(**attribute)
def set_text(self, text, *args, **attribute):
"""
set *text* to the Component which has the *attribute*
"""
self.device(**attribute).set_text(text)
def clear_text(self, *args, **attributes):
"""
Clear text of the component with *attributes*
"""
while True:
target = self.device(**attributes)
text = target.info['text']
target.clear_text()
remain_text = target.info['text']
if text == '' or remain_text == text:
break
# Other feature
def sleep(self, time):
"""
sleep(no action) for *time* (in millisecond)
"""
target = 'wait for %s' % str(time)
self.device(text=target).wait.exists(timeout=time)
def install(self, apk_path):
self.adb.cmd('install "%s"' % apk_path)
def uninstall(self, package_name):
self.adb.cmd('uninstall %s' % package_name)
def type(self, text):
"""
Type *text* at current focused component
"""
self.test_helper.send_set_text_cmd(text)
def foo(self):
pass
# logger.info('\nGot arg %s %s' % (output_dir, st), also_console=True)
# clm = CommandLineWriter()
# output some messages on console
# clm.message(' ')
# clm.message(u'中文')
# clm.message(u'2----------2')
def test(self):
pass
def xuhuapaizhao(self):
dev = Device(self.Id)
try:
dev(text='相机').click()
time.sleep(2)
dev(resourceId=
'com.freeme.camera:id/freeme_bv_button'
).click()
time.sleep(2)
for temp6 in range(1000):
print('%sxuhuapaizhao' % (temp6 + 1))
dev(resourceId=
'com.freeme.camera:id/shutter_button'
).click()
time.sleep(1.5)
dev.screenshot(
r'%s/screenshot/%sxuhuapaizhao.png' %
(self.Id, (temp6 + 1)))
time.sleep(1)
except Exception, e:
print('error', e)
dev.screenshot(
r'%s/error/errorxuhuapaizhao.png')
dev.press.BACK()
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent HOME')
class AndroidEnv:
def __init__(self, app_package, screen_size):
self.app_package = app_package
self.device = Device()
self.screen_size = screen_size
self._exec(
f"ng ng-cp {PROJECT_ROOT}lib/org.jacoco.ant-0.7.9-nodeps.jar")
self._exec(f"ng ng-cp {PROJECT_ROOT}")
self._exec("adb forward tcp:8981 tcp:8981")
def reset(self):
self._exec(f"adb shell am force-stop {self.app_package}")
self._exec(f"adb shell pm clear {self.app_package}")
self._exec(f"adb shell monkey -p {self.app_package} 1")
return self._get_screen(), self._get_actions()
def step(self, action):
action.execute()
coverage = self._get_current_coverage()
print(coverage)
done = coverage > 0.8
return self._get_screen(), self._get_actions(), coverage, done
def _exec(self, command):
call(command, shell=True, stdout=FNULL)
def _get_actions(self):
actions = []
for gui_obj in self.device():
if gui_obj.clickable:
actions.append(Action(gui_obj))
return actions
def _get_screen(self):
self.device.screenshot("state.png")
img = misc.imread("state.png")
return self._image_to_torch(img)
def _image_to_torch(self, image):
# img_resized = misc.imresize(image, size=0.1)
screen_transposed = image.transpose((2, 0, 1))
screen_scaled = np.ascontiguousarray(screen_transposed,
dtype=np.float32) / 255
torch_img = torch.from_numpy(screen_scaled)
return resize(torch_img).unsqueeze(0)
def _get_current_coverage(self):
start_time = timeit.default_timer()
with http_client.request("GET",
"http://localhost:8981",
preload_content=False) as r, open(
"coverage/coverage.exec",
"wb") as coverage_file:
coverage_file.write(r.read())
generate_report_cmd = f"ng ReportGenerator {APP_UNDER_TEST_ROOT}"
self._exec(generate_report_cmd)
df = pd.read_csv("coverage/report.csv")
missed, covered = df[['LINE_MISSED', 'LINE_COVERED']].sum()
print(f"Complete in {timeit.default_timer() - start_time} seconds")
return covered / (missed + covered)
def FrontRear(self):
dev = Device(self.Id)
try:
dev(text='相机').click()
time.sleep(2)
for temp6 in range(1000):
print('%sFrontRear' %
(temp6 + 1))
dev(resourceId=
"com.freeme.camera:id/camera_toggle_button"
).click()
time.sleep(2)
dev(resourceId=
"com.freeme.camera:id/camera_toggle_button"
).click()
time.sleep(2)
dev.screenshot(
r'%s/screenshot/%sFrontRear.png'
% (self.Id, (temp6 + 1)))
time.sleep(1.5)
except Exception, e:
print('error', e)
dev.screenshot(
r'%s/error/errorFrontRear.png'
% (self.Id))
os.system(
'adb shell input keyevent BACK'
)
os.system(
'adb shell input keyevent BACK'
)
os.system(
'adb shell input keyevent HOME'
)
def _screenshot_uiauto(self):
tmp_file = self._mktemp()
UiaDevice.screenshot(self, tmp_file)
# self._uiauto.screenshot(tmp_file) # this will call Mixin.screenshot first, which may get too many loop
try:
return imutils.open_as_pillow(tmp_file)
except IOError:
raise IOError("Screenshot use uiautomator failed.")
finally:
base.remove_force(tmp_file)
class Test:
def __init__(self, deviceid):
self.device = Device(deviceid)
self.deviceid = deviceid
def click(self, x, y):
self.device.click(x, y)
def startActivity(self, activity):
os.system('adb -s %s shell am start %s' % (self.deviceid, activity))
# 平均hash算法计算
def classify_aHash(self, image1, image2):
image1 = cv2.resize(image1, (8, 8))
image2 = cv2.resize(image2, (8, 8))
gray1 = cv2.cvtColor(image1, cv2.COLOR_BGR2GRAY)
gray2 = cv2.cvtColor(image2, cv2.COLOR_BGR2GRAY)
hash1 = self.getHash(gray1)
hash2 = self.getHash(gray2)
return self.Hamming_distance(hash1, hash2)
# 输入灰度值，返回hash
def getHash(self, image):
avreage = np.mean(image)
hash = []
for i in range(image.shape[0]):
for j in range(image.shape[1]):
if image[i, j] > avreage:
hash.append(1)
else:
hash.append(0)
return hash
# 计算汉明距离
def Hamming_distance(self, hash1, hash2):
num = 0
for index in range(len(hash1)):
if hash1[index] != hash2[index]:
num += 1
return num
# 使用adb命令截取手机页面图片
def screenshot(self):
time.sleep(8)
# os.system("adb shell /system/bin/screencap -p /sdcard/p2.png") #（保存到SDCard）
# os.system("adb pull /sdcard/p2.png E:\Study\uiautomator\picture") #（保存到电脑）
self.device.screenshot("E:\\Study\\uiautomator\\picture\\p2.png")
def screenshot(dir_data, activity, first_page, dev=None, pkg=''):
"""
Take the screenshot of the given activity.
:param dir_data:
:param activity:
:param first_page:
:param dev:
:param pkg:
:return:
"""
logger.info('Try to dump layout XML of ' + activity)
if dev is None:
dev = Device(UIExerciser.series)
dev.screen.on()
if activity == '':
activity = 'first_page'
activity = str(activity).replace('\"', '')
# dev.wait.idle()
logger.info('Dumping...' + activity)
if first_page:
UIExerciser.pass_first_page(dev)
xml_data = None
try:
xml_data = dev.dump()
except Exception as e:
logger.error(e)
# The dev may be died, force exit.
exit(1)
UIExerciser.is_crashed(dev, xml_data)
while UIExerciser.is_sms_alarm(dev, xml_data):
xml_data = dev.dump()
xml_data = ViewClientHandler.fill_ids(xml_data, pkg)
logger.info(xml_data)
f = open(
dir_data + activity + '.xml',
"wb",
)
f.write(xml_data.encode('utf-8'))
f.close()
try:
logger.info(dev.screenshot(dir_data + activity + '.png'))
except Exception as e:
logger.error(e)
UIExerciser.run_adb_cmd(
'shell /system/bin/screencap -p /sdcard/screenshot.png')
UIExerciser.run_adb_cmd('pull /sdcard/screenshot.png ' + dir_data +
activity + '.png')
return True
def screenshot(self, dir_data, activity, first_page, pkg=''):
# current_time = time.strftime(ISOTIMEFORMAT, time.localtime())
self.logger.info('Try to dump layout XML of ' + activity)
dev = Device(self.series)
dev.screen.on()
if activity == '':
activity = 'first_page'
activity = str(activity).replace('\"', '')
# dev.wait.idle()
self.logger.info('Dumping...' + activity)
if first_page:
UIExerciser.pass_first_page(dev)
try:
xml_data = dev.dump()
except Exception as e:
print e
exit(1)
self.is_crashed(dev, xml_data)
while self.is_SMS_alarm(dev, xml_data):
xml_data = dev.dump()
xml_data = ViewClientHandler.fill_ids(xml_data, pkg)
self.logger.info(xml_data)
f = open(
dir_data + activity + '.xml',
"wb",
)
f.write(xml_data.encode('utf-8'))
f.close()
try:
self.logger.info(dev.screenshot(dir_data + activity + '.png'))
except Exception as e:
self.logger.error(e)
UIExerciser.run_adb_cmd(
'shell /system/bin/screencap -p /sdcard/screenshot.png')
UIExerciser.run_adb_cmd('pull /sdcard/screenshot.png ' + dir_data +
activity + '.png')
return True
class AndroidDevice(object):
'''
wrapper for android uiautomator-server binding(pip install uiautomator).
provide android device event inject, ui object inspect and image comparison.
'''
def __init__(self, seral=None):
'''
create device instance.
'''
self.serial = os.environ[ANDROID_SERIAL] if os.environ.has_key(
ANDROID_SERIAL) else None
self.working_dir_path = WORKING_DIR_PATH
self.report_dir_path = REPORT_DIR_PATH
self.right_dir_path = WORKING_DIR_PATH
self._internal_storage_dir = DEFAULT_DEVICE_INTERNAL_STORAGE
self.d = Device(self.serial)
#try:
# if int(self.d.info['sdkInt']) <= 17:
# self.d.screenshot = self.screenshot_common
#except:
# pass
def set_internal_storage_dir(self, path):
self._internal_storage_dir = path
def __getattr__(self, attr):
'''
forward method/attrbuite to uiautomator device if method support by uiautomator.
'''
if hasattr(self.d, attr):
#if attr == 'screenshot':
# return self.screenshot_common
m = getattr(self.d, attr)
if inspect.ismethod(m):
def wrapper(*args, **kwargs):
return m(*args, **kwargs)
return wrapper
else:
return m
raise AttributeError(attr)
def __call__(self, *args, **kwargs):
'''
selector support:
d(text="Settings").click()
'''
return self.d(*args, **kwargs)
@property
def orientation(self):
return self.d.orientation
@orientation.setter
def orientation(self, v):
self.d.orientation = v
def serial(self):
'''
device serial number from $ANDROID_SERIAL
'''
return self.serial
def sleep(self, sec):
time.sleep(sec)
#device event inject
def start_activity(self, *argv, **intent_params):
'''
Starts an Activity on the device by sending an Intent which constructed from the specified parameters.
The params of Intent supported from adb docs:
<INTENT> specifications include these flags:
[-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]
[-c <CATEGORY> [-c <CATEGORY>] ...]
[-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE> ...]
[--esn <EXTRA_KEY> ...]
[--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> ...]
[-e|--ei <EXTRA_KEY> <EXTRA_INT_VALUE> ...]
[-n <COMPONENT>] [-f <FLAGS>]
[<URI>]
example:
start avtivity as new task:
start_activity('--activity-clear-task', component='com.android.settings/.Settings')
@type argv: string
@param argv: specify the rule of how to start acitivty. the value of argv show as below:
[--grant-read-uri-permission] [--grant-write-uri-permission]
[--debug-log-resolution] [--exclude-stopped-packages]
[--include-stopped-packages]
[--activity-brought-to-front] [--activity-clear-top]
[--activity-clear-when-task-reset] [--activity-exclude-from-recents]
[--activity-launched-from-history] [--activity-multiple-task]
[--activity-no-animation] [--activity-no-history]
[--activity-no-user-action] [--activity-previous-is-top]
[--activity-reorder-to-front] [--activity-reset-task-if-needed]
[--activity-single-top] [--activity-clear-task]
[--activity-task-on-home]
[--receiver-registered-only] [--receiver-replace-pending]
@type intent_params: dictionary
@param intent_params: the properties of an Intent.
property support: component/action/data/mimetype/categories/extras/flags/uri
@rtype: AndroidDevice
@return: a instance of AndroidDevice.
'''
#d.server.adb.cmd('shell','am', 'start', '-a', 'android.intent.action.DIAL','tel:13581739891').communicate()
#sys.stderr.write(str(intent_params))
keys = intent_params.keys()
shellcmd = ['shell', 'am', 'start']
if 'component' in keys:
shellcmd.append('-n')
shellcmd.append(intent_params['component'])
if 'action' in keys:
shellcmd.append('-a')
shellcmd.append(intent_params['action'])
if 'data' in keys:
shellcmd.append('-d')
shellcmd.append(intent_params['data'])
if 'mimetype' in keys:
shellcmd.append('-t')
shellcmd.append(intent_params['mimetype'])
if 'categories' in keys:
for category in intent_params['categories']:
shellcmd.append('-c')
shellcmd.append(category)
if 'extras' in keys:
for extra_key, extra_value in intent_params['extras'].items():
str_value = ''
arg = ''
if isinstance(extra_value, types.IntType):
str_value = str(extra_value)
arg = '--ei'
elif isinstance(extra_value, types.BooleanType):
str_value = str(extra_value)
arg = '--ez'
else:
str_value = str(extra_value)
arg = '--es'
shellcmd.append(arg)
shellcmd.append(extra_key)
shellcmd.append(str_value)
if 'flags' in keys:
shellcmd.append('-f')
shellcmd.append(str(intent_params['flags']))
if 'uri' in keys:
shellcmd.append(intent_params['uri'])
if 'package' in keys:
shellcmd.append(intent_params['package'])
#sys.stderr.write(str(shellcmd))
if argv:
shellcmd.append(*argv)
self.d.server.adb.cmd(*shellcmd).communicate()
return self
def instrument(self, **kwargs):
'''
Run the specified package with instrumentation and return the output it generates.
Use this to run a test package using InstrumentationTestRunner.
Typically this target <COMPONENT> is the form <TEST_PACKAGE>/<RUNNER_CLASS>.
Options are:
-w: wait for instrumentation to finish before returning. Required for test runners.
-r: print raw results (otherwise decode REPORT_KEY_STREAMRESULT).
Use with [-e perf true] to generate raw output for performance measurements.
-e <NAME> <VALUE>: set argument <NAME> to <VALUE>.
For test runners a common form is [-e <testrunner_flag> <value>[,<value>...]].
-p <FILE>: write profiling data to <FILE>
--user <USER_ID> | current: Specify user instrumentation runs in; current user if not specified.
--no-window-animation: turn off window animations will running.
@type intent_params: dictionary
@param intent_params: the properties of an instrumentation testing.
property support: packagename, <NAME> to <VALUE>.
@rtype: AndroidDevice
@return: a instance of AndroidDevice.
'''
keys = kwargs.keys()
shellcmd = ['shell', 'am', 'instrument', '-w', '-r']
pkgname = kwargs.pop('packagename')
for k, v in kwargs.items():
if k and v:
shellcmd.append('-e')
shellcmd.append(k)
shellcmd.append(str(v))
shellcmd.append(pkgname)
result = self.d.server.adb.cmd(*shellcmd).communicate()
return result
def click(self, *args, **kwargs):
'''
example:
click(x,y)
Click the screen location specified by x and y.
Format: (x,y) the screen location specified by x and y.
x The horizontal position of the touch in actual device pixels, starting from the left of the screen in its current orientation.
y The vertical position of the touch in actual device pixels, starting from the top of the screen in its current orientation.
click('phone_app.png', rotation=90)
Perform a click event on the center point on the expected screen region.
If the screen region want to click not found in the current screen snapshot will do nothing
rotation: 0, 90, 180, 270
'''
if args:
if isinstance(args[0], types.IntType):
self.__click_point(*args, **kwargs)
return self
if isinstance(args[0], types.StringType):
self.__click_image(*args, **kwargs)
return self
def __click_point(self, x, y, waittime=1):
'''
click x,y
'''
self.d.click(x, y)
time.sleep(waittime)
def __click_image(self, imagename, waittime=1, threshold=0.01, rotation=0):
'''
if the wanted image found on current screen click it.
if the wanted image not found raise exception and set test to be failure.
'''
expect_image_path = None
current_image_path = None
if os.path.isabs(imagename):
expect_image_path = imagename
current_image_path = join(self.report_dir_path,
os.path.basename(imagename))
else:
expect_image_path = join(self.right_dir_path, imagename)
current_image_path = join(self.report_dir_path, imagename)
assert os.path.exists(
expect_image_path
), 'the local expected image %s not found!' % expect_image_path
self.d.screenshot(current_image_path)
assert os.path.exists(
current_image_path
), 'fetch current screen shot image %s failed!' % imagename
pos = getMatchedCenterOffset(subPath=expect_image_path,
srcPath=current_image_path,
threshold=0.01,
rotation=rotation)
if not pos:
reason = 'Fail Reason: The wanted image \'%s\' not found on screen!' % imagename
raise ExpectException(expect_image_path, current_image_path,
reason)
self.d.click(pos[0], pos[1])
time.sleep(waittime)
def screenshot_common(self, filename):
'''
if SK version <= 16
Capture the screenshot via adb and store it in the specified location.
'''
png = os.path.basename(filename)
if self.serial:
shell('adb -s %s shell screencap %s%s' %
(self.serial, self._internal_storage_dir, png))
shell('adb -s %s pull %s%s %s' %
(self.serial, self._internal_storage_dir, png, filename))
else:
shell('adb shell screencap %s%s' %
(self._internal_storage_dir, png))
shell('adb pull %s%s %s' %
(self._internal_storage_dir, png, filename))
return True
#inspect
def exists(self, **kwargs):
'''
if the expected component exists on current screen layout return true else return false.
@rtype: boolean
@return: return True f the expected component exists on current screen layout, else return false.
'''
return self.d.exists(**kwargs)
def expect(self, imagename, interval=2, timeout=4, threshold=0.01, msg=''):
'''
if the expected image found on current screen return self
else raise exception. set test to be failure.
@type imagename: sting
@param imagename: the name of picture which expected to find in current screenshot.
@type interval: int
@param iinterval: the value of interval time
@type timeout: int
@param timeout: the value of timeout
@type threshold: float
@param threshold: the value of threshold. 0.0~1.0
@type msg: string
@param msg: the prompt message content when the expected image not found on current screenshot
'''
expect_image_path = None
current_image_path = None
if os.path.isabs(imagename):
expect_image_path = imagename
current_image_path = join(self.report_dir_path,
os.path.basename(imagename))
else:
expect_image_path = join(self.right_dir_path, imagename)
current_image_path = join(self.report_dir_path, imagename)
assert os.path.exists(
expect_image_path
), 'the local expected image %s not found!' % expect_image_path
begin = time.time()
while (time.time() - begin < timeout):
self.d.screenshot(current_image_path)
if isMatch(expect_image_path, current_image_path, threshold):
return self
time.sleep(interval)
reason = msg if msg else 'Fail Reason: Image \'%s\' not found on screen!' % imagename
raise ExpectException(expect_image_path, current_image_path, reason)
def find(self, imagename, interval=2, timeout=4, threshold=0.01):
'''
if the expected image found on current screen return true else return false
@type imagename: sting
@param imagename: the name of picture which expected to find in current screenshot.
@type interval: int
@param iinterval: the value of interval time
@type timeout: int
@param timeout: the value of timeout
@type threshold: float
@param threshold: the value of threshold. 0.0~1.0
@type msg: string
@param msg: the prompt message content when the expected image not found on current screenshot
@rtype: boolean
@return: return True f the expected image found exists on current screenshot, else return false.
'''
expect_image_path = None
current_image_path = None
if os.path.isabs(imagename):
expect_image_path = imagename
current_image_path = join(self.report_dir_path,
os.path.basename(imagename))
else:
expect_image_path = join(self.right_dir_path, imagename)
current_image_path = join(self.report_dir_path, imagename)
assert os.path.exists(
expect_image_path
), 'the local expected image %s not found!' % expect_image_path
begin = time.time()
isExists = False
while (time.time() - begin < timeout):
#time.sleep(interval)
self.d.screenshot(current_image_path)
isExists = isMatch(expect_image_path, current_image_path,
threshold)
if not isExists:
time.sleep(interval)
continue
break
return isExists
def TODOinstallPackage(self, **kwargs):
pass
def TODOremovePackage(self, **kwargs):
pass
class UiTestLib(object):
"""Ui Test Lib
"""
def __init__(self, serial=None):
"""
"""
logger.info('<p>Device=%s>' % serial, html=True)
print '<p>Device=%s>' % serial
self._result = ''
self.starttime = 0
self.d = Device(serial)
self.adb = Adb(serial)
self.debug = 'True'
def set_debugable(flag):
self.debug = flag
def set_serial(self, serial):
"""Specify given *serial* device to perform test.
or export ANDROID_SERIAL=CXFS42343 if you have many devices connected but you don't use this
interface
When you need to use multiple devices, do not use this keyword to switch between devices in test execution.
And set the serial to each library.
Using different library name when importing this library according to
http://robotframework.googlecode.com/hg/doc/userguide/RobotFrameworkUserGuide.html?r=2.8.5.
Examples:
| Setting | Value | Value | Value |
| Library | UiTestLib | WITH NAME | Mobile1 |
| Library | UiTestLib | WITH NAME | Mobile2 |
And set the serial to each library.
| Test Case | Action | Argument |
| Multiple Devices | Mobile1.Set Serial | device_1's serial |
| | Mobile2.Set Serial | device_2's serial |
"""
self.d = Device(serial)
self.adb = Adb(serial)
def logmsg(self, msg):
if self.debug == 'True':
print msg
def exe_adb_command(self, cmd):
""" Execute adb *cmd*
Examples:
| Exe Adb Command | shell getprop |
"""
return self.adb.cmd(cmd).wait()
def exe_adb_and_result(self, cmd):
"""Execute adb *cmd* and return lines of the command"""
lproc = self.adb.cmd(cmd)
lproc.poll()
lines = lproc.stdout.readlines()
return lines
def get_device_info(self):
"""Get Device information
return info dictionary
"""
return self.d.info
def light_screen(self):
"""Light screen by wakeup.
Examples:
| Action |
|Light screen|
Use `Light screen` to light screen.
"""
self.d.wakeup()
self._result = self.d.press.home()
def open_application(self, appname):
"""Open application by it name `appname`.
Example:
| Action | Argument |
| Open application | "com.android.settings/com.android.settings.Settings" |
"""
appname = 'shell am start -n ' + appname
print 'Open Application:', appname
self._result = self.exe_adb_command(appname)
def click_text(self, text, instance=0):
"""Click text label on screen
instance=0 is default, change when you needed.
Example:
| Action | Argument | Argument |
| Click Text | text | instance |
"""
return self.d(text=text, instance=instance).click.wait()
def long_click_text(self, text, instance=0):
"""
Long Click text label on screen, *text* and *instance=0*
Example:
| Action | Argument | Argument |
| Long Click Text | text | instance |
"""
return self.d(text=text, instance=instance).long_click()
def long_click_ui(self, **selectors):
"""
Long Click on **selectors**
Selector supports below parameters. Refer to UiSelector java doc for detailed information.
text, textContains, textMatches, textStartsWith
className, classNameMatches
description, descriptionContains, descriptionMatches, descriptionStartsWith
checkable, checked, clickable, longClickable
scrollable, enabled,focusable, focused, selected
packageName, packageNameMatches
resourceId, resourceIdMatches
index, instance
Example:
| Action | Argument | Argument | Argument |
| Long Click UI | text=XXXX | className=XXX.xxxx | resourceId=xxxxxx |
"""
return self.d(**selectors).long_click()
def text_display_on_screen_contains(self, text):
"""Verify text display on screen
Example:
| Action | Argument |
|Text display on screen is| text |
"""
if self.d(text=text).exists:
self._result = True
return True
else:
self._result = False
return False
def object_display_on_screen(self, obj, timeout=5000):
""" Verify *obj* UiObject display on screen
return to self._result
Example:
| Action | Argument |
|Object display on screen | obj |
"""
if obj.wait.exists(timeout):
self._result = True
return True
else:
self._result = False
return False
def assert_expectation(self, expect, actual):
"""
Assert Expectation and actual value
Example:
| Action | args | args |
| Assert Expectation | 324324 | ${actual} |
"""
if str(expect) != str(actual):
raise AssertionError(
'Actual result is = %s, but expectation is: %s' %
(str(actual), str(expect)))
def assert_true(self, condition):
"""
Assert True of *condition
Example:
|Assert True | condition |
"""
if str(condition) != 'True': #because only string from robotframework
raise AssertionError('Result is = %s' % str(condition))
def assert_result_true(self):
"""
Assert True of *self._result
Example:
|Assert True |
"""
if self._result != True:
raise AssertionError('Result is = %s' % str(self._result))
def wait_for_ui_exists(self, timeout, **selectors):
"""
Return True if
Selector is to identify specific ui object in current window.
# To seleted the object ,text is 'Clock' and its className is 'android.widget.TextView'
wait_for_ui_exists(text='Clock', className='android.widget.TextView')
Selector supports below parameters. Refer to UiSelector java doc for detailed information.
text, textContains, textMatches, textStartsWith
className, classNameMatches
description, descriptionContains, descriptionMatches, descriptionStartsWith
checkable, checked, clickable, longClickable
scrollable, enabled,focusable, focused, selected
packageName, packageNameMatches
resourceId, resourceIdMatches
index, instance
Examples:
| Action | Argument | Argument | Argument | Argument |
|Wait For UI Exists | timeout | text=XXXX | className=XXX.xxxx | resourceId=xxxxxx |
"""
self._result = self.d(**selectors).wait.exists(timeout=int(timeout))
return self._result
def wait_and_click(self, timeout, **selectors):
"""Wait for uiselector and click"""
if self.d(**selectors).wait.exists(timeout=int(timeout)):
self.d(**selectors).click()
def assert_ui_exists(self, **selectors):
"""
Assert UiObject appear on the screen
Examples:
| Action | Argument | Argument | Argument | Argument |
|Assert UI Exists | timeout | text=XXXX | className=XXX.xxxx | resourceId=xxxxxx |
"""
if not self.d(**selectors).wait.exists():
raise AssertionError('UiObject does not exists %s' %
selectors.items())
def result_should_be(self, expected):
"""Verifies that the current result is `expected`.
Example:
| Action | Argument |
| Open application | com.android.settings/com.android.settings.Settings |
| Result Should Be | 0 |
"""
print('result is: %s\n', self._result)
print('ex is: %s\n', expected)
if str(self._result) != expected:
raise AssertionError('%s != %s' % (self._result, expected))
def click_at_coordinates(self, x, y):
""" Click at (x,y) coordinates.
Example:
| Action | Argument | Argument |
| Click At Corrdinates | x | y |
"""
return self.d.click(int(x), int(y))
def long_click_at_coordinates(self, x, y):
"""
# long click (x, y) on screen
"""
return self.d.long_click(int(x), int(y))
def swipe(self, sx, sy, ex, ey, steps=20):
"""
Swipe from (sx,sy) to (ex,ey)
"""
return self.d.swipe(int(sx), int(sy), int(ex), int(ex), int(steps))
def drag(self, sx, sy, ex, ey, steps=20):
"""
Drag from (sx,sy) to (ex,ey)
"""
return self.d.drag(int(sx), int(sy), int(ex), int(ex), int(steps))
def freeze_rotation(self, rotation=True):
"""
Freeze rotation,
*rotation*, True is default,
"""
return self.d.freeze_rotation(rotation)
def set_rotation(self, rotation):
"""
# retrieve orientation,
# it should be "natural" or "left" or "right" or "upsidedown"
Example:
| Action | Argument |
| Set Rotation | nature |
| Set Rotation | left |
| Set Rotation | right |
| Set Rotation | upsidedown |
"""
orientation = self.d.orientation
if rotation == "nature":
self.d.orientation = "n" # or "natural"
elif rotation == "left":
self.d.orientation = "l" # or "left"
elif rotation == "right":
self.d.orientation = "r" # or "right"
elif rotation == "upsidedown":
self.d.orientation = "upsidedown" # or "upsidedown"
else:
self.d.rotation = "n"
def take_screenshot(self, scale=None, quality=None):
"""
Take a screenshot of device and log in the report with timestamp, scale for screenshot size and quality for screenshot quality
default scale=1.0 quality=100
Example:
| Action | Argument | Argument |
| Take Screenshot | 0.5 | 80 |
"""
output_dir = BuiltIn().get_variable_value('${OUTPUTDIR}')
ts = time.time()
st = datetime.datetime.fromtimestamp(ts).strftime('%Y%m%d%H%M%S')
screenshot_path = '%s%s%s.png' % (output_dir, os.sep, st)
screenshot_name = '%s%s.png' % (os.sep, st)
self.d.screenshot(screenshot_path, scale, quality)
logger.info('\n<a href="%s">%s</a><br><img src="%s">' %
(screenshot_path, st, screenshot_name),
html=True)
def open_notification(self):
"""
Open notification of the phone
"""
self.d.open.notification()
def wait_window_update(self):
"""
wait for window update
"""
return self.d.wait.update()
def wait_window_idle(self):
"""
wait for window idle
"""
return self.d.wait.idle()
def remove_watchers(self):
"""
Remove UI watchers
"""
self.d.watchers.remove()
def get_device(self):
"""
Get device object, you can do any command using this
"""
return self.d
def click_id(self, id, instance=0):
"""
Click *id* with *instance*=0
"""
return self.d(resourceId=id, instance=instance).click.wait()
def long_click_id(self, id, instance=0):
"""
Long click *id* with *instance*=0
"""
return self.d(resourceId=id, instance=0).long_click()
def click_description(self, description, instance=0):
"""
Click *description* with *instance*=0
"""
return self.d(description=description, instance=instance).long_click()
def click_class(self, className, instance=0):
"""
Click *className* with *instance*=0
"""
return self.d(className=className, instance=instance).long_click()
def type_text(self, textStr, **selectors):
"""
type text on selectors
like text=EditName
"""
self.d(**selectors).set_text(textStr)
def press_key(self, key):
""" Press Key of following value
home
back
left
right
up
down
center
menu
search
enter
delete(or del)
recent(recent apps)
volume_up
volume_down
volume_mute
camera
power
Examples:
| Action | Argument |
| Press Key | home |
| Press Key | back |
| Press Key | left |
| Press Key | right |
| Press Key | recent |
| Press Key | volume_up |
| Press Key | camera |
"""
if key.isdigit():
return self.d.press(int(key))
return self.d.press(key)
def phone_sleep(self, timeout):
"""
android device sleep with timeout in ms, don't use for executor sleep,
"""
return self.d.wait(int(timeout))
def execute_command(self, cmd, block_parent_process=True):
"""
Execute shell *cmd* command, with block_parent_process = True
If block_parent_process = False, kill_command is needed to terminal the child process
Example:
| Execute Command | ping -c 5 127.0.0.1 |
"""
if str(block_parent_process) == str(True):
return subprocess.Popen(cmd,
shell=True,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE).communicate()
else:
return subprocess.Popen(cmd,
shell=True,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE)
def kill_command(self, process, timeout=0):
""" Kill child *process* in timeout seconds
Some bugs after process teminated
"""
time.sleep(float(timeout))
process.terminate()
def wait_for_logcat(self, log, timeout=30):
""" Wait log exists in given timeout, return True if have, otherwise will return False
log is your want to search, log can be a regular expression
time in seconds, default value is 30 seconds
Example:
| Wait For Logcat | .*ActivityManager.*cmp=com.sonyericsson.album/com.sonyericsson.album.Main.* |
"""
start = time.time()
while (time.time() - start) < int(timeout):
log_proc = self.adb.cmd("logcat -d -v time")
returncode = log_proc.poll()
lines = log_proc.stdout.readlines()
for line in lines:
rlt = re.search(log, line.rstrip())
if rlt is not None:
print rlt.group(0)
self._result = True
return True
time.sleep(2) #sleep 2s to wait
self._result = False
return False
def clear_logcat(self):
"""
Clear logcat, it's often used before you want to use *wait_for_logcat()*
"""
print "Clear logcat before test"
return self.exe_adb_command("logcat -c")
def click_object(self, obj):
""" Click UiObject *obj*
Exmaple:
| ${result} | Get UI Object | text=XXX | className=xxxx |
| Click Object | ${result} |
"""
obj.click()
def click_ui(self, **selectors):
"""
Click selector
click_selector(text="Home", resourceId = "android:id/title")
for **selector, please refer *get_ui_object()*
Selector supports below parameters. Refer to UiSelector java doc for detailed information.
text, textContains, textMatches, textStartsWith
className, classNameMatches
description, descriptionContains, descriptionMatches, descriptionStartsWith
checkable, checked, clickable, longClickable
scrollable, enabled,focusable, focused, selected
packageName, packageNameMatches
resourceId, resourceIdMatches
index, instance
Operation for a UiObjects:
click, clear_text, drag(obj).to(**selector), gesture, exists, set_text, long_click
pinch.In(percent=100, steps=10), pinch.Out(percent=100, steps=100),.swipe.right(),
.swipe.left(steps=10),.swipe("right", steps=20),.wait.gone(),.wait.exists()
"""
print "selectors:", selectors
return self.d(**selectors).click()
def get_ui_object(self, **selectors):
"""
Get UI object with *selectors*
you can do anything on UiObject, like click(), long_click(),wait.exists(timeout)
examples: get_ui_object(text="Home", resourceId = "android:id/title")
Selector supports below parameters. Refer to UiSelector java doc for detailed information.
text, textContains, textMatches, textStartsWith
className, classNameMatches
description, descriptionContains, descriptionMatches, descriptionStartsWith
checkable, checked, clickable, longClickable
scrollable, enabled,focusable, focused, selected
packageName, packageNameMatches
resourceId, resourceIdMatches
index, instance
Operation for a UiObjects:
click, clear_text, drag(obj).to(**selector), gesture, exists, set_text, long_click
pinch.In(percent=100, steps=10), pinch.Out(percent=100, steps=100),.swipe.right(),
.swipe.left(steps=10),.swipe("right", steps=20),.wait.gone(),.wait.exists()
Exmaple:
| ${result} | Get UI Object | text=XXX | className=xxxx |
"""
self._result = self.d(**selectors)
return self._result
def wait_for_object_exists(self, obj, timeout=0):
"""
Wait for UiObject *obj* exists in *timeout*= 0
Example:
| ${result} | Get UI Object | text=XXX | className=xxxx |
| Wait For Object Exists | ${result} | timeout |
"""
self._result = obj.wait.exists(timeout=int(timeout))
return self._result
def wait_for_ui_gone(self, timeout=0, **selectors):
"""
Wait for UiObject *obj* gone in *timeout*= 0
Example:
| ${result} | Get UI Object | text=XXX | className=xxxx |
| Wait For Object Gone | ${result} | timeout |
"""
self._result = self.d(**selectors).wait.gone(timeout=int(timeout))
return self._result
def get_key_value(self, key, dictionary):
"""
Get key value of dictionary
"""
return dictionary(key)
def get_tts(self, input_text, delete_file=False, **args):
"""
Get TTS voice mp3 from Google
get_tts(input_text='tunnel snakes rule apparently', args = {'language':'en','output':'outputto.mp3'})
Robot Framework:
Examples:
| Action | Argument | Argument | Argument | Argument |
| UiTestLib.Get TTS | Hello world | False | output=ooo.mp3 | language=en |
"""
print "Get text to speech: ", input_text
downloaded = False
if str(delete_file) == 'True':
if os.path.exists(args['output']):
os.remove(args['output'])
if os.path.exists(args['output']):
if os.path.getsize(args['output']) <= 0:
os.remove(args['output'])
if args['output'] is not None:
if not os.path.exists(args['output']):
print 'Generating mp3 file......', args['output']
downloaded = GoogleTTS.audio_extract(input_text, args)
else:
print 'Have same local file'
downloaded = True
if not downloaded:
print "Downloaded TTS from Google failed, trying to download from local FTP..."
mp3file = open(args['output'], 'w')
mp3url = 'ftp://cnbjlx9548/atautomation/Test-Content/Croft/' + args[
'output']
try:
resp = urllib2.urlopen(mp3url, timeout=40)
mp3file.write(resp.read())
time.sleep(.05)
except Exception, e:
print e
return False
mp3file.close()
return True
class Mobile():
def __init__(self):
self.set_serial(None)
def set_serial(self, android_serial):
"""
Specify given *android_serial* device to perform test.
You do not have to specify the device when there is only one device connects to the computer.
When you need to use multiple devices, do not use this keyword to switch between devices in test execution.
Using different library name when importing this library according to http://robotframework.googlecode.com/hg/doc/userguide/RobotFrameworkUserGuide.html?r=2.8.5.
| Setting | Value | Value | Value |
| Library | Mobile | WITH NAME | Mobile1 |
| Library | Mobile | WITH NAME | Mobile2 |
And set the serial to each library.
| Test Case | Action | Argument |
| Multiple Devices | Mobile1.Set Serial | device_1's serial |
| | Mobile2.Set Serial | device_2's serial |
"""
self.adb = ADB(android_serial)
self.device = Device(android_serial)
self.test_helper = TestHelper(self.adb)
def get_device_info(self):
"""
Retrieve the device info.
The keyword will return a dictionary.
You can log the information by using the log dictionary keyword in build in Collections library(http://robotframework.googlecode.com/hg/doc/libraries/Collections.html?r=2.8.4).
Example:
| ${device_info} | Get Device Info |
| Log Dictionary | ${device_info} |
=>
Dictionary size is 9 and it contains following items:\n
currentPackageName: com.android.keyguard\n
displayHeight: 1776\n
displayRotation: 0\n
displaySizeDpX: 360\n
displaySizeDpY: 640\n
displayWidth: 1080\n
naturalOrientation: True\n
productName: hammerhead\n
sdkInt: 19\n
Or get specific information of the device by giving the key.
| ${device_info} | Get Device Info | | |
| ${product_name} | Get From Dictionary | ${device_info} | productName |
=>
${product_name} = hammerhead
"""
return self.device.info
#Key Event Actions of the device
"""
Turn on/off screen
"""
def turn_on_screen(self):
"""
Turn on the screen.
"""
self.device.screen.on()
def turn_off_screen(self):
"""
Turn off the screen.
"""
self.device.screen.off()
"""
Press hard/soft key
"""
def press_key(self, *keys):
"""
Press *key* keycode.
You can find all keycode in http://developer.android.com/reference/android/view/KeyEvent.html
"""
#not tested
self.device.press(*keys)
def press_home(self):
"""
Press home key.
"""
self.device.press.home()
def press_back(self):
"""
Press back key.
"""
self.device.press.back()
def press_left(self):
"""
Press left key.
"""
self.device.pres.left()
def press_right(self):
"""
Press right key.
"""
self.device.press.right()
def press_up(self):
"""
Press up key.
"""
self.device.press.up()
def press_down(self):
"""
Press down key.
"""
self.device.press.down()
def press_center(self):
"""
Press center key.
"""
self.device.press.center()
def press_menu(self):
"""
Press menu key.
"""
self.device.press.menu()
def press_search(self):
"""
Press search key.
"""
self.device.press.search()
def press_enter(self):
"""
Press enter key.
"""
self.device.press.enter()
def press_delete(self):
"""
Press delete key.
"""
self.device.press.delete()
def press_recent(self):
"""
Press recent key.
"""
self.device.press.recent()
def press_volume_up(self):
"""
Press volume up key.
"""
self.device.press.volume_up()
def press_volume_down(self):
"""
Press volume down key.
"""
self.device.press.volume_down()
def press_camera(self):
"""
Press camera key.
"""
self.device.press.camera()
def press_power(self):
"""
Press power key.
"""
self.device.press.power()
#Gesture interaction of the device
def click_at_coordinates(self, x, y):
"""
Click at (x,y) coordinates.
"""
self.device.click(int(x), int(y))
def swipe_by_coordinates(self, sx, sy, ex, ey, steps=10):
"""
Swipe from (sx, sy) to (ex, ey) with *steps* .
Example:
| Swipe By Coordinates | 540 | 1340 | 940 | 1340 | | # Swipe from (540, 1340) to (940, 100) with default steps 10 |
| Swipe By Coordinates | 540 | 1340 | 940 | 1340 | 100 | # Swipe from (540, 1340) to (940, 100) with steps 100 |
"""
self.device.swipe(sx, sy, ex, ey, steps)
# Swipe from the center of the ui object to its edge
def swipe_left(self, steps=10, *args, **selectors):
"""
Swipe the UI object with *selectors* from center to left.
Example:
| Swipe Left | description=Home screen 3 | | # swipe the UI object left |
| Swipe Left | 5 | description=Home screen 3 | # swipe the UI object left with steps=5 |
See `introduction` for details about Identified UI object.
"""
self.device(**selectors).swipe.left(steps=steps)
def swipe_right(self, steps=10, *args, **selectors):
"""
Swipe the UI object with *selectors* from center to right
See `Swipe Left` for more details.
"""
self.device(**selectors).swipe.right(steps=steps)
def swipe_top(self, steps=10, *args, **selectors):
"""
Swipe the UI object with *selectors* from center to top
See `Swipe Left` for more details.
"""
self.device(**selectors).swipe.up(steps=steps)
def swipe_bottom(self, steps=10, *args, **selectors):
"""
Swipe the UI object with *selectors* from center to bottom
See `Swipe Left` for more details.
"""
self.device(**selectors).swipe.down(steps=steps)
def object_swipe_left(self, obj, steps=10):
"""
Swipe the *obj* from center to left
Example:
| ${object} | Get Object | description=Home screen 3 | # Get the UI object |
| Object Swipe Left | ${object} | | # Swipe the UI object left |
| Object Swipe Left | ${object} | 5 | # Swipe the UI object left with steps=5 |
| Object Swipe Left | ${object} | steps=5 | # Swipe the UI object left with steps=5 |
See `introduction` for details about identified UI object.
"""
obj.swipe.left(steps=steps)
def object_swipe_right(self, obj, steps=10):
"""
Swipe the *obj* from center to right
See `Object Swipe Left` for more details.
"""
obj.swipe.right(steps=steps)
def object_swipe_top(self, obj, steps=10):
"""
Swipe the *obj* from center to top
See `Object Swipe Left` for more details.
"""
obj.swipe.up(steps=steps)
def object_swipe_bottom(self, obj, steps=10):
"""
Swipe the *obj* from center to bottom
See `Object Swipe Left` for more details.
"""
obj.swipe.down(steps=steps)
def drag_by_coordinates(self, sx, sy, ex, ey, steps=10):
"""
Drag from (sx, sy) to (ex, ey) with steps
See `Swipe By Coordinates` also.
"""
self.device.drag(sx, sy, ex, ey, steps)
#Wait until the specific ui object appears or gone
# wait until the ui object appears
def wait_for_exists(self, timeout=0, *args, **selectors):
"""
Wait for the object which has *selectors* within the given timeout.
Return true if the object *appear* in the given timeout. Else return false.
"""
return self.device(**selectors).wait.exists(timeout=timeout)
# wait until the ui object gone
def wait_until_gone(self, timeout=0, *args, **selectors):
"""
Wait for the object which has *selectors* within the given timeout.
Return true if the object *disappear* in the given timeout. Else return false.
"""
return self.device(**selectors).wait.gone(timeout=timeout)
def wait_for_object_exists(self, obj, timeout=0):
"""
Wait for the object: obj within the given timeout.
Return true if the object *appear* in the given timeout. Else return false.
"""
return obj.wait.exists(timeout=timeout)
# wait until the ui object gone
def wait_until_object_gone(self, obj, timeout=0):
"""
Wait for the object: obj within the given timeout.
Return true if the object *disappear* in the given timeout. Else return false.
"""
return obj.wait.gone(timeout=timeout)
# Perform fling on the specific ui object(scrollable)
def fling_forward_horizontally(self, *args, **selectors):
"""
Perform fling forward (horizontally)action on the object which has *selectors* attributes.
Return whether the object can be fling or not.
"""
return self.device(**selectors).fling.horiz.forward()
def fling_backward_horizontally(self, *args, **selectors):
"""
Perform fling backward (horizontally)action on the object which has *selectors* attributes.
Return whether the object can be fling or not.
"""
return self.device(**selectors).fling.horiz.backward()
def fling_forward_vertically(self, *args, **selectors):
"""
Perform fling forward (vertically)action on the object which has *selectors* attributes.
Return whether the object can be fling or not.
"""
return self.device(**selectors).fling.vert.forward()
def fling_backward_vertically(self, *args, **selectors):
"""
Perform fling backward (vertically)action on the object which has *selectors* attributes.
Return whether the object can be fling or not.
"""
return self.device(**selectors).fling.vert.backward()
# Perform scroll on the specific ui object(scrollable)
# horizontal
def scroll_to_beginning_horizontally(self, steps=10, *args, **selectors):
"""
Scroll the object which has *selectors* attributes to *beginning* horizontally.
See `Scroll Forward Vertically` for more details.
"""
return self.device(**selectors).scroll.horiz.toBeginning(steps=steps)
def scroll_to_end_horizontally(self, steps=10, *args, **selectors):
"""
Scroll the object which has *selectors* attributes to *end* horizontally.
See `Scroll Forward Vertically` for more details.
"""
return self.device(**selectors).scroll.horiz.toEnd(steps=steps)
def scroll_forward_horizontally(self, steps=10, *args, **selectors):
"""
Perform scroll forward (horizontally)action on the object which has *selectors* attributes.
Return whether the object can be Scroll or not.
See `Scroll Forward Vertically` for more details.
"""
return self.device(**selectors).scroll.horiz.forward(steps=steps)
def scroll_backward_horizontally(self, steps=10, *args, **selectors):
"""
Perform scroll backward (horizontally)action on the object which has *selectors* attributes.
Return whether the object can be Scroll or not.
See `Scroll Forward Vertically` for more details.
"""
return self.device(**selectors).scroll.horiz.backward(steps=steps)
def scroll_to_horizontally(self, obj, *args, **selectors):
"""
Scroll(horizontally) on the object: obj to specific UI object which has *selectors* attributes appears.
Return true if the UI object, else return false.
See `Scroll To Vertically` for more details.
"""
return obj.scroll.horiz.to(**selectors)
# vertical
def scroll_to_beginning_vertically(self, steps=10, *args, **selectors):
"""
Scroll the object which has *selectors* attributes to *beginning* vertically.
See `Scroll Forward Vertically` for more details.
"""
return self.device(**selectors).scroll.vert.toBeginning(steps=steps)
def scroll_to_end_vertically(self, steps=10, *args, **selectors):
"""
Scroll the object which has *selectors* attributes to *end* vertically.
See `Scroll Forward Vertically` for more details.
"""
return self.device(**selectors).scroll.vert.toEnd(steps=steps)
def scroll_forward_vertically(self, steps=10, *args, **selectors):
"""
Perform scroll forward (vertically)action on the object which has *selectors* attributes.
Return whether the object can be Scroll or not.
Example:
| ${can_be_scroll} | Scroll Forward Vertically | className=android.widget.ListView | | # Scroll forward the UI object with class name |
| ${can_be_scroll} | Scroll Forward Vertically | 100 | className=android.widget.ListView | # Scroll with steps |
"""
return self.device(**selectors).scroll.vert.forward(steps=steps)
def scroll_backward_vertically(self, steps=10, *args, **selectors):
"""
Perform scroll backward (vertically)action on the object which has *selectors* attributes.
Return whether the object can be Scroll or not.
See `Scroll Forward Vertically` for more details.
"""
return self.device(**selectors).scroll.vert.backward(steps=steps)
def scroll_to_vertically(self, obj, *args, **selectors):
"""
Scroll(vertically) on the object: obj to specific UI object which has *selectors* attributes appears.
Return true if the UI object, else return false.
Example:
| ${list} | Get Object | className=android.widget.ListView | | # Get the list object |
| ${is_web_view} | Scroll To Vertically | ${list} | text=WebView | # Scroll to text:WebView. |
"""
return obj.scroll.vert.to(**selectors)
#Screen Actions of the device
def get_screen_orientation(self):
"""
Get the screen orientation.
Possible result: natural, left, right, upsidedown
See for more details: https://github.com/xiaocong/uiautomator#screen-actions-of-the-device
"""
return self.device.orientation
def set_screen_orientation(self, orientation):
"""
Set the screen orientation.
Input *orientation* : natural or n, left or l, right or r, upsidedown (support android version above 4.3)
The keyword will unfreeze the screen rotation first.
See for more details: https://github.com/xiaocong/uiautomator#screen-actions-of-the-device
Example:
| Set Screen Orientation | n | # Set orientation to natural |
| Set Screen Orientation | natural | # Do the same thing |
"""
self.device.orientation = orientation
def freeze_screen_rotation(self):
"""
Freeze the screen auto rotation
"""
self.device.freeze_rotation()
def unfreeze_screen_rotation(self):
"""
Un-Freeze the screen auto rotation
"""
self.device.freeze_rotation(False)
def screenshot(self, scale=None, quality=None):
"""
Take a screenshot of device and log in the report with timestamp, scale for screenshot size and quality for screenshot quality
default scale=1.0 quality=100
"""
output_dir = BuiltIn().get_variable_value('${OUTPUTDIR}')
ts = time.time()
st = datetime.datetime.fromtimestamp(ts).strftime('%Y%m%d%H%M%S')
screenshot_path = '%s%s%s.png' % (output_dir, os.sep, st)
self.device.screenshot(screenshot_path, scale, quality)
logger.info('\n<a href="%s">%s</a><br><img src="%s">' %
(screenshot_path, st, screenshot_path),
html=True)
#Watcher
def __unicode_to_dict(self, a_unicode):
a_dict = dict()
dict_item_count = a_unicode.count('=')
for count in range(dict_item_count):
equal_sign_position = a_unicode.find('=')
comma_position = a_unicode.find(',')
a_key = a_unicode[0:equal_sign_position]
if comma_position == -1:
a_value = a_unicode[equal_sign_position + 1:]
else:
a_value = a_unicode[equal_sign_position + 1:comma_position]
a_unicode = a_unicode[comma_position + 1:]
a_dict[a_key] = a_value
return a_dict
def register_click_watcher(self, watcher_name, selectors, *condition_list):
"""
The watcher click on the object which has the *selectors* when conditions match.
"""
watcher = self.device.watcher(watcher_name)
for condition in condition_list:
watcher.when(**self.__unicode_to_dict(condition))
watcher.click(**self.__unicode_to_dict(selectors))
self.device.watchers.run()
def register_press_watcher(self, watcher_name, press_keys,
*condition_list):
"""
The watcher perform *press_keys* action sequentially when conditions match.
"""
def unicode_to_list(a_unicode):
a_list = list()
comma_count = a_unicode.count(',')
for count in range(comma_count + 1):
comma_position = a_unicode.find(',')
if comma_position == -1:
a_list.append(str(a_unicode))
else:
a_list.append(a_unicode[0:comma_position])
a_unicode = a_unicode[comma_position + 1:]
return a_list
watcher = self.device.watcher(watcher_name)
for condition in condition_list:
watcher.when(**self.__unicode_to_dict(condition))
watcher.press(*unicode_to_list(press_keys))
self.device.watchers.run()
def remove_watchers(self, watcher_name=None):
"""
Remove watcher with *watcher_name* or remove all watchers.
"""
if watcher_name == None:
self.device.watchers.remove()
else:
self.device.watchers.remove(watcher_name)
def list_all_watchers(self):
"""
Return the watcher list.
"""
return self.device.watchers
#Selector
def get_object(self, *args, **selectors):
"""
Get the UI object with selectors *selectors*
See `introduction` for details about identified UI object.
Example:
| ${main_layer} | Get Object | className=android.widget.FrameLayout | index=0 | # Get main layer which class name is FrameLayout |
"""
return self.device(*args, **selectors)
def get_child(self, object, *args, **selectors):
"""
Get the child or grandchild UI object from the *object* with *selectors*
Example:
| ${root_layout} | Get Object | className=android.widget.FrameLayout |
| ${child_layout} | Get Child | ${root_layout} | className=LinearLayout |
"""
return object.child(*args, **selectors)
def get_sibling(self, object, *args, **selectors):
"""
Get the sibling or child of sibling UI object from the *object* with *selectors*
Example:
| ${root_layout} | Get Object | className=android.widget.FrameLayout |
| ${sibling_layout} | Get Sibling | ${root_layout} | className=LinearLayout |
"""
return object.sibling(*args, **selectors)
def get_count(self, *args, **selectors):
"""
Return the count of UI object with *selectors*
Example:
| ${count} | Get Count | text=Accessibility | # Get the count of UI object text=Accessibility |
| ${accessibility_text} | Get Object | text=Accessibility | # These two keywords combination |
| ${count} | Get Count Of Object | ${accessibility_text} | # do the same thing. |
"""
obj = self.get_object(**selectors)
return self.get_count_of_object(obj)
# def get_count_of_object(self, obj):
# """
# Return the count of given UI object
#
# See `Get Count` for more details.
# """
# return len(obj)
def get_info_of_object(self, obj, selector=None):
"""
return info dictionary of the *obj*
The info example:
{
u'contentDescription': u'',
u'checked': False,
u'scrollable': True,
u'text': u'',
u'packageName': u'com.android.launcher',
u'selected': False,
u'enabled': True,
u'bounds':
{
u'top': 231,
u'left': 0,
u'right': 1080,
u'bottom': 1776
},
u'className': u'android.view.View',
u'focusable': False,
u'focused': False,
u'clickable': False,
u'checkable': False,
u'chileCount': 1,
u'longClickable': False,
u'visibleBounds':
{
u'top': 231,
u'left': 0,
u'right': 1080,
u'bottom': 1776
}
}
"""
if selector:
return obj.info.get(selector)
else:
return obj.info
def click(self, *args, **selectors):
"""
Click on the UI object with *selectors*
| Click | text=Accessibility | className=android.widget.Button | # Click the object with class name and text |
"""
self.device(**selectors).click()
def click_on_object(self, object):
"""
Click on the UI object which is gained by `Get Object`.
Example:
| ${button_ok} | text=OK | className=android.widget.Button |
| Click on Object | ${button_ok} |
"""
return object.click()
def long_click(self, *args, **selectors):
"""
Long click on the UI object with *selectors*
See `Click` for more details.
"""
self.device(**selectors).long_click()
def call(self, obj, method, *args, **selectors):
"""
This keyword can use object method from original python uiautomator
See more details from https://github.com/xiaocong/uiautomator
Example:
| ${accessibility_text} | Get Object | text=Accessibility | # Get the UI object |
| Call | ${accessibility_text} | click | # Call the method of the UI object 'click' |
"""
func = getattr(obj, method)
return func(**selectors)
def set_text(self, input_text, *args, **selectors):
"""
Set *input_text* to the UI object with *selectors*
"""
self.device(**selectors).set_text(input_text)
def set_object_text(self, input_text, object):
"""
Set *input_text* the *object* which could be selected by *Get Object* or *Get Child*
"""
object.set_text(input_text)
# Other feature
def clear_text(self, *args, **selectors):
"""
Clear text of the UI object with *selectors*
"""
while True:
target = self.device(**selectors)
text = target.info['text']
target.clear_text()
remain_text = target.info['text']
if text == '' or remain_text == text:
break
def open_notification(self):
"""
Open notification
Built in support for Android 4.3 (API level 18)
Using swipe action as a workaround for API level lower than 18
"""
sdk_version = self.device.info['sdkInt']
if sdk_version < 18:
height = self.device.info['displayHeight']
self.device.swipe(1, 1, 1, height - 1, 1)
else:
self.device.open.notification()
def open_quick_settings(self):
"""
Open quick settings
Work for Android 4.3 above (API level 18)
"""
self.device.open.quick_settings()
def sleep(self, time):
"""
Sleep(no action) for *time* (in millisecond)
"""
target = 'wait for %s' % str(time)
self.device(text=target).wait.exists(timeout=time)
def install(self, apk_path):
"""
Install apk to the device.
Example:
| Install | ${CURDIR}${/}com.hmh.api_4.0.apk | # Given the absolute path to the apk file |
"""
self.adb.cmd('install "%s"' % apk_path)
def uninstall(self, package_name):
"""
Uninstall the APP with *package_name*
"""
self.adb.cmd('uninstall %s' % package_name)
def execute_adb_command(self, cmd):
"""
Execute adb *cmd*
"""
return self.adb.cmd(cmd)
def execute_adb_shell_command(self, cmd):
"""
Execute adb shell *cmd*
"""
return self.adb.shell_cmd(cmd)
def type(self, input_text):
"""
[IME]
Type *text* at current focused UI object
"""
self.test_helper.send_set_text_cmd(input_text)
def start_test_agent(self):
"""
[Test Agent]
Start Test Agent Service
"""
cmd = 'am start edu.ntut.csie.sslab1321.testagent/edu.ntut.csie.sslab1321.testagent.DummyActivity'
self.adb.shell_cmd(cmd)
def stop_test_agent(self):
"""
[Test Agent]
Stop Test Agent Service
"""
cmd = 'am broadcast -a testagent -e action STOP_TESTAGENT'
self.adb.shell_cmd(cmd)
def connect_to_wifi(self, ssid, password=None):
"""
[Test Agent]
Connect to *ssid* with *password*
"""
cmd = 'am broadcast -a testagent -e action CONNECT_TO_WIFI -e ssid %s -e password %s' % (
ssid, password)
self.adb.shell_cmd(cmd)
def clear_connected_wifi(self):
"""
[Test Agent]
Clear all existed Wi-Fi connection
"""
cmd = 'am broadcast -a testagent -e action CLEAR_CONNECTED_WIFIS'
self.adb.shell_cmd(cmd)
class UiTestLib(object):
"""Ui Test Lib
"""
def __init__(self, serial=None):
"""
"""
logger.info("<p>Device=%s>" % serial, html=True)
print "<p>Device=%s>" % serial
self._result = ""
self.starttime = 0
self.d = Device(serial)
self.adb = Adb(serial)
self.debug = "True"
def set_debugable(flag):
self.debug = flag
def set_serial(self, serial):
"""Specify given *serial* device to perform test.
or export ANDROID_SERIAL=CXFS42343 if you have many devices connected but you don't use this
interface
When you need to use multiple devices, do not use this keyword to switch between devices in test execution.
And set the serial to each library.
Using different library name when importing this library according to
http://robotframework.googlecode.com/hg/doc/userguide/RobotFrameworkUserGuide.html?r=2.8.5.
Examples:
| Setting | Value | Value | Value |
| Library | UiTestLib | WITH NAME | Mobile1 |
| Library | UiTestLib | WITH NAME | Mobile2 |
And set the serial to each library.
| Test Case | Action | Argument |
| Multiple Devices | Mobile1.Set Serial | device_1's serial |
| | Mobile2.Set Serial | device_2's serial |
"""
self.d = Device(serial)
self.adb = Adb(serial)
def logmsg(self, msg):
if self.debug == "True":
print msg
def exe_adb_command(self, cmd):
""" Execute adb *cmd*
Examples:
| Exe Adb Command | shell getprop |
"""
return self.adb.cmd(cmd).wait()
def exe_adb_and_result(self, cmd):
"""Execute adb *cmd* and return lines of the command"""
lproc = self.adb.cmd(cmd)
lproc.poll()
lines = lproc.stdout.readlines()
return lines
def get_device_info(self):
"""Get Device information
return info dictionary
"""
return self.d.info
def light_screen(self):
"""Light screen by wakeup.
Examples:
| Action |
|Light screen|
Use `Light screen` to light screen.
"""
self.d.wakeup()
self._result = self.d.press.home()
def open_application(self, appname):
"""Open application by it name `appname`.
Example:
| Action | Argument |
| Open application | "com.android.settings/com.android.settings.Settings" |
"""
appname = "shell am start -n " + appname
print "Open Application:", appname
self._result = self.exe_adb_command(appname)
def click_text(self, text, instance=0):
"""Click text label on screen
instance=0 is default, change when you needed.
Example:
| Action | Argument | Argument |
| Click Text | text | instance |
"""
return self.d(text=text, instance=instance).click.wait()
def long_click_text(self, text, instance=0):
"""
Long Click text label on screen, *text* and *instance=0*
Example:
| Action | Argument | Argument |
| Long Click Text | text | instance |
"""
return self.d(text=text, instance=instance).long_click()
def long_click_ui(self, **selectors):
"""
Long Click on **selectors**
Selector supports below parameters. Refer to UiSelector java doc for detailed information.
text, textContains, textMatches, textStartsWith
className, classNameMatches
description, descriptionContains, descriptionMatches, descriptionStartsWith
checkable, checked, clickable, longClickable
scrollable, enabled,focusable, focused, selected
packageName, packageNameMatches
resourceId, resourceIdMatches
index, instance
Example:
| Action | Argument | Argument | Argument |
| Long Click UI | text=XXXX | className=XXX.xxxx | resourceId=xxxxxx |
"""
return self.d(**selectors).long_click()
def text_display_on_screen_contains(self, text):
"""Verify text display on screen
Example:
| Action | Argument |
|Text display on screen is| text |
"""
if self.d(text=text).exists:
self._result = True
return True
else:
self._result = False
return False
def object_display_on_screen(self, obj, timeout=5000):
""" Verify *obj* UiObject display on screen
return to self._result
Example:
| Action | Argument |
|Object display on screen | obj |
"""
if obj.wait.exists(timeout):
self._result = True
return True
else:
self._result = False
return False
def assert_expectation(self, expect, actual):
"""
Assert Expectation and actual value
Example:
| Action | args | args |
| Assert Expectation | 324324 | ${actual} |
"""
if str(expect) != str(actual):
raise AssertionError("Actual result is = %s, but expectation is: %s" % (str(actual), str(expect)))
def assert_true(self, condition):
"""
Assert True of *condition
Example:
|Assert True | condition |
"""
if str(condition) != "True": # because only string from robotframework
raise AssertionError("Result is = %s" % str(condition))
def assert_result_true(self):
"""
Assert True of *self._result
Example:
|Assert True |
"""
if self._result != True:
raise AssertionError("Result is = %s" % str(self._result))
def wait_for_ui_exists(self, timeout, **selectors):
"""
Return True if
Selector is to identify specific ui object in current window.
# To seleted the object ,text is 'Clock' and its className is 'android.widget.TextView'
wait_for_ui_exists(text='Clock', className='android.widget.TextView')
Selector supports below parameters. Refer to UiSelector java doc for detailed information.
text, textContains, textMatches, textStartsWith
className, classNameMatches
description, descriptionContains, descriptionMatches, descriptionStartsWith
checkable, checked, clickable, longClickable
scrollable, enabled,focusable, focused, selected
packageName, packageNameMatches
resourceId, resourceIdMatches
index, instance
Examples:
| Action | Argument | Argument | Argument | Argument |
|Wait For UI Exists | timeout | text=XXXX | className=XXX.xxxx | resourceId=xxxxxx |
"""
self._result = self.d(**selectors).wait.exists(timeout=int(timeout))
return self._result
def wait_and_click(self, timeout, **selectors):
"""Wait for uiselector and click"""
if self.d(**selectors).wait.exists(timeout=int(timeout)):
self.d(**selectors).click()
def assert_ui_exists(self, **selectors):
"""
Assert UiObject appear on the screen
Examples:
| Action | Argument | Argument | Argument | Argument |
|Assert UI Exists | timeout | text=XXXX | className=XXX.xxxx | resourceId=xxxxxx |
"""
if not self.d(**selectors).wait.exists():
raise AssertionError("UiObject does not exists %s" % selectors.items())
def result_should_be(self, expected):
"""Verifies that the current result is `expected`.
Example:
| Action | Argument |
| Open application | com.android.settings/com.android.settings.Settings |
| Result Should Be | 0 |
"""
print ("result is: %s\n", self._result)
print ("ex is: %s\n", expected)
if str(self._result) != expected:
raise AssertionError("%s != %s" % (self._result, expected))
def click_at_coordinates(self, x, y):
""" Click at (x,y) coordinates.
Example:
| Action | Argument | Argument |
| Click At Corrdinates | x | y |
"""
return self.d.click(int(x), int(y))
def long_click_at_coordinates(self, x, y):
"""
# long click (x, y) on screen
"""
return self.d.long_click(int(x), int(y))
def swipe(self, sx, sy, ex, ey, steps=20):
"""
Swipe from (sx,sy) to (ex,ey)
"""
return self.d.swipe(int(sx), int(sy), int(ex), int(ex), int(steps))
def drag(self, sx, sy, ex, ey, steps=20):
"""
Drag from (sx,sy) to (ex,ey)
"""
return self.d.drag(int(sx), int(sy), int(ex), int(ex), int(steps))
def freeze_rotation(self, rotation=True):
"""
Freeze rotation,
*rotation*, True is default,
"""
return self.d.freeze_rotation(rotation)
def set_rotation(self, rotation):
"""
# retrieve orientation,
# it should be "natural" or "left" or "right" or "upsidedown"
Example:
| Action | Argument |
| Set Rotation | nature |
| Set Rotation | left |
| Set Rotation | right |
| Set Rotation | upsidedown |
"""
orientation = self.d.orientation
if rotation == "nature":
self.d.orientation = "n" # or "natural"
elif rotation == "left":
self.d.orientation = "l" # or "left"
elif rotation == "right":
self.d.orientation = "r" # or "right"
elif rotation == "upsidedown":
self.d.orientation = "upsidedown" # or "upsidedown"
else:
self.d.rotation = "n"
def take_screenshot(self, scale=None, quality=None):
"""
Take a screenshot of device and log in the report with timestamp, scale for screenshot size and quality for screenshot quality
default scale=1.0 quality=100
Example:
| Action | Argument | Argument |
| Take Screenshot | 0.5 | 80 |
"""
output_dir = BuiltIn().get_variable_value("${OUTPUTDIR}")
ts = time.time()
st = datetime.datetime.fromtimestamp(ts).strftime("%Y%m%d%H%M%S")
screenshot_path = "%s%s%s.png" % (output_dir, os.sep, st)
screenshot_name = "%s%s.png" % (os.sep, st)
self.d.screenshot(screenshot_path, scale, quality)
logger.info('\n<a href="%s">%s</a><br><img src="%s">' % (screenshot_path, st, screenshot_name), html=True)
def open_notification(self):
"""
Open notification of the phone
"""
self.d.open.notification()
def wait_window_update(self):
"""
wait for window update
"""
return self.d.wait.update()
def wait_window_idle(self):
"""
wait for window idle
"""
return self.d.wait.idle()
def remove_watchers(self):
"""
Remove UI watchers
"""
self.d.watchers.remove()
def get_device(self):
"""
Get device object, you can do any command using this
"""
return self.d
def click_id(self, id, instance=0):
"""
Click *id* with *instance*=0
"""
return self.d(resourceId=id, instance=instance).click.wait()
def long_click_id(self, id, instance=0):
"""
Long click *id* with *instance*=0
"""
return self.d(resourceId=id, instance=0).long_click()
def click_description(self, description, instance=0):
"""
Click *description* with *instance*=0
"""
return self.d(description=description, instance=instance).long_click()
def click_class(self, className, instance=0):
"""
Click *className* with *instance*=0
"""
return self.d(className=className, instance=instance).long_click()
def type_text(self, textStr, **selectors):
"""
type text on selectors
like text=EditName
"""
self.d(**selectors).set_text(textStr)
def press_key(self, key):
""" Press Key of following value
home
back
left
right
up
down
center
menu
search
enter
delete(or del)
recent(recent apps)
volume_up
volume_down
volume_mute
camera
power
Examples:
| Action | Argument |
| Press Key | home |
| Press Key | back |
| Press Key | left |
| Press Key | right |
| Press Key | recent |
| Press Key | volume_up |
| Press Key | camera |
"""
if key.isdigit():
return self.d.press(int(key))
return self.d.press(key)
def phone_sleep(self, timeout):
"""
android device sleep with timeout in ms, don't use for executor sleep,
"""
return self.d.wait(int(timeout))
def execute_command(self, cmd, block_parent_process=True):
"""
Execute shell *cmd* command, with block_parent_process = True
If block_parent_process = False, kill_command is needed to terminal the child process
Example:
| Execute Command | ping -c 5 127.0.0.1 |
"""
if str(block_parent_process) == str(True):
return subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE).communicate()
else:
return subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
def kill_command(self, process, timeout=0):
""" Kill child *process* in timeout seconds
Some bugs after process teminated
"""
time.sleep(float(timeout))
process.terminate()
def wait_for_logcat(self, log, timeout=30):
""" Wait log exists in given timeout, return True if have, otherwise will return False
log is your want to search, log can be a regular expression
time in seconds, default value is 30 seconds
Example:
| Wait For Logcat | .*ActivityManager.*cmp=com.sonyericsson.album/com.sonyericsson.album.Main.* |
"""
start = time.time()
while (time.time() - start) < int(timeout):
log_proc = self.adb.cmd("logcat -d -v time")
returncode = log_proc.poll()
lines = log_proc.stdout.readlines()
for line in lines:
rlt = re.search(log, line.rstrip())
if rlt is not None:
print rlt.group(0)
self._result = True
return True
time.sleep(2) # sleep 2s to wait
self._result = False
return False
def clear_logcat(self):
"""
Clear logcat, it's often used before you want to use *wait_for_logcat()*
"""
print "Clear logcat before test"
return self.exe_adb_command("logcat -c")
def click_object(self, obj):
""" Click UiObject *obj*
Exmaple:
| ${result} | Get UI Object | text=XXX | className=xxxx |
| Click Object | ${result} |
"""
obj.click()
def click_ui(self, **selectors):
"""
Click selector
click_selector(text="Home", resourceId = "android:id/title")
for **selector, please refer *get_ui_object()*
Selector supports below parameters. Refer to UiSelector java doc for detailed information.
text, textContains, textMatches, textStartsWith
className, classNameMatches
description, descriptionContains, descriptionMatches, descriptionStartsWith
checkable, checked, clickable, longClickable
scrollable, enabled,focusable, focused, selected
packageName, packageNameMatches
resourceId, resourceIdMatches
index, instance
Operation for a UiObjects:
click, clear_text, drag(obj).to(**selector), gesture, exists, set_text, long_click
pinch.In(percent=100, steps=10), pinch.Out(percent=100, steps=100),.swipe.right(),
.swipe.left(steps=10),.swipe("right", steps=20),.wait.gone(),.wait.exists()
"""
print "selectors:", selectors
return self.d(**selectors).click()
def get_ui_object(self, **selectors):
"""
Get UI object with *selectors*
you can do anything on UiObject, like click(), long_click(),wait.exists(timeout)
examples: get_ui_object(text="Home", resourceId = "android:id/title")
Selector supports below parameters. Refer to UiSelector java doc for detailed information.
text, textContains, textMatches, textStartsWith
className, classNameMatches
description, descriptionContains, descriptionMatches, descriptionStartsWith
checkable, checked, clickable, longClickable
scrollable, enabled,focusable, focused, selected
packageName, packageNameMatches
resourceId, resourceIdMatches
index, instance
Operation for a UiObjects:
click, clear_text, drag(obj).to(**selector), gesture, exists, set_text, long_click
pinch.In(percent=100, steps=10), pinch.Out(percent=100, steps=100),.swipe.right(),
.swipe.left(steps=10),.swipe("right", steps=20),.wait.gone(),.wait.exists()
Exmaple:
| ${result} | Get UI Object | text=XXX | className=xxxx |
"""
self._result = self.d(**selectors)
return self._result
def wait_for_object_exists(self, obj, timeout=0):
"""
Wait for UiObject *obj* exists in *timeout*= 0
Example:
| ${result} | Get UI Object | text=XXX | className=xxxx |
| Wait For Object Exists | ${result} | timeout |
"""
self._result = obj.wait.exists(timeout=int(timeout))
return self._result
def wait_for_ui_gone(self, timeout=0, **selectors):
"""
Wait for UiObject *obj* gone in *timeout*= 0
Example:
| ${result} | Get UI Object | text=XXX | className=xxxx |
| Wait For Object Gone | ${result} | timeout |
"""
self._result = self.d(**selectors).wait.gone(timeout=int(timeout))
return self._result
def get_key_value(self, key, dictionary):
"""
Get key value of dictionary
"""
return dictionary(key)
def get_tts(self, input_text, delete_file=False, **args):
"""
Get TTS voice mp3 from Google
get_tts(input_text='tunnel snakes rule apparently', args = {'language':'en','output':'outputto.mp3'})
Robot Framework:
Examples:
| Action | Argument | Argument | Argument | Argument |
| UiTestLib.Get TTS | Hello world | False | output=ooo.mp3 | language=en |
"""
print "Get text to speech: ", input_text
downloaded = False
if str(delete_file) == "True":
if os.path.exists(args["output"]):
os.remove(args["output"])
if os.path.exists(args["output"]):
if os.path.getsize(args["output"]) <= 0:
os.remove(args["output"])
if args["output"] is not None:
if not os.path.exists(args["output"]):
print "Generating mp3 file......", args["output"]
downloaded = GoogleTTS.audio_extract(input_text, args)
else:
print "Have same local file"
downloaded = True
if not downloaded:
print "Downloaded TTS from Google failed, trying to download from local FTP..."
mp3file = open(args["output"], "w")
mp3url = "ftp://cnbjlx9548/atautomation/Test-Content/Croft/" + args["output"]
try:
resp = urllib2.urlopen(mp3url, timeout=40)
mp3file.write(resp.read())
time.sleep(0.05)
except Exception, e:
print e
return False
mp3file.close()
return True
class typer():
'''
填写facebook个人详细信息功能。
需要传入设备的IP, 或是deviceID.
函数的作用都能在函数名上看出一二.
开始的时候我写了大量的异常处理代码，想发送到本地服务器上供参考，因为无法发送数据，后来都删掉了.
可以在个人中心的内面检测是否填写了内容，然后根据填写情况调用相应的类函数. 我截了一张图放在服务器上，如果找不到好的获取办法可以用我下面文字识别的方法.
在填写学校时，必须先调用获取生日的类函数，会声明一个成员变量并赋值，供后面计算上学日期和毕业时间的函数使用，不然会报错(这个异常我没有捕获).
'''
def __init__(self, deviceIP):
self.d = Device(deviceIP)
# 因为控制多台设备，所以用设备名命名截图等，不会发生冲突.
self.deviceIP = deviceIP
# 重启app的计数. 超过100次下面的函数中会抛出异常
self.RestartAppTimes = 0
# 几百种大学专业名json文件路径
self.ConcentrationRoad = './Concentration.json'
# 公司图片路径
self.addWorkSrcRoad = './addWork/Position/'
self.srcAddCollege = './homePage/addCollege.png'
# srcAdd开头的除了下面这个都是第一个选择界面的五个填写部分的图片路径，如添加大学，公司。下面这个是用来识别大学专业填写框的demo.
self.srcAddConcetration = './addCollege/AddConcentration.png'
self.srcAddCurrentCity = './homePage/addCurrentCity.png'
self.srcAddHighSchool = './homePage/addHighSchool.png'
self.srcAddHomeTown = './homePage/addHomeTown.png'
self.srcAddRelationship = './homePage/addRelationship.png'
self.srcAddWork = './homePage/addWork.png'
# 这个图片没用到，本是用来捕获网络异常的，因为不能传递数据取消功能，但还是放在这里备用.
self.srcCannotFindASecureConnection = 'CannotFindASecureConnection.png '
# 下面图片的变量名都和要填写或点击部分的占位文字相同，不多解释了.
self.srcCityTown = './addWork/CityTown.png'
self.srcDay = './addHighSchool/Day.png'
self.srcDescription = './addWork/Description.png'
self.srcEditCollegeUI = './addCollege/EditCollege.png'
self.srcEditHighSchoolUI = './addHighSchool/EditHighSchool.png'
self.srcEditRelationship = './addRelationship/EditRelationship.png'
self.srcEditWorkUI = './addWork/EditWork.png'
self.srcEnterYourCollege = './addCollege/EnterYourCollege.png'
self.srcEnterYourCurrentCity = './addCurrentCity/EnterYourCurrentCity.png'
self.srcEnterYourHighSchool = './addHighSchool/EnterYourHighSchool.png'
self.srcEnterYourHomeTown = './addCurrentCity/EnterYourHomeTown.png'
self.srcFirstInSelectUI = 'FirsInAllSelectionUI.png'
self.srcFrom = './addWork/From.png'
self.srcHongKong = './addWork/HongKong.png'
self.srcItsNotAPhysicalPlace = './add/addWork/ItsNotAPhysicalPlace.png'
self.srcMonth = './addHighSchool/Month.png'
self.srcPosition = './addWork/Position.png'
self.srcSave = './homePage/Save.png'
self.srcWhatIsYourRelationshipStatus = './addRelationship/WhatIsYourRelationshipStatus.png'
self.srcWhereDidYouWork = './addWork/WhereDidYouWork.png'
self.srcYear = './addHighSchool/Year.png'
self.srcGraduated = './homePage/Graduated.png'
self.srcEditCurrentCityUI = './addCurrentCity/EditCurrentCity.png'
self.swipeTimes = 0
# 公司列表，注释掉的一行是因为测试时这家公司不再能在facebook上找到.
self.CoporationList = [
{'name': 'ChinaResources', 'position': 'Sales'},
{'name': 'ChinaResourcesVanguard', 'position': 'Sales'},
# {'name': 'GreatFoodHall', 'position': 'CustomerServiceAssistant'},
{'name': 'JUSCO', 'position': 'AdviserSales'},
{'name': 'LaneCrawford', 'position': 'LaneCrawford'},
{'name': 'SeibuDepartmentStores', 'position': 'BeautyConsultant'},
{'name': 'SincereDepartmentStore', 'position': 'Stoker'},
{'name': 'SogoHongKong', 'position': 'Sales'},
{'name': 'Wellcome', 'position': 'ShopAssistant'},
{'name': 'WingOn', 'position': 'SalesAssociate'},
{'name': '裕華國貨', 'position': 'Sales'},
{'name': 'ParknShop', 'position': 'CustomerServiceAssistant'},
]
# 大学列表
self.CollegeList = [
{'name': 'CityUniversityOfHongKong'},
{'name': 'TheChineseUniversityOfHongKong'},
{'name': 'TheEducationUniversityOfHongKong'},
{'name': 'TheHongKongPolytechnicUniversity'},
{'name': 'TheHongKongUniversityOfScienceAndTechnology'},
{'name': 'TheUniversityOfHongKong'},
{'name': 'UniversityOfSunderlandInHongKong'},
{'name': 'HongKongBaptisUniversity'},
]
# 高中列表
self.HighSchoolList = [
{'name': 'Harrow International School'},
{'name': 'Hong Kong Academy'},
{'name': 'HongKong Japanese School'},
{'name': 'Islamic Kasim Tuet Memorial College'},
{'name': 'Kellett School'},
{'name': 'MaryKnoll Convent'},
{'name': 'Munsang College'},
{'name': 'Scared Heart Canossian College'},
{'name': 'South Island School'},
{'name': 'Yew Chung Community College'},
{'name': 'Ying Wa College'},
{'name': 'Chinese International School'},
{'name': 'Delia Memorial School'},
{'name': 'ESF Discovery College'},
{'name': 'German Swiss International School'},
]
# 随机生成的进入公司工作时间.
self.workDate = {
'Day': random.choice([str(i) for i in range(1,31)]),
'Month': random.choice([
'January', 'February', 'March', 'April', 'May',
]),
'Year':2018,
}
def addCollege(self):
'''添加大学信息. 从选择编辑页面开始，编辑页面一共五个，分别是编辑工作信息，中学信息，大学信息，居住城市，婚姻关系，故居。
正常在填完一个内容的时候会回到选择编辑页面. 中途填写失败会抛出异常，异常被上一级捕获，调用重启app函数并重新执行当前填写功能.
'''
try:
self.findEditBlock(self.srcAddCollege)
time.sleep(10)
self.checkCurrentFullOfUI(self.srcEditCollegeUI)
x, y = self.findElement(self.srcEnterYourCollege)
self.raiseIfError(x, y)
data = random.choice(self.CollegeList)
self.clickAndInput(x, y, data['name'])
time.sleep(5)
x, y = self.findElement('./addCollege/'+data['name']+'/'+data['name']+'.png')
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
if self.d(index='6').exists:
self.d.press.back()
time.sleep(3)
self.atSchoolDate = self.calculateDateAtSchool('College')
self.selectDate(True)
x, y = self.findElement(self.srcGraduated)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
x, y = self.findElement(self.srcAddConcetration)
self.raiseIfError(x, y)
with open(self.ConcentrationRoad, 'r') as f:
string = f.read()
concentrationDict = json.loads(string)
concentration = random.choice(concentrationDict['Concentration'])
self.d.swipe(250, 800, 250, 200)
time.sleep(3)
self.clickAndInput(x, y, concentration)
x, y = self.findElement(self.srcSave)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
except UnKnowError:
self.RestartAppAndWalkInEditUI()
self.addCollege()
return
def addCurrentCity(self):
'''添加现居和故居功能，这两个编辑内容可以在同一个页面填写.
填写内容均是香港，写死的，如果需要改可以在下面改.
'''
try:
self.findEditBlock(self.srcAddCurrentCity)
time.sleep(10)
self.checkCurrentFullOfUI(self.srcEditCurrentCityUI)
x, y = self.findElement(self.srcEnterYourCurrentCity)
self.raiseIfError(x, y)
self.clickAndInput(x, y, 'HongKong')
time.sleep(10)
x, y = self.findElement(self.srcHongKong)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
x, y = self.findElement(self.srcEnterYourHomeTown)
self.raiseIfError(x, y)
self.clickAndInput(x, y, 'HongKong')
x, y = self.findElement(self.srcHongKong)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
x, y = self.findElement(self.srcSave)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
except UnKnowError:
self.RestartAppAndWalkInEditUI()
self.addCurrentCity()
return
def addHighSchool(self):
'''添加中学信息'''
try:
self.findEditBlock(self.srcAddHighSchool)
time.sleep(10)
self.checkCurrentFullOfUI(self.srcEditHighSchoolUI)
x, y = self.findElement(self.srcEnterYourHighSchool)
self.raiseIfError(x, y)
data = random.choice(self.HighSchoolList)
self.clickAndInput(x, y, data['name'])
time.sleep(5)
x, y = self.findElement('./addHighSchool/'+data['name']+'/'+data['name']+'.png')
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
if self.d(index='6').exists:
self.d.press.back()
time.sleep(3)
self.atSchoolDate = self.calculateDateAtSchool('HighSchool')
print(self.atSchoolDate )
self.selectDate(True)
x, y = self.findElement(self.srcGraduated)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
x, y = self.findElement(self.srcSave)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
except UnKnowError:
self.RestartAppAndWalkInEditUI()
self.addHighSchool()
return
def addRelationship(self):
'''添加婚姻关系'''
try:
self.findEditBlock(self.srcAddRelationship)
time.sleep(10)
self.checkCurrentFullOfUI(self.srcEditRelationship)
x, y = self.findElement(self.srcWhatIsYourRelationshipStatus)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
if not self.d(index='6').exists:
raise UnKnowError()
self.d(text='Single').click()
time.sleep(3)
x, y = self.findElement(self.srcSave)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
except UnKnowError:
self.RestartAppAndWalkInEditUI()
self.addRelationship()
return
def addWork(self):
'''添加工作信息. 测试过程中发现裕华国货公司页面下的职位发生改变，原来的策略不再适用，注释掉了.
后期填写过程中也可能会发生改变，到时候需要有针对性的修改，或者添加一些新的公司信息和截取对应的图片.
'''
try:
self.findEditBlock(self.srcAddWork)
time.sleep(10)
self.checkCurrentFullOfUI(self.srcEditWorkUI)
x, y = self.findElement(self.srcWhereDidYouWork)
self.raiseIfError(x, y)
data = random.choice(self.CoporationList)
self.clickAndInput(x, y, data['name'])
time.sleep(5)
x, y = self.findElement('./addWork/Position/'+data['name']+'/'+data['name']+'.png')
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
x, y = self.findElement(self.srcPosition)
if x == y == 0:
pass
else:
self.d.click(x, y)
time.sleep(5)
if data['name'] == 'ChinaResourcesVanguard':
self.d.swipe(250, 600, 250, 200)
time.sleep(3)
# if data['name'] == '裕華國貨':
# self.clickAndInput(x, y, data['position'])
# self.d.click(250, 800)
# time.sleep(3)
x, y = self.findElement('./addWork/Position/'+data['name']+'/'+data['position']+'.png')
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
if self.d(index='6').exists:
self.d.press.back()
time.sleep(3)
x, y = self.findElement(self.srcCityTown)
self.clickAndInput(x, y, 'HongKong')
time.sleep(5)
x, y = self.findElement(self.srcHongKong)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
self.selectDate()
x, y = self.findElement(self.srcSave)
self.raiseIfError(x, y)
self.d.click(x, y)
time.sleep(3)
except UnKnowError:
self.RestartAppAndWalkInEditUI()
self.addWork()
return
def calculateDateAtSchool(self, level):
'''根据不同情况计算开始读书和毕业的时间.'''
DATA = {}
dateOne = {}
dateOne['Month'] = 'September'
dateOne['Day'] = 1
if level == 'College':
dateOne['Year'] = self.Birthday['Year'] + 18
else:
dateOne['Year'] = self.Birthday['Year'] + 15
DATA['Start'] = dateOne
dateTwo = {}
if level == 'College':
dateTwo['Year'] = dateOne['Year'] + 4
else:
dateTwo['Year'] = dateOne['Year'] + 3
dateTwo['Month'] = 'July'
dateTwo['Day'] = 1
DATA['End'] = dateTwo
return DATA
def calculateDatePosition(self):
'''根据截图上From的位置计算出选择月份的位置'''
x, y = self.findElement(self.srcFrom)
self.raiseIfError(x, y)
month = (x + 138, y)
year = (x + 64, y)
return (year, month)
def checkCurrentFullOfUI(self, imgobj):
'''比对整张图片是否相同，用来检测是否成功进入编辑页面'''
current = self.d.screenshot('{}.png'.format(self.deviceIP))
time.sleep(2)
result = self.matchImg(current, imgobj, 0.7)
x, y = result['result'] if result else (0, 0)
self.raiseIfError(x, y)
def clickAndInput(self, x, y, data):
'''这里必须降低输入速度, 加入了睡眠随机数'''
if x == y == 0:
pass
else:
self.d.click(x, y)
time.sleep(3)
print('Clicking finished.')
dataList = data.split(' ')
length = len(dataList)
print('the length of data: ' + str(length))
if length > 1:
times = 0
for i in dataList:
times += 1
print('starting input...')
for j in i:
os.popen("adb -s {} shell am broadcast -a ADB_INPUT_TEXT --es msg '{}'".format(self.deviceIP, j))
time.sleep((int(random.random()*10)/10+1))
if times < length:
print('input space.')
os.popen('adb -s {} shell input keyevent 62'.format(self.deviceIP))
print('done!')
time.sleep(3)
print('done!')
else:
os.popen("adb -s {} shell am broadcast -a ADB_INPUT_TEXT --es msg '{}'".format(self.deviceIP, data))
time.sleep(2)
def clickWait(self):
'''检测是否出现app停止运行的情况，点击wait并等待一小会. '''
if self.d(text='wait').exists:
self.d(text='wait').click()
time.sleep(10)
if self.d(text='Thanks').exists:
self.d(text='No Thanks').click()
time.sleep(5)
def findEditBlock(self, imgsrc):
'''用来在第一个选择界面寻找编辑如工作、大学的入口，没找到的时候会向下滑动，超时会抛出异常，由上级承接。
'''
current = self.Myscreenshot()
time.sleep(1)
match_result = self.matchImg(current, imgsrc)
t = time.time()
while match_result == None or match_result['confidence'] < 0.8:
ttt = time.time() - t
print('It waste time: ' + str(int(ttt)))
print('Swiping the screen...')
self.d.swipe(250, 600, 250, 400)
print('has finished swipeing...')
time.sleep(3)
current = self.Myscreenshot()
time.sleep(1)
match_result = self.matchImg(current, imgsrc)
if ttt > 100:
raise UnKnowError()
self.clickWait()
print('Looking for the edit block...')
print('Has done the searching job.')
x, y = match_result['result']
self.d.click(x, y)
time.sleep(5)
def findElement(self, imgsrc):
'''在当前界面内寻找指定的图片位置，如果没找到，返回(0,0)。
'''
current = self.Myscreenshot()
result = self.matchImg(current, imgsrc)
if result == None:
return (0, 0)
else:
return result['result']
def getBirthday(self):
'''从Facebook个人中心获取到用户的生日信息。
使用了图像识别文字库tesseract-ocr.
这里我想过不在RestartApp函数里面调用，但是不好处理，建议修改代码，在外部处理，以类实例调用，并保存起来，避免反复获取。
上述建议只需将RestartApp函数中的调用此函数部分删去，在进行其他任务前以类实例调用一次即可。
需注意facebook界面须在个人中心处，并额外处理app停止运行的情况。
'''
self.d.click(0, 400)
if self.d(textContains="Search in").exists:
self.d(textContains="Search in").click()
else:
raise UnknowError()
time.sleep(5)
if self.d(textContains='In').exists:
self.d(textContains='In').click()
time.sleep(3)
self.d(textContains='In').click()
time.sleep(3)
os.popen('adb -s {} shell input text "Born"'.format(self.deviceIP))
time.sleep(5)
self.d(description='born').click()
time.sleep(5)
current = self.Myscreenshot()
time.sleep(3)
string = pytesseract.image_to_string(Image.open(current))
try:
month, day, year = re.search('Born on ([\w]+) ([\d]+),([\d]+)', string).groups()
except AttributeError:
raise UnknowError()
self.Birthday = {'Year': int(year), 'Month': month, 'Day': int(day)}
self.d.press.back()
time.sleep(4)
self.d.press.back()
time.sleep(4)
self.d.press.back()
def matchImg(self, imgsrc, imgobj, confidence=0.5):
'''此函数用来识别一张图片在另一张图片中的位置，返回一个字典.
使用方法稍作尝试便知，使用的算法我也有，不依赖于aircv模块。
'''
imsrc = ac.imread(imgsrc)
imobj = ac.imread(imgobj)
match_result = ac.find_template(imsrc, imobj, confidence)
if match_result is not None:
match_result['shape']=(imsrc.shape[1],imsrc.shape[0])
return match_result
def Myscreenshot(self):
'''截图并以设备id或ip为图片名保存'''
current = self.d.screenshot('{}.png'.format(self.deviceIP))
return current
def partOfChooseDate(self, src, data):
'''供selectDate函数调用'''
x, y = self.findElement(src)
self.raiseIfError(x, y)
self.swipeAndClick(x, y, data)
def raiseIfError(self, x, y):
'''重复调用, 用来抛出异常到上级'''
if x == y == 0:
raise UnKnowError()
def RestartAppAndWalkInEditUI(self):
'''重启app并进入到选择五种编辑信息界面. '''
self.RestartAppTimes += 1
if self.RestartAppTimes > 100:
raise CheckOutError()
os.popen('adb -s {} shell am force-stop com.facebook.katana'.format(self.deviceIP))
time.sleep(5)
os.popen('adb -s {} shell am start -n com.facebook.katana/.LoginActivity'.format(self.deviceIP))
time.sleep(30)
if self.d(descriptionContains='More').exists:
self.d(descriptionContains='More').click()
time.sleep(3)
else:
self.RestartAppAndWalkInEditUI()
return
if self.d(descriptionContains='View your profile').exists:
self.d(descriptionContains='View your profile').click()
time.sleep(5)
self.clickWait()
else:
self.RestartAppAndWalkInEditUI()
return
try:
self.getBirthday()
except UnKnowError:
self.RestartAppAndWalkInEditUI()
return
t = time.time()
ttt = 0
while not self.d(description='ADD DETAILS ABOUT YOU').exists and not self.d(text='EDIT DETAILS').exists and ttt < 100:
ttt = time.time() - t
self.d.swipe(250, 600, 250, 200)
time.sleep(3)
self.clickWait()
if ttt > 100:
self.RestartAppAndWalkInEditUI()
return
if self.d(description='ADD DETAILS ABOUT YOU').exists:
self.d(description='ADD DETAILS ABOUT YOU').click()
time.sleep(3)
elif self.d(text='EDIT DETAILS').exists:
self.d(text='EDIT DETAILS').click()
time.sleep(3)
else:
self.RestartAppAndWalkInEditUI()
return
def selectDate(self, signal=False):
'''根据不同参数，处理不同的日期选择, 由于月份的文字长度不同，给定的数值又不能确定，为避免复杂计算，使用了固定坐标添加.
如果树莓派或其他驱动设备的处理性能高，也可以写成依次识别十二个月份图片的方法.'''
# x, y = self.findElement(self.srcFrom)
# self.raiseIfError(x, y)
(year_x, year_y), (month_x, month_y) = self.calculateDatePosition()
print(month_x, month_y)
if signal:
self.swipeAndClick(year_x, year_y, self.atSchoolDate['Start']['Year'])
if signal:
Date = self.atSchoolDate['Start']
else:
Date = self.workDate
print(Date)
self.swipeAndClick(month_x, month_y, Date['Month'])
if Date['Month'] == 'January':
day_x = 290
elif Date['Month'] == 'February':
day_x = 299
elif Date['Month'] == 'March':
day_x = 275
elif Date['Month'] == 'April':
day_x = 260
elif Date['Month'] == 'May':
day_x = 252
elif Date['Month'] == 'June' or Date['Month'] == 'July':
day_x = 259
elif Date['Month'] == 'September':
day_x = 315
day_y = month_y
self.swipeAndClick(day_x, day_y, Date['Day'])
if signal:
self.partOfChooseDate(self.srcYear, self.atSchoolDate['End']['Year'])
self.partOfChooseDate(self.srcMonth, self.atSchoolDate['End']['Month'])
self.partOfChooseDate(self.srcDay, self.atSchoolDate['End']['Day'])
def swipeAndClick(self, x, y, data):
'''功能如函数名, 供选择日期使用.'''
self.d.click(x, y)
time.sleep(3)
if not self.d(index='6').exists:
print('index=6 not exists.')
raise UnKnowError()
for i in range(2):
self.d.swipe(250, 200, 250, 800)
time.sleep(3)
print('swiping to the top.')
t = time.time()
while not self.d(text='{}'.format(data)).exists:
ttt = time.time() - t
self.d.swipe(250, 800, 250, 200)
print('swiping down and looking for the selection.')
time.sleep(3)
self.clickWait()
if ttt > 60:
raise UnKnowError()
print('has fond out.')
self.d(text='{}'.format(data)).click()
time.sleep(3)
if d(text=u'关注').exists:
d(text=u'关注').click.wait() # 点击“关注”
elif d(text=u'进入公众号').exists:
d(text=u'进入公众号').click.wait() # 点击“关注”
else:
log('ERROR "关注" or "进入公众号" not exists...')
# 输入内容
while not d(resourceId='com.tencent.mm:id/a1o').exists:
log('wait for "editText" exists...')
if d(description=u'消息').exists:
log('"message" exists...')
d(description=u'消息').click.wait()
if d(description=u'切换到键盘').exists:
log('"switch to keyboard" exists...')
d(description=u'切换到键盘').click.wait()
d(resourceId='com.tencent.mm:id/a1o').set_text(u'1018') # 输入投票内容
while not d(text=u'发送').exists:
log('wait for "发送" exists...')
time.sleep(0.1)
d(text=u'发送').click.wait() # 点击“发送”
# 截图记录结果
log('screenshot...')
d.screenshot(account + '_' + weixinid + '.png')
# 取消关注（暂时不做，可能不是每个都能取消）
# 退出登录（放在最前面做）
def hold_call(callee):
d=Device(callee.id,adb_server_host='127.0.0.1',adb_server_port=5037)
print "finding the button"
d(resourceId='com.asus.asusincallui:id/holdButton').click()
d.screenshot('incall.png')
print "pressed the button"
class Mobile():
"""
robotframework-uiautomatorlibrary is an Android device testing library for Robot Framework.
It uses uiautomator - Python wrapper for Android uiautomator tool (https://pypi.python.org/pypi/uiautomator/0.1.28) internally.
*Before running tests*
You can use `Set Serial` to specify which device to perform the test.
*Identify UI object*
There are two kinds of keywords.
"""
__version__ = '0.1'
ROBOT_LIBRARY_DOC_FORMAT = 'ROBOT'
ROBOT_LIBRARY_SCOPE = 'GLOBAL'
def set_serial(self, android_serial):
"""
Specify given *android_serial* device to perform test.
You do not have to specify the device when there is only one device connects to the computer.
When you need to use multiple devices, do not use this keyword to switch between devices in test execution.
Using different library name when importing this library according to http://robotframework.googlecode.com/hg/doc/userguide/RobotFrameworkUserGuide.html?r=2.8.4#setting-custom-name-to-test-library.
| Setting | Value | Value | Value |
| Library | Mobile | WITH NAME | Mobile1 |
| Library | Mobile | WITH NAME | Mobile2 |
And set the serial to each library.
| Test Case | Action | Argument |
| Multiple Devices | Mobile1.Set Serial | device_1's serial |
| | Mobile2.Set Serial | device_2's serial |
"""
self.adb = ADB(android_serial)
self.device = Device(android_serial)
self.test_helper = TestHelper(self.adb)
def get_device_info(self):
"""
Retrieve the device info.
The keyword will return a dictionary.
You can log the information by using the log dictionary keyword in build in Collections library(http://robotframework.googlecode.com/hg/doc/libraries/Collections.html?r=2.8.4).
Example:
| ${device_info} | Get Device Info |
| Log Dictionary | ${device_info} |
=>
Dictionary size is 9 and it contains following items:\n
currentPackageName: com.android.keyguard\n
displayHeight: 1776\n
displayRotation: 0\n
displaySizeDpX: 360\n
displaySizeDpY: 640\n
displayWidth: 1080\n
naturalOrientation: True\n
productName: hammerhead\n
sdkInt: 19\n
Or get specific information of the device by giving the key.
| ${device_info} | Get Device Info | | |
| ${product_name} | Get From Dictionary | ${device_info} | productName |
=>
${product_name} = hammerhead
"""
return self.device.info
#Key Event Actions of the device
"""
Turn on/off screen
"""
def turn_on_screen(self):
"""
Turn on screen
"""
self.device.screen.on()
def turn_off_screen(self):
"""
Turn off screen
"""
self.device.screen.off()
"""
Press hard/soft key
"""
def press_key(self, *keys):
"""
Press *key* keycode.
You can find all keycode in http://developer.android.com/reference/android/view/KeyEvent.html
Example:
|Press Key |
"""
self.device.press(*keys)
def press_home(self):
"""
Press home key
"""
self.device.press.home()
def press_back(self):
"""
Press back key
"""
self.device.press.back()
def press_left(self):
"""
Press left key
"""
self.device.pres.left()
def press_right(self):
"""
Press right key
"""
self.device.press.right()
def press_up(self):
"""
Press up key
"""
self.device.press.up()
def press_down(self):
"""
Press down key
"""
self.device.press.down()
def press_center(self):
"""
Press center key
"""
self.device.press.center()
def press_menu(self):
"""
Press menu key
"""
self.device.press.menu()
def press_search(self):
"""
Press search key
"""
self.device.press.search()
def press_enter(self):
"""
Press enter key
"""
self.device.press.enter()
def press_delete(self):
"""
Press delete key
"""
self.device.press.delete()
def press_recent(self):
"""
Press recent key
"""
self.device.press.recent()
def press_volume_up(self):
"""
Press volume up key
"""
self.device.press.volume_up()
def press_volume_down(self):
"""
Press volume down key
"""
self.device.press.volume_down()
def press_camera(self):
"""
Press camera key
"""
self.device.press.camera()
def press_power(self):
"""
Press power key
"""
self.device.press.power()
#Gesture interaction of the device
def click_at_coordinates(self, x, y):
"""
Click at (x,y) coordinates.
"""
self.device.click(x, y)
def swipe_by_coordinates(self, sx, sy, ex, ey, steps=100):
"""
Swipe from (sx, sy) to (ex, ey) with *steps* .
"""
self.device.swipe(sx, sy, ex, ey, steps)
# Swipe from the center of the ui object to its edge
def swipe_left(self, steps=100, *args, **attributes):
"""
Swipe the UI object with *attributes* from center to left.
"""
self.device(**attributes).swipe.left(steps=steps)
def swipe_right(self, steps=100, *args, **attributes):
"""
Swipe the UI object with *attributes* from center to right
"""
self.device(**attributes).swipe.right(steps=steps)
def swipe_top(self, steps=100, *args, **attributes):
"""
Swipe the UI object with *attributes* from center to top
"""
self.device(**attributes).swipe.up(steps=steps)
def swipe_bottom(self, steps=100, *args, **attributes):
"""
Swipe the UI object with *attributes* from center to bottom
"""
self.device(**attributes).swipe.down(steps=steps)
def object_swipe_left(self, obj, steps=100):
"""
Swipe the *obj* from center to left
"""
obj.swipe.left(steps=steps)
def object_swipe_right(self, obj, steps=100):
"""
Swipe the *obj* from center to right
"""
obj.swipe.right(steps=steps)
def object_swipe_top(self, obj, steps=100):
"""
Swipe the *obj* from center to top
"""
obj.swipe.up(steps=steps)
def object_swipe_bottom(self, obj, steps=100):
"""
Swipe the *obj* from center to bottom
"""
obj.swipe.down(steps=steps)
def drag(self,sx, sy, ex, ey, steps=100):
"""
drag from (sx, sy) to (ex, ey) with steps
"""
self.device.drag(sx, sy, ex, ey, steps)
#Wait until the specific ui object appears or gone
# wait until the ui object appears
def wait_for_exists(self, timeout=0, *args, **attribute):
"""
true means the object which has *attribute* exist
false means the object does not exist
in the given timeout
"""
return self.device(**attribute).wait.exists(timeout=timeout)
# wait until the ui object gone
def wait_until_gone(self, timeout=0, *args, **attribute):
"""
true means the object which has *attribute* disappear
false means the object exist
in the given timeout
"""
return self.device(**attribute).wait.gone(timeout=timeout)
def wait_for_object_exists(self, obj, timeout=0):
"""
true means the object exist
false means the object does not exist
in the given timeout
"""
return obj.wait.exists(timeout=timeout)
# wait until the ui object gone
def wait_until_object_gone(self, obj, timeout=0):
"""
true means the object disappear
false means the object exist
in the given timeout
"""
return obj.wait.gone(timeout=timeout)
# Perform fling on the specific ui object(scrollable)
def fling_forward_horizontally(self, obj):
"""
return whether the object can be fling or not
"""
return obj.fling.horiz.forward()
def fling_backward_horizontally(self, obj):
"""
return whether the object can be fling or not
"""
return obj.fling.horiz.backward()
def fling_forward_vertically(self, obj):
"""
return whether the object can be fling or not
"""
return obj.fling.vert.forward()
def fling_backward_vertically(self, obj):
"""
return whether the object can be fling or not
"""
return obj.fling.vert.backward()
# Perform scroll on the specific ui object(scrollable)
def scroll_to_beginning_vertically(self, steps=10, **attributes):
"""
"""
return self.device(**attributes).scroll.vert.toBeginning(steps=steps)
def scroll_to_end_vertically(self, steps=10, **attributes):
"""
"""
return self.device(**attributes).scroll.vert.toEnd(steps=steps)
def scroll_object_to_beginning_vertically(self, obj, steps=10):
"""
"""
return obj.scroll.vert.toBeginning(steps=steps)
def scroll_object_to_end_vertically(self, obj, steps=10):
"""
"""
return obj.scroll.vert.toEnd(steps=steps)
def scroll_forward_horizontally(self, obj, steps=10):
"""
return whether the object can be scroll or not
"""
return obj.scroll.horiz.forward(steps=steps)
def scroll_backward_horizontally(self, obj, steps=10):
"""
return whether the object can be scroll or not
"""
return obj.scroll.horiz.backward(steps=steps)
def scroll_to_horizontally(self, obj, *args,**attribute):
"""
return whether the object can be scroll or not
"""
return obj.scroll.horiz.to(**attribute)
def scroll_forward_vertically(self, obj, steps=10):
"""
return whether the object can be scroll or not
"""
return obj.scroll.vert.forward(steps=steps)
def scroll_backward_vertically(self, obj, steps=10):
"""
return whether the object can be scroll or not
"""
return obj.scroll.vert.backward(steps=steps)
def scroll_to_vertically(self, obj, *args, **attribute):
"""
return whether the object exists or not
"""
return obj.scroll.vert.to(**attribute)
#Screen Actions of the device
def screenshot(self, scale=None, quality=None):
"""
Take a screenshot of device and log in the report with timestamp, scale for screenshot size and quality for screenshot quality
default scale=1.0 quality=100
"""
output_dir = BuiltIn().get_variable_value('${OUTPUTDIR}')
ts = time.time()
st = datetime.datetime.fromtimestamp(ts).strftime('%Y%m%d%H%M%S')
screenshot_path = '%s%s%s.png' % (output_dir, os.sep, st)
self.device.screenshot(screenshot_path, scale, quality)
logger.info('\n<a href="%s">%s</a><br><img src="%s">' % (screenshot_path, st, screenshot_path), html=True)
#Watcher
# def register_click_watcher(self, watcher_name, attributes, *condition_list):
# """
# The watcher click on the object which has the attributes when conditions match
# """
# print type(attributes)
# watcher = self.device.watcher(watcher_name)
# for condition in condition_list:
# watcher.when(**condition)
# watcher.click(**attributes)
# self.device.watchers.run()
# print 'register watcher:%s' % watcher_name
# return
def __unicode_to_dict(self, a_unicode):
a_dict = dict()
dict_item_count = a_unicode.count('=')
for count in range(dict_item_count):
equal_sign_position = a_unicode.find('=')
comma_position = a_unicode.find(',')
a_key = a_unicode[0:equal_sign_position]
if comma_position == -1:
a_value = a_unicode[equal_sign_position + 1:]
else:
a_value = a_unicode[equal_sign_position + 1:comma_position]
a_unicode = a_unicode[comma_position + 1:]
a_dict[a_key] = a_value
return a_dict
def register_click_watcher(self, watcher_name, attributes, *condition_list):
"""
The watcher click on the object which has the *attributes* when conditions match
"""
watcher = self.device.watcher(watcher_name)
for condition in condition_list:
watcher.when(**self.__unicode_to_dict(condition))
watcher.click(**self.__unicode_to_dict(attributes))
self.device.watchers.run()
def register_press_watcher(self, watcher_name, press_keys, *condition_list):
"""
The watcher perform *press_keys* action sequentially when conditions match
"""
def unicode_to_list(a_unicode):
a_list = list()
comma_count = a_unicode.count(',')
for count in range(comma_count + 1):
comma_position = a_unicode.find(',')
if comma_position == -1:
a_list.append(str(a_unicode))
else:
a_list.append(a_unicode[0:comma_position])
a_unicode = a_unicode[comma_position + 1:]
return a_list
watcher = self.device.watcher(watcher_name)
for condition in condition_list:
watcher.when(**self.__unicode_to_dict(condition))
watcher.press(*unicode_to_list(press_keys))
self.device.watchers.run()
def remove_watchers(self, watcher_name = None):
"""
Remove watcher with *watcher_name* or remove all watchers
"""
if watcher_name == None:
self.device.watchers.remove()
else:
self.device.watchers.remove(watcher_name)
def list_all_watchers(self):
"""
return the watcher list
"""
return self.device.watchers
#Selector
def get_object(self, *args, **attribute):
"""
Get the ui object with attribute *attribute*
"""
return self.device(*args, **attribute)
def get_count_of_object(self, obj):
"""
Return the count of given *obj*
"""
return len(obj)
def get_info_of_object(self, obj, attribute=None):
"""
return info dictionary of the *obj*
The info example:
{
u'contentDescription': u'',
u'checked': False,
u'scrollable': True,
u'text': u'',
u'packageName': u'com.android.launcher',
u'selected': False,
u'enabled': True,
u'bounds':
{
u'top': 231,
u'left': 0,
u'right': 1080,
u'bottom': 1776
},
u'className': u'android.view.View',
u'focusable': False,
u'focused': False,
u'clickable': False,
u'checkable': False,
u'chileCount': 1,
u'longClickable': False,
u'visibleBounds':
{
u'top': 231,
u'left': 0,
u'right': 1080,
u'bottom': 1776
}
}
"""
if attribute:
return obj.info.get(attribute)
else:
return obj.info
def click_on(self, *args, **attribute):
"""
click on the object with *attribute*
"""
self.device(**attribute).click()
def long_click_on(self, *args, **attribute):
"""
click on the object with *attribute*
"""
self.device(**attribute).long_click()
def call(self, obj, method, *args, **attribute):
func = getattr(obj, method)
return func(**attribute)
def set_text(self, input_text, *args, **attribute):
"""
set *text* to the Component which has the *attribute*
"""
self.device(**attribute).set_text(input_text)
# Other feature
def clear_text(self, *args, **attributes):
"""
Clear text of the component with *attributes*
"""
while True:
target = self.device(**attributes)
text = target.info['text']
target.clear_text()
remain_text = target.info['text']
if text == '' or remain_text == text:
break
def open_notification(self):
"""
open notification
Built in support for Android 4.3 (API level 18)
Using swipe action as a workaround for API level lower 18
"""
sdk_version = self.device.info['sdkInt']
if sdk_version < 18:
height = self.device.info['displayHeight']
self.device.swipe(1, 1, 1, height - 1, 1)
else:
self.device.open.notification()
def open_quick_settings(self):
"""
open quick settings
Work for Android 4.3 (API level 18)
"""
self.device.open.quick_settings()
def sleep(self, time):
"""
sleep(no action) for *time* (in millisecond)
"""
target = 'wait for %s' % str(time)
self.device(text=target).wait.exists(timeout=time)
def install(self, apk_path):
"""
Install apk to the device
"""
self.adb.cmd('install "%s"' % apk_path)
def uninstall(self, package_name):
"""
Uninstall the APP with *package_name*
"""
self.adb.cmd('uninstall %s' % package_name)
def execute_adb_command(self, cmd):
"""
Execute adb *cmd*
"""
self.adb.cmd(cmd)
def execute_adb_shell_command(self,cmd):
"""
Execute adb shell *cmd*
"""
self.adb.shell_cmd(cmd)
def type(self, text):
"""
Type *text* at current focused component
"""
self.test_helper.send_set_text_cmd(text)
def start_test_agent(self):
"""
[Test Agent]
Start Test Agent Service
"""
cmd = 'am start edu.ntut.csie.sslab1321.testagent/edu.ntut.csie.sslab1321.testagent.DummyActivity'
self.adb.shell_cmd(cmd)
def stop_test_agent(self):
"""
[Test Agent]
Stop Test Agent Service
"""
cmd = 'am broadcast -a testagent -e action STOP_TESTAGENT'
self.adb.shell_cmd(cmd)
def connect_to_wifi(self, ssid, password):
"""
[Test Agent]
Connect to *ssid* with *password*
"""
cmd = 'adb shell am start edu.ntut.csie.sslab1321.testagent/edu.ntut.csie.sslab1321.testagent.DummyActivity'
cmd = 'adb shell am broadcast -a testagent -e action CONNECT_TO_WIFI -e ssid WEP -e password 12345'
cmd = 'am broadcast -a testagent -e action CONNECT_TO_WIFI -e ssid %s -e password %s' % (ssid, password)
self.adb.shell_cmd(cmd)
def clear_connected_wifi(self):
"""
[Test Agent]
Clear all existed Wi-Fi connection
"""
cmd = 'am broadcast -a testagent -e action CLEAR_CONNECTED_WIFIS'
self.adb.shell_cmd(cmd)
def foo(self):
pass
# logger.info('\nGot arg %s %s' % (output_dir, st), also_console=True)
# clm = CommandLineWriter()
# output some messages on console
# clm.message(' ')
# clm.message(u'中文')
# clm.message(u'2----------2')
def test(self):
pass
def TakePhoto(self):
dev = Device(self.Id)
try:
dev(text='相机').click()
time.sleep(2)
for temp4 in range(1000):
print('%sTakePhoto' % (temp4 + 1))
dev(resourceId='com.freeme.camera:id/shutter_button').click()
time.sleep(1)
dev.screenshot(r'%s/screenshot/%sTakePhoto.png' % (self.Id,
(temp4 + 1)))
time.sleep(1)
except Exception, e:
print('error', e)
dev.screenshot(r'%s/error/errorTakePhoto.png' % (self.Id))
dev.press.BACK()
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent HOME')
# 前摄连续拍照
def proactive(self):
dev = Device(self.Id)
try:
dev(text='相机').click()
time.sleep(2)
dev(resourceId='com.freeme.camera:id/camera_toggle_button'
).click()
time.sleep(2)
for temp6 in range(1000):
print('%sproactive' % (temp6 + 1))
dev(resourceId='com.freeme.camera:id/shutter_button'
).click()
time.sleep(1.5)
dev.screenshot(r'%s/screenshot/%sproactive.png' %
(self.Id, (temp6 + 1)))
time.sleep(1)
except Exception, e:
print('error', e)
dev.screenshot(r'%s/error/errorproactive.png')
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent HOME')
#虚化拍照切换
def xuhuaqiehuanpaizhao(self):
dev = Device(self.Id)
try:
dev(text='相机').click()
time.sleep(2)
for temp6 in range(1000):
print('%sxuhuaqiehuanpaizhao' % (temp6 + 1))
dev(resourceId=
'com.freeme.camera:id/freeme_bv_button').click(
)
time.sleep(1.5)
dev(resourceId=
'com.freeme.camera:id/freeme_bv_button').click(
)
time.sleep(1.5)
dev.screenshot(
r'%s/screenshot/%sxuhuaqiehuanpaizhao.png' %
(self.Id, (temp6 + 1)))
time.sleep(1)
except Exception, e:
print('error', e)
dev.screenshot(
r'%s/error/errorxuhuaqiehuanpaizhao.png')
dev.press.BACK()
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent HOME')
#虚化拍照
def xuhuapaizhao(self):
dev = Device(self.Id)
try:
dev(text='相机').click()
time.sleep(2)
dev(resourceId=
'com.freeme.camera:id/freeme_bv_button'
).click()
time.sleep(2)
for temp6 in range(1000):
print('%sxuhuapaizhao' % (temp6 + 1))
dev(resourceId=
'com.freeme.camera:id/shutter_button'
).click()
time.sleep(1.5)
dev.screenshot(
r'%s/screenshot/%sxuhuapaizhao.png' %
(self.Id, (temp6 + 1)))
time.sleep(1)
except Exception, e:
print('error', e)
dev.screenshot(
r'%s/error/errorxuhuapaizhao.png')
dev.press.BACK()
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent BACK')
os.system('adb shell input keyevent HOME')
class AndroidDevice(object):
def __init__(self):
self.device = None
self.call_status = None
self.d = None
def select_device(self, device=1):
list_devices = check_list()
if list_devices:
if device <= 0 or device > len(list_devices):
print(NO_SELECTED)
exit()
else:
self.device = list_devices[device -
1].split()[0].decode('utf-8')
self.d = Device(self.device)
return self.device
else:
print(NO_CONNECTED)
exit()
def dial_number(self, number):
if self.device:
check_call([
'adb', '-s', self.device, 'shell', 'am', 'start', '-a',
'android.intent.action.CALL', '-d', 'tel:{0}'.format(number)
])
self.call_status = CALLING
def hang_up(self):
if self.call_status == CALLING:
check_call(['adb', 'shell', 'input', 'keyevent 6'])
self.call_status = None
def adb_open_settings(self):
check_call(
['adb', 'shell', 'am', 'start', '-a', 'android.settings.SETTINGS'])
def turn_on_wifi(self):
check_call(['adb', '-s', self.device, 'shell', 'svc wifi enable'])
def turn_off_wifi(self):
check_call(['adb', '-s', self.device, 'shell', 'svc wifi disable'])
def adb_calling_test(self, number, delay=5):
self.dial_number(number)
time.sleep(delay)
self.hang_up()
def adb_wifi_test(self, on_off):
if on_off == 'ON':
self.turn_on_wifi()
elif on_off == 'OFF':
self.turn_off_wifi()
def uiaviewer_generator(self, name_file):
self.d.screenshot('{0}.png'.format(name_file))
self.d.dump('{0}.uix'.format(name_file))
def initial_state(self):
self.d.screen.on()
self.d.press.home()
def type_number(self, number):
for digit in number:
self.d(text='{0}'.format(digit),
className='android.widget.TextView').click()
def uia_calling_test(self, number, delay=2):
self.initial_state()
flag = False
if self.d(descriptionContains='Phone',
className='android.widget.TextView').count == 1:
self.d(descriptionContains='Phone',
className='android.widget.TextView').click()
# self.d(descriptionContains='key pad', className='android.widget.ImageButton').click()
self.type_number(number)
self.d(descriptionContains='dial',
className='android.widget.ImageButton').click()
time.sleep(delay)
if self.d(descriptionContains='Phone',
className='android.widget.TextView').count == 1:
self.d(descriptionContains='End',
className='android.widget.ImageButton').click()
elif self.d(descriptionContains='Teléfono',
className='android.widget.TextView').count == 1:
self.d(descriptionContains='Teléfono',
className='android.widget.TextView').click()
self.d(descriptionMatches='teclado',
className='android.widget.ImageButton').click()
self.d(descriptionMatches='',
className='android.widget.EditText').click()
self.type_number(number)
self.d(descriptionMatches='marcar',
className='android.widget.ImageButton').click()
time.sleep(delay)
self.d(descriptionMatches='Finalizar llamada',
className='android.widget.ImageButton').click()
def quick_turn_on_wifi(self):
status = self.d(descriptionContains='Wi-Fi',
className='android.widget.Switch').checked
if not status:
self.d(descriptionContains='Wi-Fi',
className='android.widget.Switch').click()
else:
print('WiFi actalmente encendido')
def quick_turn_off_wifi(self):
status = self.d(descriptionContains='Wi-Fi',
className='android.widget.Switch').checked
if status:
self.d(descriptionContains='Wi-Fi',
className='android.widget.Switch').click()
else:
print('WiFi actualmente apagado')
def uia_quick_wifi_test(self, on_off):
self.d.open.quick_settings()
time.sleep(3)
if on_off == 'ON':
self.quick_turn_on_wifi()
elif on_off == 'OFF':
self.quick_turn_off_wifi()
time.sleep(3)
self.initial_state()
def setting_turn_on_wifi(self):
status = self.d(index='2', className='android.widget.Switch').checked
if (status == False):
self.d(index='2', className='android.widget.Switch').click()
else:
print('WiFi actalmente encendido')
def setting_turn_off_wifi(self):
status = self.d(index='2', className='android.widget.Switch').checked
if status:
self.d(index='2', className='android.widget.Switch').click()
else:
print('WiFi actualmente apagado')
def setting_turn_ES_wifi(self):
status = self.d(text='Sí', className='android.widget.Switch').checked
if status:
self.d(text='Sí', className='android.widget.Switch').click()
else:
print('WiFi actualmente apagado')
def settings_wifi_test(self, on_off):
self.initial_state()
self.adb_open_settings()
flag = False
try:
flag = self.d(text='Wireless & networks',
className='android.widget.TextView').checked
flag = True
except:
flag = False
if flag:
self.d(text='Wireless & networks',
className='android.widget.TextView').click()
if on_off == 'ON':
self.d(text='Wi-Fi',
className='android.widget.TextView').click()
self.setting_turn_on_wifi()
elif on_off == 'OFF':
self.d(text='Wi-Fi',
className='android.widget.TextView').click()
self.setting_turn_off_wifi()
time.sleep(3)
self.d.press.home()
else:
self.d(text='Internet y red',
className='android.widget.TextView').click()
if on_off == 'ON':
self.setting_turn_on_wifi()
elif on_off == 'OFF':
self.setting_turn_ES_wifi()
time.sleep(3)
self.d.press.home()
def adb_claculator_SendText(self, number, delay=5):
self.dial_calculator()
time.sleep(3)
self.dial_calculator_enter(number)
time.sleep(delay)
self.hang_up()
def dial_calculator(self):
if self.device:
check_call(
['adb', 'shell', 'monkey -p', 'com.android.calculator2', '1'])
def dial_calculator_enter(self, number):
if self.device:
check_call(
['adb', 'shell', 'input text', '\'' + number + '\'', ''])
def ui_calculator(self, number, delay=5):
self.initial_state()
flag = False
self.d(descriptionContains='Apps',
className='android.widget.TextView').click()
#self.d.swipe(500, 1500, 500, 200, 3)
time.sleep(1)
self.d(descriptionMatches='Calculator',
className='android.widget.TextView').click()
self.type_number_calculator(number)
self.d(descriptionContains='equals',
className='android.widget.ImageView').click()
def type_number_calculator(self, number):
for digit in number:
numbers = ['1', '2', '3', '4', '5', '6', '7', '8', '9', '0']
character = '{0}'.format(digit)
if (character in numbers):
self.d(text=character,
className='android.widget.Button').click()
else:
if (character == 'X' or character == 'x' or character == '*'):
character = 'multiply'
elif (digit == '/'):
character = 'divide'
elif (digit == '-'):
character = 'minus'
elif (digit == '+'):
character = 'plus'
self.d(descriptionContains=character,
className='android.widget.ImageView').click()
class AdbDevice(object):
hiddenService = 'com.fuhu.settingshelper/.SettingsHelperService'
LIST_SYSTEM = 'system'
LIST_ALL = 'all'
LIST_3RD_PARTY = '3rd'
LIST_RECENT = 'recent'
orientation = ['natural', 'left', 'upsidedown', 'right']
def __init__(self, serialno=None):
self.lock = threading.Semaphore()
self.cmd = AdbCmd(serialno)
self.serialno = serialno
def connect(self):
self.d = Device(self.serialno)
# self.d, self.serialno = ViewClient.connectToDeviceOrExit(serialno=self.serialno)
# self.vc = ViewClient(self.d, self.serialno, compresseddump=False, ignoreuiautomatorkilled=True, autodump=False)
def startActivity(self, component):
component = component.replace('$', '\$')
self.cmd.shell(['am', 'start', '-n', component, '--activity-clear-task'])
def isConnected(self):
if self.__getDevices(self.serialno):
return True
else:
return False
def listPackages(self):
return self.cmd.shell(['pm', 'list', 'package'], output=True)
def reboot(self):
self.cmd.reboot()
def dump(self, compressed=False):
return self.d.dump(compressed=compressed).encode('utf-8')
@staticmethod
def retrieveSelector(point, selectors):
shortestDistance = 500000
result = None
for selector in selectors:
print selector.className
bounds = selector.info['bounds']
if point[0] <= bounds['right'] and point[0] >= bounds['left'] and point[1] <= bounds['top'] and point[1] >= \
bounds['bottom']:
return selector
for selector in selectors:
bounds = selector.info['bounds']
distance = (((bounds['left'] + bounds['top']) / 2 - point[0]) ** 2 + (
(bounds['left'] + bounds['bottom']) / 2 - point[1]) ** 2) ** 0.5
if shortestDistance > distance:
shortestDistance = distance
result = selector
return result
def checkSamePoint(self, point, info, isLongClick=False):
print info
if not self.isScreenOn():
self.powerBtn()
if self.isLocked():
self.unlock()
if len(info) == 2:
if self.d.info['currentPackageName'] == info['packageName']:
self.cmd.shell(['input', 'tap', str(point[0]), str(point[1])])
return {'answer': True, 'reason': 'it is the navigation bar'}
if info['content-desc'] != '':
self.d(contentDescription=info['content-desc'])
return {'answer': True, 'reason': 'find by description'}
if info['text'] != '':
self.d(text=info['text']).click()
return {'answer': True, 'reason': 'find by text'}
currentViewMap = self.getTouchViewInfo(point)
if currentViewMap:
if currentViewMap['package'] == info['package']:
if currentViewMap['class'] == info['class']:
self.d.click(point[0], point[1])
return {'answer': True, 'reason': 'Find the similar view'}
else:
return {'answer': False, 'reason': 'the view doesn\'t be found.'}
else:
return {'answer': False, 'reason': 'In the wrong page'}
else:
return {'answer': False, 'reason': 'the view can\'t be found.'}
@staticmethod
def removeKey(d, keys):
r = dict(d)
for k in keys:
if r.has_key(k):
del r[k]
return r
def __getDevices(self, serial):
outputRE = re.compile(serial)
devices = outputRE.findall(AdbCmd.devices())
if len(devices) > 0:
return devices[0]
def getTouchViewInfo(self, point, compressed=False):
smallestArea = sys.maxint
result = None
root = ET.fromstring(self.dump(compressed=compressed))
for node in root.iter('node'):
bounds = re.match('\[(?P<x1>[\d]+),(?P<y1>[\d]+)\]\[(?P<x2>[\d]+),(?P<y2>[\d]+)\]', node.get('bounds'))
isInclude, area = self._parseRange(point,
(int(bounds.group('x1')), int(bounds.group('y1'))),
(int(bounds.group('x2')), int(bounds.group('y2'))))
if isInclude:
if area <= smallestArea:
smallestArea = area
result = node
if result is not None:
return result.attrib
elif point[1] > self.d.info['displayHeight']:
p = {'packageName': self.d.info['currentPackageName'], 'type': 'Navigation Bar'}
return p
@staticmethod
def getBoundsCenter(bounds):
bounds = re.match('\[(?P<x1>[\d]+),(?P<y1>[\d]+)\]\[(?P<x2>[\d]+),(?P<y2>[\d]+)\]', bounds)
x = (int(bounds.group('x2')) + int(bounds.group('x1'))) / 2
y = (int(bounds.group('y2')) + int(bounds.group('y1'))) / 2
return x, y
@staticmethod
def _parseRange(point, point1, point2):
if point[0] >= point1[0] and point[0] <= point2[0]:
if point[1] >= point1[1] and point[1] <= point2[1]:
area = (point2[0] - point1[0]) * (point2[1] - point1[1])
return (True, area)
else:
return (False, None)
else:
return (False, None)
def viewFilter(self, view):
if view.getClass() == self.viewClass:
return True
else:
return False
def screenOn(self, status):
if status == True:
self.d.screen.on()
else:
self.d.screen.off()
def clearLog(self):
self.cmd.shell(['logcat', '-c'])
def longClick(self, x, y, duration):
if y <= self.d.info['displayHeight']:
self.d.swipe(x, y, x, y, steps=duration / 10)
else:
self.cmd.shell(['input', 'tap', str(x), str(y)])
def click(self, x, y):
if y <= self.d.info['displayHeight']:
self.d.click(x, y)
else:
self.cmd.shell(['input', 'tap', str(x), str(y)])
def drag(self, x, y, duration):
self.d.drag(x[0], x[1], y[0], y[1], steps=duration / 10)
def swipe(self, x, y, duration):
self.cmd.shell(['input', 'swipe', str(x[0]), str(x[1]), str(y[0]), str(y[1]), str(duration)])
def type(self, text):
translate = re.sub(r'([#\(\)\&\*\'\\\"\~\`\|\<\>?\;])', r'\\\1', text)
self.cmd.shell(['input', 'text', translate])
# self.d(className="android.widget.EditText").set_text(text)
def hideKeyboard(self):
if self.isKeyboardShown():
self.backBtn()
def unlock(self):
if self.isLocked():
self.menuBtn()
def isLocked(self):
lockScreenRE = re.compile('mShowingLockscreen=(true|false)')
m = lockScreenRE.search(self.cmd.dumpsys(['window', 'policy']))
if m is not None:
return m.group(1) == 'true'
def isScreenOn(self):
screenOnRE = re.compile('mScreenOnFully=(true|false)')
m = screenOnRE.search(self.cmd.dumpsys(['window', 'policy']))
if m is not None:
return m.group(1) == 'true'
def powerBtn(self):
self.cmd.inputKeyevnt('POWER')
def backBtn(self):
self.cmd.inputKeyevnt('BACK')
def homeBtn(self):
self.cmd.inputKeyevnt('HOME')
def menuBtn(self):
self.cmd.inputKeyevnt('MENU')
# def rotate(self, orient):
# if orient == 'auto':
# self.d.freeze_rotation(False)
# elif orient == '0':
# self.d.orientation = 'n'
# elif orient == '90':
# self.d.orientation = 'l'
# elif orient == '180':
# self.d.freeze_rotation(True)
# self._setScreenOrient(2)
# elif orient == '270':
# self.d.orientation = 'r'
def rotate(self, orient):
self.d.freeze_rotation(True)
index = self.orientation.index(self.d.orientation)
if orient == 'left':
index -= 1
if index < 0:
self._setScreenOrient(len(self.orientation) - 1)
else:
self._setScreenOrient(index)
elif orient == 'right':
index += 1
if index >= len(self.orientation):
self._setScreenOrient(0)
else:
self._setScreenOrient(index)
def volumeUp(self):
self.cmd.inputKeyevnt('VOLUME_UP')
def volumeDown(self):
self.cmd.inputKeyevnt('VOLUME_DOWN')
# def _setAutoRotate(self, status):
# if status:
# self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:accelerometer_rotation',
# '--bind', 'value:i:1'])
# time.sleep(1)
# self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:accelerometer_rotation',
# '--bind', 'value:i:1'])
#
# else:
# self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:accelerometer_rotation',
# '--bind', 'value:i:0'])
# time.sleep(1)
# self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:accelerometer_rotation',
# '--bind', 'value:i:0'])
def _setScreenOrient(self, orient):
self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:user_rotation',
'--bind', 'value:i:' + str(orient)])
def resetPackage(self, package):
self.cmd.shell(['pm', 'clear', package])
def takeSnapshot(self, path):
return self.d.screenshot(path)
def getCurrDisplay(self):
output = self.cmd.dumpsys(['display'])
match = re.search('mCurrentOrientation=(?P<orientation>[\d])[\w\d\s\(\),-=]+'
+ 'mCurrentDisplayRect=Rect\(0, 0 - (?P<width>[\d]+),\s+(?P<height>[\d]+)', output)
width = int(match.group('width'))
height = int(match.group('height'))
orientation = int(match.group('orientation'))
mode = 'landscape' if width > height else 'portrait'
return {'width': width, 'height': height, 'orientation': orientation, 'mode': mode}
def getRealDisplay(self):
output = self.cmd.dumpsys(['display'])
match = re.search('real\s(?P<width>[\d]+)\sx\s(?P<height>[\d]+)', output)
return {'width': int(match.group('width')), 'height': int(match.group('height'))}
def getProp(self, propType=None):
if propType:
return self.cmd.shell(['getprop', propType], output=True).strip('\n')
else:
return self.cmd.shell(['getprop'], output=True).strip('\n')
def uninstall(self, package):
self.cmd.uninstall(package)
def install(self, name):
self.cmd.install(name)
def close(self):
pass
def checkConnected(self):
return self.d.checkConnected()
def extractComponentName(self, packageName):
if packageName == 'com.google.android.youtube':
return 'com.google.android.youtube/.app.honeycomb.Shell$HomeActivity'
output = self.cmd.dumpsys(['package', packageName])
try:
if os.name == 'nt':
splitOutput = output.split('\r\r\n')
else:
splitOutput = output.split('\r\n')
num = splitOutput.index(next(x for x in splitOutput if x.find('android.intent.action.MAIN:') != -1))
if num != -1:
print splitOutput[num + 1]
return splitOutput[num + 1].split()[1]
else:
return None
except:
return None
def screenTimeout(self):
timeout = self.cmd.getSettings(['system', 'screen_off_timeout'])
return long(timeout) / 1000
def setScreenTimeout(self, value):
self.cmd.putSettings(['system', 'screen_off_timeout', value])
def isNfcOn(self):
match = re.search('mState=(on|off)', self.cmd.dumpsys(['nfc']))
if match:
if match.group(1) == 'on':
return True
else:
return False
else:
return False
def isAirPlaneModeOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['global', 'airplane_mode_on']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isInstallUnknownSources(self):
match = re.search('(0|1)', self.cmd.getSettings(['global', 'install_non_market_apps']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isKeyboardShown(self):
output = self.cmd.dumpsys(['input_method'])
result = re.search('mInputShown=(true|false)', output)
if result.group(1) == 'true':
return True
else:
return False
def isWifiOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['global', 'wifi_on']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isBtOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['global', 'bluetooth_on']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isNoKeepActivityOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['global', 'always_finish_activities']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isDataRoamingOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['global', 'data_roaming']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isAutoRotateOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['system', 'accelerometer_rotation']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isGpsOn(self):
state = self.cmd.getSettings(['secure', 'location_providers_allowed'])
if state == 'none':
return False
else:
return True
def isAutoBrightnessOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['system', 'screen_brightness_mode']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isVibrateWhenRingOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['system', 'vibrate_when_ringing']))
if match:
if match.group(1) == '1':
return True
else:
return False
else:
return False
def isWindowAniOn(self):
match = re.search('(0.0|1.0)', self.cmd.getSettings(['global', 'window_animation_scale']))
if match:
if match.group(1) == '0.0':
return True
else:
return False
else:
return False
def isTransitionAnuOn(self):
match = re.search('(0.0|1.0)', self.cmd.getSettings(['global', 'transition_animation_scale']))
if match:
if match.group(1) == '0.0':
return True
else:
return False
else:
return False
def isDurationAniOn(self):
match = re.search('(0.0|1.0)', self.cmd.getSettings(['global', 'animator_duration_scale']))
if match:
if match.group(1) == '0.0':
return True
else:
return False
else:
return False
def enableWifi(self, state):
if state:
self.cmd.shell(['am', 'startservice', '--ez', 'wifi', 'true', '-n',
self.hiddenService])
else:
self.cmd.shell(['am', 'startservice', '--ez', 'wifi', 'false', '-n',
self.hiddenService])
def enableBluetooth(self, state):
if state:
self.cmd.shell(['am', 'startservice', '--ez', 'bt', 'true', '-n',
self.hiddenService])
else:
self.cmd.shell(['am', 'startservice', '--ez', 'bt', 'false', '-n',
self.hiddenService])
def enableInstallUnknownSources(self, state):
if state:
self.cmd.putSettings(['global', 'install_non_market_apps', '1'])
else:
self.cmd.putSettings(['global', 'install_non_market_apps', '0'])
def enableNfc(self, state):
if state:
self.cmd.shell(['service', 'call', 'nfc', '6'])
else:
self.cmd.shell(['service', 'call', 'nfc', '5'])
def enableNoKeepActivity(self, state):
if state:
self.cmd.putSettings(['global', 'always_finish_activities', '1'])
else:
self.cmd.putSettings(['global', 'always_finish_activities', '0'])
def enableDataRoaming(self, state):
if state:
self.cmd.putSettings(['global', 'data_roaming', '1'])
else:
self.cmd.putSettings(['global', 'data_roaming', '0'])
def enableAutoRotate(self, state):
if state:
self.cmd.putSettings(['system', 'accelerometer_rotation', '1'])
else:
self.cmd.putSettings(['system', 'accelerometer_rotation', '0'])
def enableGps(self, state):
if state:
self.cmd.putSettings(['secure', 'location_providers_allowed', 'gps,network'])
else:
self.cmd.putSettings(['secure', 'location_providers_allowed', 'none'])
def enableAutoBrightness(self, state):
if state:
self.cmd.putSettings(['system', 'screen_brightness_mode', '1'])
else:
self.cmd.putSettings(['system', 'screen_brightness_mode', '0'])
def enableVibrateRinging(self, state):
if state:
self.cmd.putSettings(['system', 'vibrate_when_ringing', '1'])
else:
self.cmd.putSettings(['system', 'vibrate_when_ringing', '0'])
def enableVibrateWhenRing(self, state):
if state:
self.cmd.putSettings(['system', 'vibrate_when_ringing', '1'])
else:
self.cmd.putSettings(['system', 'vibrate_when_ringing', '0'])
def enableWindowAnimator(self, state):
if state:
self.cmd.putSettings(['global', 'window_animation_scale', '1.0'])
else:
self.cmd.putSettings(['global', 'window_animation_scale', '0.0'])
def enableTransitionAnimator(self, state):
if state:
self.cmd.putSettings(['global', 'transition_animation_scale', '1.0'])
else:
self.cmd.putSettings(['global', 'transition_animation_scale', '0.0'])
def enableDurationAnimation(self, state):
if state:
self.cmd.putSettings(['global', 'animator_duration_scale', '1.0'])
else:
self.cmd.putSettings(['global', 'animator_duration_scale', '0.0'])
def enableAirplaneMode(self, state):
if state:
self.cmd.putSettings(['global', 'airplane_mode_on', '1'])
self.cmd.shell(['am', 'broadcast', '-a', 'android.intent.action.AIRPLANE_MODE', '--ez', 'state', 'true'])
else:
self.cmd.putSettings(['global', 'airplane_mode_on', '0'])
self.cmd.shell(['am', 'broadcast', '-a', 'android.intent.action.AIRPLANE_MODE', '--ez', 'state', 'false'])
def requestPackage(self, t):
result = None
if t == self.LIST_ALL:
result = self.cmd.shell(['pm', 'list', 'packages'], output=True)
elif t == self.LIST_SYSTEM:
result = self.cmd.shell(['pm', 'list', 'packages', '-s'], output=True)
elif t == self.LIST_3RD_PARTY:
result = self.cmd.shell(['pm', 'list', 'packages', '-3'], output=True)
if result:
packages = result.split('\r\n')
packages.remove('')
packages.sort()
return packages
def getSerialNumber(self):
return self.serialno
class AndroidDevice(object):
'''
wrapper for android uiautomator(pip install uiautomator) and image comparision(pip install imglib)
to provide android device event inject and ui object inspect and image comparison.
'''
def __init__(self):
self.serial = configer.env[ANDROID_SERIAL] if configer.env.has_key(ANDROID_SERIAL) else None
self.d = Device(self.serial)
def __getattr__(self, method):
'''
forward method to uiautomator device if method support by uiautomator.
'''
if hasattr(self.d, method):
def wrapper(*args, **kwargs):
return getattr(self.d, method)(*args, **kwargs)
return wrapper
raise AttributeError(method)
def serial(self):
'''device serial number from $ANDROID_SERIAL '''
return self.serial
def info(self):
'''retrieve the device info'''
return self.d.info
def sleep(self, seconds):
time.sleep(seconds)
return self
#device event inject
def start_activity(self, **kwargs):
'''launch application from android shell am start: component, flag
// from adb docs:
//<INTENT> specifications include these flags:
// [-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]
// [-c <CATEGORY> [-c <CATEGORY>] ...]
// [-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE> ...]
// [--esn <EXTRA_KEY> ...]
// [--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> ...]
// [-e|--ei <EXTRA_KEY> <EXTRA_INT_VALUE> ...]
// [-n <COMPONENT>] [-f <FLAGS>]
// [<URI>]
'''
#d.server.adb.cmd('shell','am', 'start', '-a', 'android.intent.action.DIAL','tel:13581739891').communicate()
#sys.stderr.write(str(kwargs))
keys = kwargs.keys()
shellcmd = ['shell', 'am', 'start']
if 'component' in keys:
shellcmd.append('-n')
shellcmd.append(kwargs['component'])
if 'action' in keys:
shellcmd.append('-a')
shellcmd.append(kwargs['action'])
if 'data' in keys:
shellcmd.append('-d')
shellcmd.append(kwargs['data'])
if 'mimetype' in keys:
shellcmd.append('-t')
shellcmd.append(kwargs['mimetype'])
if 'categories' in keys:
for category in kwargs['categories']:
shellcmd.append('-c')
shellcmd.append(category)
if 'extras' in keys:
for extra_key, extra_value in kwargs['extras'].items():
str_value = ''
arg = ''
if isinstance(extra_value, types.IntType):
str_value = str(extra_value)
arg = '--ei'
elif isinstance(extra_value, types.BooleanType):
str_value = str(extra_value)
arg = '--ez'
else:
str_value = str(extra_value)
arg = '--es'
shellcmd.append(arg)
shellcmd.append(extra_key)
shellcmd.append(str_value)
if 'flags' in keys:
shellcmd.append('-f')
shellcmd.append(str(kwargs['flags']))
if 'uri' in keys:
shellcmd.append(kwargs['uri'])
#sys.stderr.write(str(shellcmd))
self.d.server.adb.cmd(*shellcmd).communicate()
return self
def instrument(self, **kwargs):
keys = kwargs.keys()
shellcmd = ['shell', 'am', 'instrument', '-w', '-r']
pkgname = kwargs.pop('packagename')
for k, v in kwargs.items():
if k and v:
shellcmd.append('-e')
shellcmd.append(k)
shellcmd.append(str(v))
shellcmd.append(pkgname)
result = self.d.server.adb.cmd(*shellcmd).communicate()
return result
def TODOinstallPackage(self, **kwargs):
pass
def TODOremovePackage(self, **kwargs):
pass
def press(self, keyname, waittime=1):
#hard, soft key: home,back,up,down,right,left,center,menu,power or ANDROID_KEYEVENT
self.d.press(keyname)
time.sleep(waittime)
return self
def click(self, x, y, waittime=1):
self.d.click(x, y)
time.sleep(waittime)
return self
def click_image(self, imagename, waittime=1, threshold=0.01):
'''
if the wanted image found on current screen click it.
if the wanted image not found raise exception and set test to be failure.
'''
expect_image_path = os.path.join(configer['right_dir_path'], imagename)
assert os.path.exists(expect_image_path), 'the local expected image %s not found!' % imagename
current_image_path = os.path.join(configer['report_dir_path'], imagename)
self.d.screenshot(current_image_path)
assert os.path.exists(current_image_path), 'fetch current screen shot image %s failed!' % imagename
pos = getMatchedCenterOffset(expect_image_path, current_image_path, threshold)
assert pos, 'Fail Reason: The wanted image \'%s\' not found on screen!' % imagename
self.d.click(pos[0], pos[1])
time.sleep(waittime)
return self
def swipe(self, sx, sy, ex, ey, steps=100, waittime=1):
self.d.swipe(sx, sy, ex, ey, steps)
time.sleep(waittime)
return self
def drag(self, sx, sy, ex, ey, steps=100, waittime=1):
self.d.drag(sx, sy, ex, ey, steps)
time.sleep(waittime)
return self
#inspect
def exists(self, **kwargs):
'''
if the expected component exists on current screen layout return true else return false.
'''
return self.d.exists(**kwargs)
#device snapshot
def screenshot(self, filename, waittime=1):
path = os.path.join(configer['report_dir_path'], filename)
self.d.screenshot(path)
return self
def expect(self, imagename, interval=2, timeout=4, threshold=0.01, msg=''):
'''
if the expected image found on current screen return self
else raise exception. set test to be failure.
'''
expect_image_path = os.path.join(configer['right_dir_path'], imagename)
assert os.path.exists(expect_image_path)
current_image_path = os.path.join(configer['report_dir_path'], imagename)
begin = time.time()
while (time.time() - begin < timeout):
self.d.screenshot(current_image_path)
if isMatch(expect_image_path , current_image_path , threshold):
return self
time.sleep(interval)
name, ext = os.path.splitext(os.path.basename(imagename))
shutil.copyfile(expect_image_path, os.path.join(configer['report_dir_path'], '%s%s%s' % (name, '_expect', ext)))
reason = msg if not msg else 'Fail Reason: Image \'%s\' not found on screen!' % imagename
assert False, reason
def find(self, imagename, interval=2, timeout=4, threshold=0.01):
'''
if the expected image found on current screen return true else return false
'''
expect_image_path = os.path.join(configer['right_dir_path'], imagename)
assert os.path.exists(expect_image_path)
current_image_path = os.path.join(configer['report_dir_path'], imagename)
begin = time.time()
isExists = False
while (time.time() - begin < timeout):
time.sleep(interval)
self.d.screenshot(current_image_path)
isExists = isMatch(expect_image_path , current_image_path , threshold)
if not isExists:
time.sleep(interval)
continue
return isExists
class Mobile():
def __init__(self):
pass
def set_serial(self, android_serial):
"""
Specify given *android_serial* device to perform test.
You do not have to specify the device when there is only one device connects to the computer.
When you need to use multiple devices, do not use this keyword to switch between devices in test execution.
Using different library name when importing this library according to http://robotframework.googlecode.com/hg/doc/userguide/RobotFrameworkUserGuide.html?r=2.8.4#setting-custom-name-to-test-library.
| ==Setting== | ==Value== | ==Value== | ==Value== |
| Library | Mobile | WITH NAME | Mobile1 |
| Library | Mobile | WITH NAME | Mobile2 |
And set the serial to each library.
| Test Case | Action | Argument |
| Multiple Devices | Mobile1.Set Serial | device_1's serial |
| | Mobile2.Set Serial | device_2's serial |
"""
self.adb = ADB(android_serial)
self.device = Device(android_serial)
self.test_helper = TestHelper(self.adb)
def get_device_info(self):
"""
Retrieve the device info.
The keyword will return a dictionary.
You can log the information by using the log dictionary keyword in build in Collections library(http://robotframework.googlecode.com/hg/doc/libraries/Collections.html?r=2.8.4).
Example:
| ${device_info} | Get Device Info |
| Log Dictionary | ${device_info} |
=>
Dictionary size is 9 and it contains following items:\n
currentPackageName: com.android.keyguard\n
displayHeight: 1776\n
displayRotation: 0\n
displaySizeDpX: 360\n
displaySizeDpY: 640\n
displayWidth: 1080\n
naturalOrientation: True\n
productName: hammerhead\n
sdkInt: 19\n
Or get specific information of the device by giving the key.
| ${device_info} | Get Device Info | | |
| ${product_name} | Get From Dictionary | ${device_info} | productName |
=>
${product_name} = hammerhead
"""
return self.device.info
#Key Event Actions of the device
"""
Turn on/off screen
"""
def turn_on_screen(self):
"""
Turn on screen
"""
self.device.screen.on()
def turn_off_screen(self):
"""
Turn off screen
"""
self.device.screen.off()
"""
Press hard/soft key
"""
def press_key(self, *keys):
"""
Press *key* keycode.
You can find all keycode in http://developer.android.com/reference/android/view/KeyEvent.html
"""
#not tested
self.device.press(*keys)
def press_home(self):
"""
Press home key
"""
self.device.press.home()
def press_back(self):
"""
Press back key
"""
self.device.press.back()
def press_left(self):
"""
Press left key
"""
self.device.pres.left()
def press_right(self):
"""
Press right key
"""
self.device.press.right()
def press_up(self):
"""
Press up key
"""
self.device.press.up()
def press_down(self):
"""
Press down key
"""
self.device.press.down()
def press_center(self):
"""
Press center key
"""
self.device.press.center()
def press_menu(self):
"""
Press menu key
"""
self.device.press.menu()
def press_search(self):
"""
Press search key
"""
self.device.press.search()
def press_enter(self):
"""
Press enter key
"""
self.device.press.enter()
def press_delete(self):
"""
Press delete key
"""
self.device.press.delete()
def press_recent(self):
"""
Press recent key
"""
self.device.press.recent()
def press_volume_up(self):
"""
Press volume up key
"""
self.device.press.volume_up()
def press_volume_down(self):
"""
Press volume down key
"""
self.device.press.volume_down()
def press_camera(self):
"""
Press camera key
"""
self.device.press.camera()
def press_power(self):
"""
Press power key
"""
self.device.press.power()
#Gesture interaction of the device
def click_at_coordinates(self, x, y):
"""
Click at (x,y) coordinates.
"""
self.device.click(x, y)
def swipe_by_coordinates(self, sx, sy, ex, ey, steps=10):
"""
Swipe from (sx, sy) to (ex, ey) with *steps* .
Example:
| Swipe By Coordinates | 540 | 1340 | 940 | 1340 | | # Swipe from (540, 1340) to (940, 100) with default steps 10 |
| Swipe By Coordinates | 540 | 1340 | 940 | 1340 | 100 | # Swipe from (540, 1340) to (940, 100) with steps 100 |
"""
self.device.swipe(sx, sy, ex, ey, steps)
# Swipe from the center of the ui object to its edge
def swipe_left(self, steps=10, *args, **selectors):
"""
Swipe the UI object with *selectors* from center to left.
Example:
| Swipe Left | description=Home screen 3 | | # swipe the UI object left |
| Swipe Left | 5 | description=Home screen 3 | # swipe the UI object left with steps=5 |
See `introduction` for details about identified UI object.
"""
self.device(**selectors).swipe.left(steps=steps)
def swipe_right(self, steps=10, *args, **selectors):
"""
Swipe the UI object with *selectors* from center to right
See `Swipe Left` for more details.
"""
self.device(**selectors).swipe.right(steps=steps)
def swipe_top(self, steps=10, *args, **selectors):
"""
Swipe the UI object with *selectors* from center to top
See `Swipe Left` for more details.
"""
self.device(**selectors).swipe.up(steps=steps)
def swipe_bottom(self, steps=10, *args, **selectors):
"""
Swipe the UI object with *selectors* from center to bottom
See `Swipe Left` for more details.
"""
self.device(**selectors).swipe.down(steps=steps)
def object_swipe_left(self, obj, steps=10):
"""
Swipe the *obj* from center to left
Example:
| ${object} | Get Object | description=Home screen 3 | # Get the UI object |
| Object Swipe Left | ${object} | | # Swipe the UI object left |
| Object Swipe Left | ${object} | 5 | # Swipe the UI object left with steps=5 |
| Object Swipe Left | ${object} | steps=5 | # Swipe the UI object left with steps=5 |
See `introduction` for details about identified UI object.
"""
obj.swipe.left(steps=steps)
def object_swipe_right(self, obj, steps=10):
"""
Swipe the *obj* from center to right
See `Object Swipe Left` for more details.
"""
obj.swipe.right(steps=steps)
def object_swipe_top(self, obj, steps=10):
"""
Swipe the *obj* from center to top
See `Object Swipe Left` for more details.
"""
obj.swipe.up(steps=steps)
def object_swipe_bottom(self, obj, steps=10):
"""
Swipe the *obj* from center to bottom
See `Object Swipe Left` for more details.
"""
obj.swipe.down(steps=steps)
def drag_by_coordinates(self,sx, sy, ex, ey, steps=10):
"""
Drag from (sx, sy) to (ex, ey) with steps
See `Swipe By Coordinates` also.
"""
self.device.drag(sx, sy, ex, ey, steps)
#Wait until the specific ui object appears or gone
# wait until the ui object appears
def wait_for_exists(self, timeout=0, *args, **selectors):
"""
true means the object which has *selectors* exist
false means the object does not exist
in the given timeout
"""
return self.device(**selectors).wait.exists(timeout=timeout)
# wait until the ui object gone
def wait_until_gone(self, timeout=0, *args, **selectors):
"""
true means the object which has *selectors* disappear
false means the object exist
in the given timeout
"""
return self.device(**selectors).wait.gone(timeout=timeout)
def wait_for_object_exists(self, obj, timeout=0):
"""
true means the object exist
false means the object does not exist
in the given timeout
"""
return obj.wait.exists(timeout=timeout)
# wait until the ui object gone
def wait_until_object_gone(self, obj, timeout=0):
"""
true means the object disappear
false means the object exist
in the given timeout
"""
return obj.wait.gone(timeout=timeout)
# Perform fling on the specific ui object(scrollable)
def fling_forward_horizontally(self, *args, **selectors):
"""
return whether the object can be fling or not
"""
return self.device(**selectors).fling.horiz.forward()
def fling_backward_horizontally(self, *args, **selectors):
"""
return whether the object can be fling or not
"""
return self.device(**selectors).fling.horiz.backward()
def fling_forward_vertically(self, *args, **selectors):
"""
return whether the object can be fling or not
"""
return self.device(**selectors).fling.vert.forward()
def fling_backward_vertically(self, *args, **selectors):
"""
return whether the object can be fling or not
"""
return self.device(**selectors).fling.vert.backward()
# Perform scroll on the specific ui object(scrollable)
def scroll_to_beginning_vertically(self, steps=10, **selectors):
"""
"""
return self.device(**selectors).scroll.vert.toBeginning(steps=steps)
def scroll_to_end_vertically(self, steps=10, **selectors):
"""
"""
return self.device(**selectors).scroll.vert.toEnd(steps=steps)
def scroll_object_to_beginning_vertically(self, obj, steps=10):
"""
"""
return obj.scroll.vert.toBeginning(steps=steps)
def scroll_object_to_end_vertically(self, obj, steps=10):
"""
"""
return obj.scroll.vert.toEnd(steps=steps)
def scroll_forward_horizontally(self, obj, steps=10):
"""
return whether the object can be scroll or not
"""
return obj.scroll.horiz.forward(steps=steps)
def scroll_backward_horizontally(self, obj, steps=10):
"""
return whether the object can be scroll or not
"""
return obj.scroll.horiz.backward(steps=steps)
def scroll_to_horizontally(self, obj, *args,**selectors):
"""
return whether the object can be scroll or not
"""
return obj.scroll.horiz.to(**selectors)
def scroll_forward_vertically(self, obj, steps=10):
"""
return whether the object can be scroll or not
"""
return obj.scroll.vert.forward(steps=steps)
def scroll_backward_vertically(self, obj, steps=10):
"""
return whether the object can be scroll or not
"""
return obj.scroll.vert.backward(steps=steps)
def scroll_to_vertically(self, obj, *args, **selectors):
"""
return whether the object exists or not
"""
return obj.scroll.vert.to(**selectors)
#Screen Actions of the device
def get_screen_orientation(self):
"""
Get the screen orientation.
Possible result: natural, left, right, upsidedown
See for more details: https://github.com/xiaocong/uiautomator#screen-actions-of-the-device
"""
return self.device.orientation
def set_screen_orientation(self, orientation):
"""
Set the screen orientation.
Input *orientation* : natural or n, left or l, right or r, upsidedown (support android version above 4.3)
The keyword will unfreeze the screen rotation first.
See for more details: https://github.com/xiaocong/uiautomator#screen-actions-of-the-device
Example:
| Set Screen Orientation | n | # Set orientation to natural |
| Set Screen Orientation | natural | # Do the same thing |
"""
self.device.orientation = orientation
def freeze_screen_rotation(self):
"""
Freeze the screen auto rotation
"""
self.device.freeze_rotation()
def unfreeze_screen_rotation(self):
"""
Un-Freeze the screen auto rotation
"""
self.device.freeze_rotation(False)
def screenshot(self, scale=None, quality=None):
"""
Take a screenshot of device and log in the report with timestamp, scale for screenshot size and quality for screenshot quality
default scale=1.0 quality=100
"""
output_dir = BuiltIn().get_variable_value('${OUTPUTDIR}')
ts = time.time()
st = datetime.datetime.fromtimestamp(ts).strftime('%Y%m%d%H%M%S')
screenshot_path = '%s%s%s.png' % (output_dir, os.sep, st)
self.device.screenshot(screenshot_path, scale, quality)
logger.info('\n<a href="%s">%s</a><br><img src="%s">' % (screenshot_path, st, screenshot_path), html=True)
#Watcher
# def register_click_watcher(self, watcher_name, selectors, *condition_list):
# """
# The watcher click on the object which has the selectors when conditions match
# """
# print type(selectors)
# watcher = self.device.watcher(watcher_name)
# for condition in condition_list:
# watcher.when(**condition)
# watcher.click(**selectors)
# self.device.watchers.run()
# print 'register watcher:%s' % watcher_name
# return
def __unicode_to_dict(self, a_unicode):
a_dict = dict()
dict_item_count = a_unicode.count('=')
for count in range(dict_item_count):
equal_sign_position = a_unicode.find('=')
comma_position = a_unicode.find(',')
a_key = a_unicode[0:equal_sign_position]
if comma_position == -1:
a_value = a_unicode[equal_sign_position + 1:]
else:
a_value = a_unicode[equal_sign_position + 1:comma_position]
a_unicode = a_unicode[comma_position + 1:]
a_dict[a_key] = a_value
return a_dict
def register_click_watcher(self, watcher_name, selectors, *condition_list):
"""
The watcher click on the object which has the *selectors* when conditions match
"""
watcher = self.device.watcher(watcher_name)
for condition in condition_list:
watcher.when(**self.__unicode_to_dict(condition))
watcher.click(**self.__unicode_to_dict(selectors))
self.device.watchers.run()
def register_press_watcher(self, watcher_name, press_keys, *condition_list):
"""
The watcher perform *press_keys* action sequentially when conditions match
"""
def unicode_to_list(a_unicode):
a_list = list()
comma_count = a_unicode.count(',')
for count in range(comma_count + 1):
comma_position = a_unicode.find(',')
if comma_position == -1:
a_list.append(str(a_unicode))
else:
a_list.append(a_unicode[0:comma_position])
a_unicode = a_unicode[comma_position + 1:]
return a_list
watcher = self.device.watcher(watcher_name)
for condition in condition_list:
watcher.when(**self.__unicode_to_dict(condition))
watcher.press(*unicode_to_list(press_keys))
self.device.watchers.run()
def remove_watchers(self, watcher_name = None):
"""
Remove watcher with *watcher_name* or remove all watchers
"""
if watcher_name == None:
self.device.watchers.remove()
else:
self.device.watchers.remove(watcher_name)
def list_all_watchers(self):
"""
Return the watcher list
"""
return self.device.watchers
#Selector
def get_object(self, *args, **selectors):
"""
Get the UI object with selectors *selectors*
See `introduction` for details about identified UI object.
"""
return self.device(*args, **selectors)
def get_count(self, *args, **selectors):
"""
Return the count of UI object with *selectors*
Example:
| ${count} | Get Count | text=Accessibility | # Get the count of UI object text=Accessibility |
| ${accessibility_text} | Get Object | text=Accessibility | # These two keywords combination |
| ${count} | Get Count Of Object | ${accessibility_text} | # do the same thing. |
"""
obj = self.get_object(**selectors)
return self.get_count_of_object(obj)
def get_count_of_object(self, obj):
"""
Return the count of given UI object
See `Get Count` for more details.
"""
return len(obj)
def get_info_of_object(self, obj, selector=None):
"""
return info dictionary of the *obj*
The info example:
{
u'contentDescription': u'',
u'checked': False,
u'scrollable': True,
u'text': u'',
u'packageName': u'com.android.launcher',
u'selected': False,
u'enabled': True,
u'bounds':
{
u'top': 231,
u'left': 0,
u'right': 1080,
u'bottom': 1776
},
u'className': u'android.view.View',
u'focusable': False,
u'focused': False,
u'clickable': False,
u'checkable': False,
u'chileCount': 1,
u'longClickable': False,
u'visibleBounds':
{
u'top': 231,
u'left': 0,
u'right': 1080,
u'bottom': 1776
}
}
"""
if selector:
return obj.info.get(selector)
else:
return obj.info
def click(self, *args, **selectors):
"""
click on the UI object with *selectors*
"""
self.device(**selectors).click()
def long_click(self, *args, **selectors):
"""
click on the UI object with *selectors*
"""
self.device(**selectors).long_click()
def call(self, obj, method, *args, **selectors):
"""
This keyword can use object method from original python uiautomator
See more details from https://github.com/xiaocong/uiautomator
Example:
| ${accessibility_text} | Get Object | text=Accessibility | # Get the UI object |
| Call | ${accessibility_text} | click | # Call the method of the UI object 'click' |
"""
func = getattr(obj, method)
return func(**selectors)
def set_text(self, input_text, *args, **selectors):
"""
Set *input_text* to the UI object with *selectors*
"""
self.device(**selectors).set_text(input_text)
# Other feature
def clear_text(self, *args, **selectors):
"""
Clear text of the UI object with *selectors*
"""
while True:
target = self.device(**selectors)
text = target.info['text']
target.clear_text()
remain_text = target.info['text']
if text == '' or remain_text == text:
break
def open_notification(self):
"""
open notification
Built in support for Android 4.3 (API level 18)
Using swipe action as a workaround for API level lower than 18
"""
sdk_version = self.device.info['sdkInt']
if sdk_version < 18:
height = self.device.info['displayHeight']
self.device.swipe(1, 1, 1, height - 1, 1)
else:
self.device.open.notification()
def open_quick_settings(self):
"""
open quick settings
Work for Android 4.3 above (API level 18)
"""
self.device.open.quick_settings()
def sleep(self, time):
"""
Sleep(no action) for *time* (in millisecond)
"""
target = 'wait for %s' % str(time)
self.device(text=target).wait.exists(timeout=time)
def install(self, apk_path):
"""
Install apk to the device
"""
self.adb.cmd('install "%s"' % apk_path)
def uninstall(self, package_name):
"""
Uninstall the APP with *package_name*
"""
self.adb.cmd('uninstall %s' % package_name)
def execute_adb_command(self, cmd):
"""
Execute adb *cmd*
"""
return self.adb.cmd(cmd)
def execute_adb_shell_command(self,cmd):
"""
Execute adb shell *cmd*
"""
return self.adb.shell_cmd(cmd)
def type(self, input_text, **selectors):
"""
Type *text* at current focused UI object
"""
self.test_helper.send_set_text_cmd(input_text)
def start_test_agent(self):
"""
[Test Agent]
Start Test Agent Service
"""
cmd = 'am start edu.ntut.csie.sslab1321.testagent/edu.ntut.csie.sslab1321.testagent.DummyActivity'
self.adb.shell_cmd(cmd)
def stop_test_agent(self):
"""
[Test Agent]
Stop Test Agent Service
"""
cmd = 'am broadcast -a testagent -e action STOP_TESTAGENT'
self.adb.shell_cmd(cmd)
def connect_to_wifi(self, ssid, password):
"""
[Test Agent]
Connect to *ssid* with *password*
"""
cmd = 'adb shell am start edu.ntut.csie.sslab1321.testagent/edu.ntut.csie.sslab1321.testagent.DummyActivity'
cmd = 'adb shell am broadcast -a testagent -e action CONNECT_TO_WIFI -e ssid WEP -e password 12345'
cmd = 'am broadcast -a testagent -e action CONNECT_TO_WIFI -e ssid %s -e password %s' % (ssid, password)
self.adb.shell_cmd(cmd)
def clear_connected_wifi(self):
"""
[Test Agent]
Clear all existed Wi-Fi connection
"""
cmd = 'am broadcast -a testagent -e action CLEAR_CONNECTED_WIFIS'
self.adb.shell_cmd(cmd)
def foo(self):
pass
# logger.info('\nGot arg %s %s' % (output_dir, st), also_console=True)
# clm = CommandLineWriter()
# output some messages on console
# clm.message(' ')
# clm.message(u'中文')
# clm.message(u'2----------2')
def test(self):
pass
class Monitor:
def __init__(self, environment, monitor_serial):
self.monitor_serial = monitor_serial
self.specifying_monitor = '-s {}'.format(self.monitor_serial)
self.device = Device(self.monitor_serial)
self.build_location ="mon_test\Apps\monitor_build\dev-dell-release-SINK-0.0.3143.7736342\system"
self.build_version = self.get_build_version()
self.monitor_name = self.get_monitor_name_by_ui()
self.find_command = " | findstr" if platform.platform() == "Windows" else "| grep"
print 'Monitor:init - orientation=%s' % self.device.orientation
def auto_approve_connection(self):
print('changing to auto aprrove in monitor : {}'.format(self.monitor_name))
self.device(resourceId="com.screenovate.dell.monitorserver:id/settings").click()
self.device(resourceId="com.screenovate.dell.monitorserver:id/security_settings").click()
self.device(text="Auto Approve").click()
self.device(resourceId="android:id/button1").click()
def approve_connection(self):
os.system('adb -s {} shell am broadcast -a com.screenovate.sink.action.ACCEPT_PAIR'.format(self.monitor_serial))
def decline_connection(self):
os.system('adb -s {} shell am broadcast -a com.screenovate.sink.action.DECLINE_PAIR'.format(self.monitor_serial))
def start_intent_of_approve(self):
os.system('adb -s {} shell am broadcast -a com.screenovate.intent.action.P2P_DIALOG_REQUEST'.format(self.monitor_serial))
def get_screen_size(self):
size = "adb -s {} shell wm size".format(self.monitor_serial)
output = subprocess.check_output([s for s in size.split()])
return output.split(':')[1].strip()
def install_build(self):
os.system("adb -s {} root".format(self.monitor_serial))
os.system("adb -s {} wait-for-device remount".format(self.monitor_serial))
time.sleep(6)
commandToExecute = ("adb -s {} push {} /system/".format(self.monitor_serial, self.build_location))
os.system(commandToExecute)
time.sleep(1)
self.reboot_mon()
def reboot_mon(self):
checkBootComp = 'adb {} shell getprop sys.boot_completed'.format(self.specifying_monitor)
output = subprocess.check_output([c for c in checkBootComp.split()])
print('start rebbot monitor')
os.system('adb {} reboot'.format(self.specifying_monitor))
self.is_boot_completed(output)
print('reboot monitor completed')
def is_boot_completed(self, bootCompCmd):
output = '-1'
while output != bootCompCmd:
time.sleep(1)
try:
screenUp = 'adb {} shell getprop sys.boot_completed'.format(self.specifying_monitor)
output = subprocess.check_output([s for s in screenUp.split()])
except Exception:
print('waiting for monitor')
print('Screen up and fully loaded')
return True
def do_factory_reset(self):
checkBootComp = 'adb {} shell getprop sys.boot_completed'.format(self.specifying_monitor)
output = subprocess.check_output([c for c in checkBootComp.split()])
print('Start doing reboot to the monitor')
self.device(resourceId="com.screenovate.dell.monitorserver:id/settings").click()
self.device(resourceId="com.screenovate.dell.monitorserver:id/reset").click()
self.device(resourceId="com.screenovate.dell.monitorserver:id/reset_ok").click()
print('Start doing factory rest...')
os.system("adb {} logcat".format(self.specifying_monitor))
self.is_boot_completed(output)
def set_wifi_channel(self, channel):
print('Setting wifi channel to {} '.format(channel))
self.device(resourceId="com.screenovate.dell.monitorserver:id/settings").click()
self.device(resourceId="com.screenovate.dell.monitorserver:id/set_wifi_channel").click()
auto_is_checked = self.device(resourceId="com.screenovate.dell.monitorserver:id/channel_auto_checkbox").info['checked']
channel_24_is_checked = self.device(resourceId="com.screenovate.dell.monitorserver:id/channel_auto24_checkbox").info['checked']
channel_5_is_checked = self.device(resourceId="com.screenovate.dell.monitorserver:id/channel_auto5_checkbox").info['checked']
if auto_is_checked or channel_5_is_checked or channel_24_is_checked:
self.device(resourceId="com.screenovate.dell.monitorserver:id/show_advanced").click()
self.device(resourceId="com.screenovate.dell.monitorserver:id/channel_custom_checkbox").click()
self.device(text=channel, className="android.widget.TextView").click()
self.device(resourceId="com.screenovate.dell.monitorserver:id/channel_ok").click()
def get_build_version(self):
build_name = self.build_location
return build_name[build_name.find('K-') + 2:build_name.find("/sys")]
def check_build_version(self):
print('checking version of the build')
build_version = 'adb {} shell dumpsys package com.screenovate.dell.monitorserver'.format(
self.specifying_monitor)
output = subprocess.check_output([b for b in build_version.split()])
return ("versionName={}".format(self.build_version) in output)
def get_monitor_name_by_adb(self):
dumpsys = "adb shell dumpsys | {} wifiP2pDevice=Device".format(self.find_command)
output = subprocess.check_output([c for c in dumpsys.split()])
start_index = output.rfind('Device: ', 0)
start_index = start_index + 8
end_index = output.rfind("\n", 0)
name = output[start_index: end_index].strip()
return name
def verify_nothing_connected(self):
print('verifying nothing connected')
if self.device.exists(resourceId="com.screenovate.dell.monitorserver:id/video_view"):
print('some device connected to monitor , stsrt rebooting monitor')
self.reboot_mon()
print('no device currently connected to monitor')
def get_monitor_name_by_ui(self):
self.verify_nothing_connected()
print("get name from " + self.monitor_serial)
self.monitor_name = self.device(resourceId="com.screenovate.dell.monitorserver:id/ssid").info[
"text"]
return self.monitor_name
def screen_on(self):
print("turning monitor screen on")
os.system("adb {} shell input keyevent 82".format(self.specifying_monitor))
def take_screenshot_test(self):
self.device.screenshot("pictures-test/monitor.png")
class AndroidDevice(object):
'''
wrapper for android uiautomator-server binding(pip install uiautomator).
provide android device event inject, ui object inspect and image comparison.
'''
def __init__(self, seral=None):
'''
create device instance.
'''
self.serial = os.environ[ANDROID_SERIAL] if os.environ.has_key(ANDROID_SERIAL) else None
self.working_dir_path = WORKING_DIR_PATH
self.report_dir_path = REPORT_DIR_PATH
self.right_dir_path = WORKING_DIR_PATH
self._internal_storage_dir = DEFAULT_DEVICE_INTERNAL_STORAGE
self.d = Device(self.serial)
#try:
# if int(self.d.info['sdkInt']) <= 17:
# self.d.screenshot = self.screenshot_common
#except:
# pass
def set_internal_storage_dir(self, path):
self._internal_storage_dir = path
def __getattr__(self, attr):
'''
forward method/attrbuite to uiautomator device if method support by uiautomator.
'''
if hasattr(self.d, attr):
if attr == 'screenshot':
return self.screenshot_common
m = getattr(self.d, attr)
if inspect.ismethod(m):
def wrapper(*args, **kwargs):
return m(*args, **kwargs)
return wrapper
else:
return m
raise AttributeError(attr)
def __call__(self, *args, **kwargs):
'''
selector support:
d(text="Settings").click()
'''
return self.d(*args, **kwargs)
@property
def orientation(self):
return self.d.orientation
@orientation.setter
def orientation(self, v):
self.d.orientation = v
def serial(self):
'''
device serial number from $ANDROID_SERIAL
'''
return self.serial
def sleep(self, sec):
time.sleep(sec)
#device event inject
def start_activity(self, **intent_params):
'''
Starts an Activity on the device by sending an Intent which constructed from the specified parameters.
The params of Intent supported from adb docs:
<INTENT> specifications include these flags:
[-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]
[-c <CATEGORY> [-c <CATEGORY>] ...]
[-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE> ...]
[--esn <EXTRA_KEY> ...]
[--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> ...]
[-e|--ei <EXTRA_KEY> <EXTRA_INT_VALUE> ...]
[-n <COMPONENT>] [-f <FLAGS>]
[<URI>]
@type intent_params: dictionary
@param intent_params: the properties of an Intent.
property support: component/action/data/mimetype/categories/extras/flags/uri
@rtype: AndroidDevice
@return: a instance of AndroidDevice.
'''
#d.server.adb.cmd('shell','am', 'start', '-a', 'android.intent.action.DIAL','tel:13581739891').communicate()
#sys.stderr.write(str(intent_params))
keys = intent_params.keys()
shellcmd = ['shell', 'am', 'start']
if 'component' in keys:
shellcmd.append('-n')
shellcmd.append(intent_params['component'])
if 'action' in keys:
shellcmd.append('-a')
shellcmd.append(intent_params['action'])
if 'data' in keys:
shellcmd.append('-d')
shellcmd.append(intent_params['data'])
if 'mimetype' in keys:
shellcmd.append('-t')
shellcmd.append(intent_params['mimetype'])
if 'categories' in keys:
for category in intent_params['categories']:
shellcmd.append('-c')
shellcmd.append(category)
if 'extras' in keys:
for extra_key, extra_value in intent_params['extras'].items():
str_value = ''
arg = ''
if isinstance(extra_value, types.IntType):
str_value = str(extra_value)
arg = '--ei'
elif isinstance(extra_value, types.BooleanType):
str_value = str(extra_value)
arg = '--ez'
else:
str_value = str(extra_value)
arg = '--es'
shellcmd.append(arg)
shellcmd.append(extra_key)
shellcmd.append(str_value)
if 'flags' in keys:
shellcmd.append('-f')
shellcmd.append(str(intent_params['flags']))
if 'uri' in keys:
shellcmd.append(intent_params['uri'])
if 'package' in keys:
shellcmd.append(intent_params['package'])
#sys.stderr.write(str(shellcmd))
self.d.server.adb.cmd(*shellcmd).communicate()
return self
def instrument(self, **kwargs):
'''
Run the specified package with instrumentation and return the output it generates.
Use this to run a test package using InstrumentationTestRunner.
Typically this target <COMPONENT> is the form <TEST_PACKAGE>/<RUNNER_CLASS>.
Options are:
-w: wait for instrumentation to finish before returning. Required for test runners.
-r: print raw results (otherwise decode REPORT_KEY_STREAMRESULT).
Use with [-e perf true] to generate raw output for performance measurements.
-e <NAME> <VALUE>: set argument <NAME> to <VALUE>.
For test runners a common form is [-e <testrunner_flag> <value>[,<value>...]].
-p <FILE>: write profiling data to <FILE>
--user <USER_ID> | current: Specify user instrumentation runs in; current user if not specified.
--no-window-animation: turn off window animations will running.
@type intent_params: dictionary
@param intent_params: the properties of an instrumentation testing.
property support: packagename, <NAME> to <VALUE>.
@rtype: AndroidDevice
@return: a instance of AndroidDevice.
'''
keys = kwargs.keys()
shellcmd = ['shell', 'am', 'instrument', '-w', '-r']
pkgname = kwargs.pop('packagename')
for k, v in kwargs.items():
if k and v:
shellcmd.append('-e')
shellcmd.append(k)
shellcmd.append(str(v))
shellcmd.append(pkgname)
result = self.d.server.adb.cmd(*shellcmd).communicate()
return result
def click(self, *args, **kwargs):
'''
example:
click(x,y)
Click the screen location specified by x and y.
Format: (x,y) the screen location specified by x and y.
x The horizontal position of the touch in actual device pixels, starting from the left of the screen in its current orientation.
y The vertical position of the touch in actual device pixels, starting from the top of the screen in its current orientation.
click('phone_app.png', rotation=90)
Perform a click event on the center point on the expected screen region.
If the screen region want to click not found in the current screen snapshot will do nothing
rotation: 0, 90, 180, 270
'''
if args:
if isinstance(args[0], types.IntType):
self.__click_point(*args, **kwargs)
return self
if isinstance(args[0], types.StringType):
self.__click_image(*args, **kwargs)
return self
def __click_point(self, x, y, waittime=1):
'''
click x,y
'''
self.d.click(x, y)
time.sleep(waittime)
def __click_image(self, imagename, waittime=1, threshold=0.01, rotation=0):
'''
if the wanted image found on current screen click it.
if the wanted image not found raise exception and set test to be failure.
'''
expect_image_path = None
current_image_path = None
if os.path.isabs(imagename):
expect_image_path = imagename
current_image_path = join(self.report_dir_path, os.path.basenme(imagename))
else:
expect_image_path = join(self.right_dir_path, imagename)
current_image_path = join(self.report_dir_path, imagename)
assert os.path.exists(expect_image_path), 'the local expected image %s not found!' % expect_image_path
self.d.screenshot(current_image_path)
assert os.path.exists(current_image_path), 'fetch current screen shot image %s failed!' % imagename
pos = getMatchedCenterOffset(subPath=expect_image_path, srcPath=current_image_path, threshold=0.01, rotation=rotation)
if not pos:
reason = 'Fail Reason: The wanted image \'%s\' not found on screen!' % imagename
raise ExpectException(expect_image_path, current_image_path, reason)
self.d.click(pos[0], pos[1])
time.sleep(waittime)
def screenshot_common(self, filename):
'''
if SK version <= 16
Capture the screenshot via adb and store it in the specified location.
'''
png = os.path.basename(filename)
if self.serial:
shell('adb -s %s shell screencap %s%s' % (self.serial, self._internal_storage_dir, png))
shell('adb -s %s pull %s%s %s' % (self.serial, self._internal_storage_dir, png, filename))
else:
shell('adb shell screencap %s%s' % (self._internal_storage_dir, png))
shell('adb pull %s%s %s' % (self._internal_storage_dir, png, filename))
return True
#inspect
def exists(self, **kwargs):
'''
if the expected component exists on current screen layout return true else return false.
'''
return self.d.exists(**kwargs)
def expect(self, imagename, interval=2, timeout=4, threshold=0.01, msg=''):
'''
if the expected image found on current screen return self
else raise exception. set test to be failure.
'''
expect_image_path = None
current_image_path = None
if os.path.isabs(imagename):
expect_image_path = imagename
current_image_path = join(self.report_dir_path, os.path.basenme(imagename))
else:
expect_image_path = join(self.right_dir_path, imagename)
current_image_path = join(self.report_dir_path, imagename)
assert os.path.exists(expect_image_path), 'the local expected image %s not found!' % expect_image_path
begin = time.time()
while (time.time() - begin < timeout):
self.d.screenshot(current_image_path)
if isMatch(expect_image_path , current_image_path , threshold):
return self
time.sleep(interval)
reason = msg if msg else 'Fail Reason: Image \'%s\' not found on screen!' % imagename
raise ExpectException(expect_image_path, current_image_path, reason)
def find(self, imagename, interval=2, timeout=4, threshold=0.01):
'''
if the expected image found on current screen return true else return false
'''
expect_image_path = None
current_image_path = None
if os.path.isabs(imagename):
expect_image_path = imagename
current_image_path = join(self.report_dir_path, os.path.basenme(imagename))
else:
expect_image_path = join(self.right_dir_path, imagename)
current_image_path = join(self.report_dir_path, imagename)
assert os.path.exists(expect_image_path), 'the local expected image %s not found!' % expect_image_path
begin = time.time()
isExists = False
while (time.time() - begin < timeout):
time.sleep(interval)
self.d.screenshot(current_image_path)
isExists = isMatch(expect_image_path , current_image_path , threshold)
if not isExists:
time.sleep(interval)
continue
return isExists
def TODOinstallPackage(self, **kwargs):
pass
def TODOremovePackage(self, **kwargs):
pass
name = z.phoneToName('12345678910')
phone = z.nameToPhone(name)
pkg = 'com.tencent.mobileqq'
z.server.install()
slot = Slot('cda0ae8d', 'mobileqq')
print(slot.getSlots())
#slot.backup('1', 'slot_1')
#slot.restore('1')
print z.qq_getLoginStatus(d)
z.generate_serial('com.tencent.mobileqq')
print(z.get_serial(pkg))
info = '{"buildManufacturer":"ZTE","buildModel":"ZTE G720C","buildSerial":"ytz0fad63hkensm","buildVersionRelease":"Android 2.2.3","empty":false,"settingsSecureAndroidId":"wwx31wo6hhxbkrw","telephonyGetDeviceId":"864948416091531","telephonyGetLine1Number":"+8615015541026","telephonyGetNetworkType":"12","telephonyGetSimSerialNumber":"84508614357292636763","telephonyGetSubscriberId":"48313995020377949279","wifiInfoGetMacAddress":"00:03:6C:6B:B2:EA","wifiInfoGetSSID":"TP-ZPBZEBM7"}'
z.set_serial(pkg, info)
source = '/tmp/xxx.png'
d.screenshot(source)
width = 540.0
height = 960.0
p = {
"x1": 37 / width,
"y1": 380 / height,
"x2": 502 / width,
"y2": 473 / height
}
z.img_crop(source, p)
out = d.server.adb.run_cmd('shell', 'ls')
z.input("xxx")
# d.server.adb.cmd("shell", "ime set com.zunyun.zime/.ZImeService").communicate()
z.server.install()
class AdbDevice(object):
hiddenService = 'com.fuhu.settingshelper/.SettingsHelperService'
LIST_SYSTEM = 'system'
LIST_ALL = 'all'
LIST_3RD_PARTY = '3rd'
LIST_RECENT = 'recent'
orientation = ['natural', 'left', 'upsidedown', 'right']
def __init__(self, serialno=None):
self.lock = threading.Semaphore()
self.cmd = AdbCmd(serialno)
self.serialno = serialno
def connect(self):
self.d = Device(self.serialno)
# self.d, self.serialno = ViewClient.connectToDeviceOrExit(serialno=self.serialno)
# self.vc = ViewClient(self.d, self.serialno, compresseddump=False, ignoreuiautomatorkilled=True, autodump=False)
def startActivity(self, component):
component = component.replace('$', '\$')
self.cmd.shell(
['am', 'start', '-n', component, '--activity-clear-task'])
def isConnected(self):
if self.__getDevices(self.serialno):
return True
else:
return False
def listPackages(self):
return self.cmd.shell(['pm', 'list', 'package'], output=True)
def reboot(self):
self.cmd.reboot()
def dump(self, compressed=False):
return self.d.dump(compressed=compressed).encode('utf-8')
@staticmethod
def retrieveSelector(point, selectors):
shortestDistance = 500000
result = None
for selector in selectors:
print selector.className
bounds = selector.info['bounds']
if point[0] <= bounds['right'] and point[0] >= bounds['left'] and point[1] <= bounds['top'] and point[1] >= \
bounds['bottom']:
return selector
for selector in selectors:
bounds = selector.info['bounds']
distance = (
((bounds['left'] + bounds['top']) / 2 - point[0])**2 +
((bounds['left'] + bounds['bottom']) / 2 - point[1])**2)**0.5
if shortestDistance > distance:
shortestDistance = distance
result = selector
return result
def checkSamePoint(self, point, info, isLongClick=False):
print info
if not self.isScreenOn():
self.powerBtn()
if self.isLocked():
self.unlock()
if len(info) == 2:
if self.d.info['currentPackageName'] == info['packageName']:
self.cmd.shell(['input', 'tap', str(point[0]), str(point[1])])
return {'answer': True, 'reason': 'it is the navigation bar'}
if info['content-desc'] != '':
self.d(contentDescription=info['content-desc'])
return {'answer': True, 'reason': 'find by description'}
if info['text'] != '':
self.d(text=info['text']).click()
return {'answer': True, 'reason': 'find by text'}
currentViewMap = self.getTouchViewInfo(point)
if currentViewMap:
if currentViewMap['package'] == info['package']:
if currentViewMap['class'] == info['class']:
self.d.click(point[0], point[1])
return {'answer': True, 'reason': 'Find the similar view'}
else:
return {
'answer': False,
'reason': 'the view doesn\'t be found.'
}
else:
return {'answer': False, 'reason': 'In the wrong page'}
else:
return {'answer': False, 'reason': 'the view can\'t be found.'}
@staticmethod
def removeKey(d, keys):
r = dict(d)
for k in keys:
if r.has_key(k):
del r[k]
return r
def __getDevices(self, serial):
outputRE = re.compile(serial)
devices = outputRE.findall(AdbCmd.devices())
if len(devices) > 0:
return devices[0]
def getTouchViewInfo(self, point, compressed=False):
smallestArea = sys.maxint
result = None
root = ET.fromstring(self.dump(compressed=compressed))
for node in root.iter('node'):
bounds = re.match(
'\[(?P<x1>[\d]+),(?P<y1>[\d]+)\]\[(?P<x2>[\d]+),(?P<y2>[\d]+)\]',
node.get('bounds'))
isInclude, area = self._parseRange(
point, (int(bounds.group('x1')), int(bounds.group('y1'))),
(int(bounds.group('x2')), int(bounds.group('y2'))))
if isInclude:
if area <= smallestArea:
smallestArea = area
result = node
if result is not None:
return result.attrib
elif point[1] > self.d.info['displayHeight']:
p = {
'packageName': self.d.info['currentPackageName'],
'type': 'Navigation Bar'
}
return p
@staticmethod
def getBoundsCenter(bounds):
bounds = re.match(
'\[(?P<x1>[\d]+),(?P<y1>[\d]+)\]\[(?P<x2>[\d]+),(?P<y2>[\d]+)\]',
bounds)
x = (int(bounds.group('x2')) + int(bounds.group('x1'))) / 2
y = (int(bounds.group('y2')) + int(bounds.group('y1'))) / 2
return x, y
@staticmethod
def _parseRange(point, point1, point2):
if point[0] >= point1[0] and point[0] <= point2[0]:
if point[1] >= point1[1] and point[1] <= point2[1]:
area = (point2[0] - point1[0]) * (point2[1] - point1[1])
return (True, area)
else:
return (False, None)
else:
return (False, None)
def viewFilter(self, view):
if view.getClass() == self.viewClass:
return True
else:
return False
def screenOn(self, status):
if status == True:
self.d.screen.on()
else:
self.d.screen.off()
def clearLog(self):
self.cmd.shell(['logcat', '-c'])
def longClick(self, x, y, duration):
if y <= self.d.info['displayHeight']:
self.d.swipe(x, y, x, y, steps=duration / 10)
else:
self.cmd.shell(['input', 'tap', str(x), str(y)])
def click(self, x, y):
if y <= self.d.info['displayHeight']:
self.d.click(x, y)
else:
self.cmd.shell(['input', 'tap', str(x), str(y)])
def drag(self, x, y, duration):
self.d.drag(x[0], x[1], y[0], y[1], steps=duration / 10)
def swipe(self, x, y, duration):
self.cmd.shell([
'input', 'swipe',
str(x[0]),
str(x[1]),
str(y[0]),
str(y[1]),
str(duration)
])
def type(self, text):
translate = re.sub(r'([#\(\)\&\*\'\\\"\~\`\|\<\>?\;])', r'\\\1', text)
self.cmd.shell(['input', 'text', translate])
# self.d(className="android.widget.EditText").set_text(text)
def hideKeyboard(self):
if self.isKeyboardShown():
self.backBtn()
def unlock(self):
if self.isLocked():
self.menuBtn()
def isLocked(self):
lockScreenRE = re.compile('mShowingLockscreen=(true|false)')
m = lockScreenRE.search(self.cmd.dumpsys(['window', 'policy']))
if m is not None:
return m.group(1) == 'true'
def isScreenOn(self):
screenOnRE = re.compile('mScreenOnFully=(true|false)')
m = screenOnRE.search(self.cmd.dumpsys(['window', 'policy']))
if m is not None:
return m.group(1) == 'true'
def powerBtn(self):
self.cmd.inputKeyevnt('POWER')
def backBtn(self):
self.cmd.inputKeyevnt('BACK')
def homeBtn(self):
self.cmd.inputKeyevnt('HOME')
def menuBtn(self):
self.cmd.inputKeyevnt('MENU')
# def rotate(self, orient):
# if orient == 'auto':
# self.d.freeze_rotation(False)
# elif orient == '0':
# self.d.orientation = 'n'
# elif orient == '90':
# self.d.orientation = 'l'
# elif orient == '180':
# self.d.freeze_rotation(True)
# self._setScreenOrient(2)
# elif orient == '270':
# self.d.orientation = 'r'
def rotate(self, orient):
self.d.freeze_rotation(True)
index = self.orientation.index(self.d.orientation)
if orient == 'left':
index -= 1
if index < 0:
self._setScreenOrient(len(self.orientation) - 1)
else:
self._setScreenOrient(index)
elif orient == 'right':
index += 1
if index >= len(self.orientation):
self._setScreenOrient(0)
else:
self._setScreenOrient(index)
def volumeUp(self):
self.cmd.inputKeyevnt('VOLUME_UP')
def volumeDown(self):
self.cmd.inputKeyevnt('VOLUME_DOWN')
# def _setAutoRotate(self, status):
# if status:
# self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:accelerometer_rotation',
# '--bind', 'value:i:1'])
# time.sleep(1)
# self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:accelerometer_rotation',
# '--bind', 'value:i:1'])
#
# else:
# self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:accelerometer_rotation',
# '--bind', 'value:i:0'])
# time.sleep(1)
# self.cmd.shell(['content', 'insert', '--uri', 'content://settings/system', '--bind', 'name:s:accelerometer_rotation',
# '--bind', 'value:i:0'])
def _setScreenOrient(self, orient):
self.cmd.shell([
'content', 'insert', '--uri', 'content://settings/system',
'--bind', 'name:s:user_rotation', '--bind',
'value:i:' + str(orient)
])
def resetPackage(self, package):
self.cmd.shell(['pm', 'clear', package])
def takeSnapshot(self, path):
return self.d.screenshot(path)
def getCurrDisplay(self):
output = self.cmd.dumpsys(['display'])
match = re.search(
'mCurrentOrientation=(?P<orientation>[\d])[\w\d\s\(\),-=]+' +
'mCurrentDisplayRect=Rect\(0, 0 - (?P<width>[\d]+),\s+(?P<height>[\d]+)',
output)
width = int(match.group('width'))
height = int(match.group('height'))
orientation = int(match.group('orientation'))
mode = 'landscape' if width > height else 'portrait'
return {
'width': width,
'height': height,
'orientation': orientation,
'mode': mode
}
def getRealDisplay(self):
output = self.cmd.dumpsys(['display'])
match = re.search('real\s(?P<width>[\d]+)\sx\s(?P<height>[\d]+)',
output)
return {
'width': int(match.group('width')),
'height': int(match.group('height'))
}
def getProp(self, propType=None):
if propType:
return self.cmd.shell(['getprop', propType],
output=True).strip('\n')
else:
return self.cmd.shell(['getprop'], output=True).strip('\n')
def uninstall(self, package):
self.cmd.uninstall(package)
def install(self, name):
self.cmd.install(name)
def close(self):
pass
def checkConnected(self):
return self.d.checkConnected()
def extractComponentName(self, packageName):
if packageName == 'com.google.android.youtube':
return 'com.google.android.youtube/.app.honeycomb.Shell$HomeActivity'
output = self.cmd.dumpsys(['package', packageName])
try:
if os.name == 'nt':
splitOutput = output.split('\r\r\n')
else:
splitOutput = output.split('\r\n')
num = splitOutput.index(
next(x for x in splitOutput
if x.find('android.intent.action.MAIN:') != -1))
if num != -1:
print splitOutput[num + 1]
return splitOutput[num + 1].split()[1]
else:
return None
except:
return None
def screenTimeout(self):
timeout = self.cmd.getSettings(['system', 'screen_off_timeout'])
return long(timeout) / 1000
def setScreenTimeout(self, value):
self.cmd.putSettings(['system', 'screen_off_timeout', value])
def isNfcOn(self):
match = re.search('mState=(on|off)', self.cmd.dumpsys(['nfc']))
if match:
if match.group(1) == 'on':
return True
else:
return False
else:
return False
def isAirPlaneModeOn(self):
match = re.search('(0|1)',
self.cmd.getSettings(['global', 'airplane_mode_on']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isInstallUnknownSources(self):
match = re.search(
'(0|1)',
self.cmd.getSettings(['global', 'install_non_market_apps']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isKeyboardShown(self):
output = self.cmd.dumpsys(['input_method'])
result = re.search('mInputShown=(true|false)', output)
if result.group(1) == 'true':
return True
else:
return False
def isWifiOn(self):
match = re.search('(0|1)', self.cmd.getSettings(['global', 'wifi_on']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isBtOn(self):
match = re.search('(0|1)',
self.cmd.getSettings(['global', 'bluetooth_on']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isNoKeepActivityOn(self):
match = re.search(
'(0|1)',
self.cmd.getSettings(['global', 'always_finish_activities']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isDataRoamingOn(self):
match = re.search('(0|1)',
self.cmd.getSettings(['global', 'data_roaming']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isAutoRotateOn(self):
match = re.search(
'(0|1)', self.cmd.getSettings(['system',
'accelerometer_rotation']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isGpsOn(self):
state = self.cmd.getSettings(['secure', 'location_providers_allowed'])
if state == 'none':
return False
else:
return True
def isAutoBrightnessOn(self):
match = re.search(
'(0|1)', self.cmd.getSettings(['system',
'screen_brightness_mode']))
if match:
if match.group(1) == '1':
return True
else:
return False
def isVibrateWhenRingOn(self):
match = re.search(
'(0|1)', self.cmd.getSettings(['system', 'vibrate_when_ringing']))
if match:
if match.group(1) == '1':
return True
else:
return False
else:
return False
def isWindowAniOn(self):
match = re.search(
'(0.0|1.0)',
self.cmd.getSettings(['global', 'window_animation_scale']))
if match:
if match.group(1) == '0.0':
return True
else:
return False
else:
return False
def isTransitionAnuOn(self):
match = re.search(
'(0.0|1.0)',
self.cmd.getSettings(['global', 'transition_animation_scale']))
if match:
if match.group(1) == '0.0':
return True
else:
return False
else:
return False
def isDurationAniOn(self):
match = re.search(
'(0.0|1.0)',
self.cmd.getSettings(['global', 'animator_duration_scale']))
if match:
if match.group(1) == '0.0':
return True
else:
return False
else:
return False
def enableWifi(self, state):
if state:
self.cmd.shell([
'am', 'startservice', '--ez', 'wifi', 'true', '-n',
self.hiddenService
])
else:
self.cmd.shell([
'am', 'startservice', '--ez', 'wifi', 'false', '-n',
self.hiddenService
])
def enableBluetooth(self, state):
if state:
self.cmd.shell([
'am', 'startservice', '--ez', 'bt', 'true', '-n',
self.hiddenService
])
else:
self.cmd.shell([
'am', 'startservice', '--ez', 'bt', 'false', '-n',
self.hiddenService
])
def enableInstallUnknownSources(self, state):
if state:
self.cmd.putSettings(['global', 'install_non_market_apps', '1'])
else:
self.cmd.putSettings(['global', 'install_non_market_apps', '0'])
def enableNfc(self, state):
if state:
self.cmd.shell(['service', 'call', 'nfc', '6'])
else:
self.cmd.shell(['service', 'call', 'nfc', '5'])
def enableNoKeepActivity(self, state):
if state:
self.cmd.putSettings(['global', 'always_finish_activities', '1'])
else:
self.cmd.putSettings(['global', 'always_finish_activities', '0'])
def enableDataRoaming(self, state):
if state:
self.cmd.putSettings(['global', 'data_roaming', '1'])
else:
self.cmd.putSettings(['global', 'data_roaming', '0'])
def enableAutoRotate(self, state):
if state:
self.cmd.putSettings(['system', 'accelerometer_rotation', '1'])
else:
self.cmd.putSettings(['system', 'accelerometer_rotation', '0'])
def enableGps(self, state):
if state:
self.cmd.putSettings(
['secure', 'location_providers_allowed', 'gps,network'])
else:
self.cmd.putSettings(
['secure', 'location_providers_allowed', 'none'])
def enableAutoBrightness(self, state):
if state:
self.cmd.putSettings(['system', 'screen_brightness_mode', '1'])
else:
self.cmd.putSettings(['system', 'screen_brightness_mode', '0'])
def enableVibrateRinging(self, state):
if state:
self.cmd.putSettings(['system', 'vibrate_when_ringing', '1'])
else:
self.cmd.putSettings(['system', 'vibrate_when_ringing', '0'])
def enableVibrateWhenRing(self, state):
if state:
self.cmd.putSettings(['system', 'vibrate_when_ringing', '1'])
else:
self.cmd.putSettings(['system', 'vibrate_when_ringing', '0'])
def enableWindowAnimator(self, state):
if state:
self.cmd.putSettings(['global', 'window_animation_scale', '1.0'])
else:
self.cmd.putSettings(['global', 'window_animation_scale', '0.0'])
def enableTransitionAnimator(self, state):
if state:
self.cmd.putSettings(
['global', 'transition_animation_scale', '1.0'])
else:
self.cmd.putSettings(
['global', 'transition_animation_scale', '0.0'])
def enableDurationAnimation(self, state):
if state:
self.cmd.putSettings(['global', 'animator_duration_scale', '1.0'])
else:
self.cmd.putSettings(['global', 'animator_duration_scale', '0.0'])
def enableAirplaneMode(self, state):
if state:
self.cmd.putSettings(['global', 'airplane_mode_on', '1'])
self.cmd.shell([
'am', 'broadcast', '-a', 'android.intent.action.AIRPLANE_MODE',
'--ez', 'state', 'true'
])
else:
self.cmd.putSettings(['global', 'airplane_mode_on', '0'])
self.cmd.shell([
'am', 'broadcast', '-a', 'android.intent.action.AIRPLANE_MODE',
'--ez', 'state', 'false'
])
def requestPackage(self, t):
result = None
if t == self.LIST_ALL:
result = self.cmd.shell(['pm', 'list', 'packages'], output=True)
elif t == self.LIST_SYSTEM:
result = self.cmd.shell(['pm', 'list', 'packages', '-s'],
output=True)
elif t == self.LIST_3RD_PARTY:
result = self.cmd.shell(['pm', 'list', 'packages', '-3'],
output=True)
if result:
packages = result.split('\r\n')
packages.remove('')
packages.sort()
return packages
def getSerialNumber(self):
return self.serialno
