iOS自动化探索WebDriverAgent Python Client

Posted 2021-02-01 一切都是最好的安排

之前我们在终端试着调用过WDA API， 今天我们在看一个Python封装的api库

https://github.com/openatx/facebook-wda

 

安装方式（一）:

pip install --pre facebook-wda

 安装方式（二）:

git clone https://github.com/openatx/facebook-wda.git
cd facebook-wda/
python setup.py install

 

用Xcode开启WDA 会话， 然后再编写和执行脚本

import wda

# Enable debug will see http Request and Response
# wda.DEBUG = True

# get env from $DEVICE_URL if no arguments pass to wda.Client
# http://localhost:8100 is the default value if $DEVICE_URL is empty
c = wda.Client()

# Show Status
print c.status()

输出：

/usr/bin/python2.7 /Users/jackey/Documents/iOS/code/iOS-Auto/Python_Client/Python_Client.py
{u‘ios‘: {u‘ip‘: u‘192.168.1.101‘, u‘simulatorVersion‘: u‘11.2.1‘}, u‘state‘: u‘success‘, u‘os‘: {u‘version‘: u‘11.2.1‘, u‘name‘: u‘iOS‘}, u‘build‘: {u‘time‘: u‘Dec 25 2018 11:48:43‘}, u‘sessionId‘: u‘24AFBCFD-8CA0-4E4F-BEC3-21AD1170D880‘}

Process finished with exit code 0

 

返回Home Screen

# Press home button
c.home()

 

截屏

# Take a screenshot
c.screenshot(‘screen.png‘)

 

打开和关闭app

# Open app
s = c.session(‘NOVA.ProductDemo‘)

# print app oritation
print s.orientation

# Close app
s.close()

还可用一下方式代替上面的代码:

with c.session(‘NOVA.ProductDemo‘) as s:
    print s.orientation
    

 

使用浏览器打开指定网站， 然后关闭

# 使用safari浏览器打开百度
s = c.session(‘com.apple.mobilesafari‘,[‘-u‘, ‘http://www.baidu.com‘])
print s.orientation

# 关闭浏览器
s.close()

 

打印app的bundle_id和sessionid

# open app
s = c.session(‘NOVA.ProductDemo‘)

# Current bundleId and session Id
print s.bundle_id, s.id

输出:

/usr/bin/python2.7 /Users/jackey/Documents/iOS/code/iOS-Auto/Python_Client/Python_Client.py
NOVA.ProductDemo E56C8902-DDB6-485A-8B0B-AA907CF55C59

Process finished with exit code 0

 

 

截屏保存为png

# Screenshot return PIL.Image
# Requires pillow, installed by "pip install pillow"
s.screenshot().save("s.png")

 

截屏并旋转90度

from PIL import Image
s.screenshot().transpose(Image.ROTATE_90).save("correct.png")

 

调整显示方向

# Open url with safari
s = c.session(‘com.apple.mobilesafari‘,[‘-u‘,‘http://www.baidu.com‘])
print s.orientation

# Wait 5s
time.sleep(5)

# Print orientation
print s.orientation

# Change orientation
s.orientation = wda.LANDSCAPE

 

获取屏幕尺寸

# Get width and height
print s.window_size()

 

模拟touch

# Simulate touch
s.tap(200, 200)

Click, 类似tap, 但支持小数

s.click(200, 200)
s.click(0.5, 0.5) # click center of screen
s.click(0.5, 200) # click center of x, and y(200)

 

滑动

# Simulate swipe, utilizing drag api
# 从(x1,y1)划向(x2,y2)
s.swipe(x1, y1, x2, y2, 0.5) # 0.5s
# 从屏幕右边往左划
s.swipe_left()
# 从屏幕左边往右划
s.swipe_right()
# 从屏幕底部往上划
s.swipe_up()
# 从屏幕顶部往上划
s.swipe_down()

 

长按

# tap hold
s.tap_hold(x, y, 1.0)

 

关闭键盘

# Hide keyboard (not working in simulator), did not success using latest WDA
s.keyboard_dismiss()

 

查找元素

# For example, expect: True or False
# using id to find element and check if exists
s(id="URL").exists # return True or False

# using id or other query conditions
s(id=‘URL‘)
s(name=‘URL‘)
s(text="URL") # text is alias of name
s(nameContains=‘UR‘)
s(label=‘Address‘)
s(labelContains=‘Addr‘)
s(name=‘URL‘, index=1) # find the second element. index starts from 0

# combines search conditions
# attributes bellow can combines
# :"className", "name", "label", "visible", "enabled"
s(className=‘Button‘, name=‘URL‘, visible=True, labelContains="Addr")

 

高阶查询

s(xpath=‘//Button[@name="URL"]‘)
s(classChain=‘**/Button[`name == "URL"`]‘)
s(predicate=‘name LIKE "UR*"‘)
s(‘name LIKE "U*L"‘) # predicate is the first argument, without predicate= is ok

 

例如:

# Open app
s = c.session(‘NOVA.ProductDemo‘)
print s.window_size()
s.click(100,640)
e = s(text=‘京东超市‘).get(timeout=10)

如果提示：

UnicodeDecodeError: ‘ascii‘ codec can‘t decode byte 0xe4 in position 0: ordinal not in range(128)

需要在代码中添加：

import sys
reload(sys)
sys.setdefaultencoding(‘utf8‘)

 

元素操作: (点击、滑动、设置文本...)

举例:

# Open app
s = c.session(‘NOVA.ProductDemo‘)
print s.window_size()
s.click(100,640)
e = s(text=‘京东超市‘).get(timeout=10)
e.tap() # tap element