POCO软件测试工程师,Poco: 跨平台的UI自动化测试框架,适用于游戏和App
Poco ポコ
A cross-engine UI automation framework. Unity3D/cocos2dx-*/Android native APP/(Other engines SDK)/...
Example
First you should connect your Android phone, for example, via usb cable and enable the ADB DEBUG MODE.
# coding=utf-8
import time
from poco.drivers.unity3d import UnityPoco
poco = UnityPoco()
poco('btn_start').click()
time.sleep(1.5)
shell = poco('shell').focus('center')
for star in poco('star'):
star.drag_to(shell)
time.sleep(1)
assert poco('scoreVal').get_text() == "100", "score correct."
poco('btn_back', type='Button').click()
Tools for writing test scripts
To retrieve the UI hierarchy of the game, please use our AirtestIDE (an IDE for writing test scripts) or
standalone PocoHierarchyViewer (to view the hierarchy and attributes only but lightweight) !
Installation
In order to use Poco, you must install Poco python library on your host and also install the poco-sdk in
your game/app.
Poco can be installed straightforward with pip command
pip install pocoui
SDK Integration
For poco-sdk integration please refer to Integration Guide
Features
supports mainstream game engines, including: Unity3D, cocos2dx-js, cocos2dx-lua and Android native apps
retrieves UI Elements Hierarchy in game's runtime
is super fast and impact-free to the game
allows straightforward SDK integration to the game (within in 5 minutes)
provides powerful APIs that are engine independent
supports multi-touch e.g. fling/pinch/... (and more is coming soon)
support gps, accelerometer and gyro sensors, rotation (landscape/portrait) and other sensors as input (coming soon)
is extensible to other private engines by implementing poco-sdk .
is compatible with Python 2.7 and Python 3.3+.
Documentation
Tutorials and examples
How to use Poco
Poco supports different types of engines by different drivers. For different engines please initialize poco instance
by corresponding driver. Remember to connect an Android device to your PC/mac with a running game or launch and keep
the game/app active on PC/mac.
Following example shows how to initialize popo instance for
Unity3D.
from poco.drivers.unity3d import UnityPoco
poco = UnityPoco()
# for windows
# poco = UnityPoco(('localhost', 5001), unity_editor=True)
ui = poco('...')
ui.click()
Android native APP
from poco.drivers.android.uiautomation import AndroidUiautomationPoco
poco = AndroidUiautomationPoco()
poco.device.wake()
poco(text='Clock').click()
NetEase Internal Engines except for Unity3D projects.
from poco.drivers.netease.internal import NeteasePoco
from airtest.core.api import connect_device
# 先连上android设备
connect_device('Android:///')
# windows的话这样
# connect_device('Windows:///?title_re=^.*errors and.*$') # 填写可以识别出的窗口标题栏正则表达式,无需urlencode
poco = NeteasePoco('g37') # hunter上的项目代号
ui = poco('...')
ui.click()
unreal (in development)
for other engines, refer to Integration Guide for more details
If you are using multiple devices at the same time, please refer to Poco drivers.
Working with Poco Objects
Basic Selector
UI element objects can be selected by invoking poco(...) function instance. The function traverses through the
render tree structure and selects all the corresponding UI elements matching the query expression.
The function takes one mandatory argument node name, the optional arguments can be substituted too and they refer to
specific node properties. For more information, refer to API Reference selecting UI.
# select by node name
poco('bg_mission')
# select by name and other properties
poco('bg_mission', type='Button')
poco(textMatches='^据点.*$', type='Button', enable=True)
Relative Selector
When there is any ambiguity in the selected objects by node names/node types or object unable to select, the relative
selector tries to select the element object by hierarchy in following manner
# select by direct child/offspring
poco('main_node').child('list_item').offspring('item')
Sequence Selector
Tree indexing and traversing is performed by default from up to down or from left to right. In case that
the 'not-yet-traversed' nodes are removed from the screen, the exception is raised. The exception is not raised in case
when the 'already-traversed' nodes are removed and in this case the traversing continues in previous order despite
the fact that the nodes in views were rearranged during the travers process.
items = poco('main_node').child('list_item').offspring('item')
print(items[0].child('material_name').get_text())
print(items[1].child('material_name').get_text())
Iterate over a collection of objects
Following code snippet shows how to iterate over the collection of UI objects
# traverse through every item
items = poco('main_node').child('list_item').offspring('item')
for item in items:
item.child('icn_item')
Get object properties
Following examples shows how to obtain various properties of an object
mission_btn = poco('bg_mission')
print(mission_btn.attr('type')) # 'Button'
print(mission_btn.get_text()) # '据点支援'
print(mission_btn.attr('text')) # '据点支援' equivalent to .get_text()
print(mission_btn.exists()) # True/False, exists in the screen or not
Object Proxy Related Operation
This section describes object proxy related operations
click
The anchorPoint of UI element is attached to the click point by default. When the first argument
(the relative click position) is passed to the function, the coordinates of the top-left corner of the bounding box
become [0, 0] and the bottom right corner coordinates are [1, 1]. The click range area can be less than 0 or
larger than 1. If the click range area lies in the interval (0, 1), it means it is beyond the bounding box.
Following example demonstrates how to use click function
poco('bg_mission').click()
poco('bg_mission').click('center')
poco('bg_mission').click([0.5, 0.5]) # equivalent to center
poco('bg_mission').focus([0.5, 0.5]).click() # equivalent to above expression
swipe
The anchorPoint of UI element is taken as the origin, the swipe action is performed towards the given direction with
the certain distance.
Following example shows how to use the swipe function
joystick = poco('movetouch_panel').child('point_img')
joystick.swipe('up')
joystick.swipe([0.2, -0.2]) # swipe sqrt(0.08) unit distance at 45 degree angle up-and-right
joystick.swipe([0.2, -0.2], duration=0.5)
drag
Drag from current UI element to the target UI element.
Following example shows how to use the drag_to function
poco(text='突破芯片').drag_to(poco(text='岩石司康饼'))
focus (local positioning)
The anchorPoint is set as the origin when conducting operations related to the node coordinates. If the the local click
area is need, the focus function can be used. The coordinate system is similar to the screen coordinates - the origin
is put to the top left corner of the bounding box and with length of unit of 1, i.e the coordinates of the center are
then [0.5, 0.5] and the bottom right corner has coordinates [1, 1].
poco('bg_mission').focus('center').click() # click the center
The focus function can also be used as internal positioning within the objects. Following example demonstrates the implementation of scroll operation in ScrollView.
scrollView = poco(type='ScollView')
scrollView.focus([0.5, 0.8]).drag_to(scrollView.focus([0.5, 0.2]))
wait
Wait for the target objects to appear on the screen and return the object proxy itself. If the object exists, return
immediately.
poco('bg_mission').wait(5).click() # wait 5 seconds at most,click once the object appears
poco('bg_mission').wait(5).exists() # wait 5 seconds at most,return Exists or Not Exists
Global Operation
Poco framework also allows to perform the operations without any UI elements selected. These operations are called
global operations.
click
poco.click([0.5, 0.5]) # click the center of screen
poco.long_click([0.5, 0.5], duration=3)
swipe
# swipe from A to B
point_a = [0.1, 0.1]
center = [0.5, 0.5]
poco.swipe(point_a, center)
# swipe from A by given direction
direction = [0.1, 0]
poco.swipe(point_a, direction=direction)
snapshot
Take a screenshot of the current screen in base64 encoded string. The image format depends on the sdk implementation.
Take a look at ScreenInterface.getScreen to dive into sdk implementation details.
Note: snapshot is not supported in some engine implementation of poco.
from base64 import b64decode
b64img, fmt = poco.snapshot(width=720)
open('screen.{}'.format(fmt), 'wb').write(b64decode(b64img))
Exceptions
This sections describes the Poco framework errors and exceptions.
PocoTargetTimeout
from poco.exceptions import PocoTargetTimeout
try:
poco('guide_panel', type='ImageView').wait_for_appearance()
except PocoTargetTimeout:
# bugs here as the panel not shown
raise
PocoNoSuchNodeException
from poco.exceptions import PocoNoSuchNodeException
img = poco('guide_panel', type='ImageView')
try:
if not img.exists():
img.click()
except PocoNoSuchNodeException:
# If attempt to operate inexistent nodes, an exception will be thrown
pass
Unit Test
Poco is an automation test framework. For unit testing, please refer to PocoUnit section. PocoUnit provides a full
set of assertion methods and furthermore, it is also compatible with the unittest in Python standard library.
Some Concepts
This section describes some basic concepts of Poco. Basic terminology used in following section
Target device: test devices where the apps or games run on, it usually refers to mobile phone devices
UI proxy: proxy objects within Poco framework, they represent zero (none), one or multiple in-game UI elements
Node/UI element: UI element instances or nodes in app/game
query expression: a serializable internal data structure through which Poco interacts with target devices and
selects the corresponding UI elements. It is not usually needed to pay much attention to this unless it is required
to customize the Selector class.
Following images show the UI hierarchy represented in Poco
Definitions of coordinate system and metric space
Normalized Coordinate System
In normalized coordinate system, the origin (0, 0) lies on top left corner of the device display. The height and the
width of the screen are chosen as 1 unit of length, refer to image below for more detailed information.
In normalized coordinate system, the same UI elements on the devices with different resolution have always the same
position and size. This is especially very handy when writing cross-device test cases.
The space of normalized coordinate system is uniformly distributed, i.e. the coordinates of the screen center are
(0.5, 0.5) and the computing method of other scalars and vectors are all same in Euclidean space.
Local Coordinate System (local positioning)
The aim of introducing local coordinate system is to express the coordinates with reference to a certain UI elements.
The origin (0,0) of local coordinate system lies on the top left corner of UI bounding box, x-axis goes horizontally
rightward direction and y-axis goes vertically downwards. The height and the width of UI element are chosen as 1 unit of
length. Coordinates are expressed as signed distances from the origin. Other definitions are same as for normalized
coordinate system.
Local coordinate system is more flexible in order to locate the position within or outside of UI element, e.g
the coordinates at (0.5, 0.5) corresponds to the center of the UI element while coordinates larger than 1 or less than 0
correspond to the position out of the UI element.
POCO软件测试工程师,Poco: 跨平台的UI自动化测试框架,适用于游戏和App相关推荐
- 网易Airtest跨平台的UI自动化测试框架
技术博文参考: https://www.cnblogs.com/sdcjc/p/14583847.html 一.Airtest project简介 AirtestIDE 是一个跨平台.多端(Win ...
- python开源自动化测试平台_Airtest:网易游戏开源的跨平台 UI 自动化测试框架
Airtest 跨平台的UI自动化测试框架,适用于游戏和App 快速开始 Airtest是一个跨平台的UI自动化测试框架,适用于游戏和App.目前支持Windows和Android平台,iOS支持正在 ...
- 整装待发 QTA UI自动化测试框架迎来大更新
2019独角兽企业重金招聘Python工程师标准>>> 整装待发 QTA UI自动化测试框架迎来大更新 QTA是什么 QTA是一个跨平台的测试自动化工具,适用于后台.原生或混合型客户 ...
- 实战 | UI 自动化测试框架设计与 PageObject 改造
本文节选自霍格沃兹<测试开发实战进阶>课程教学内容,进阶学习文末加群. 在 UI 自动化测试过程中,面对复杂的业务场景,经常会遇到这样的挑战: 简单的录制/回放速度快,但无法适应复杂场景: ...
- UI自动化测试框架搭建-标记性能较差用例
在拿到性能数据后需要将数据利用起来,下面对性能数据进行分析 实现:如果性能达到设定的阈值,那么这段时间执行的用例就是性能较差的用例 确定阈值 首先确定一个阈值来当做性能的告警值,暂定为以下算法 # t ...
- 整装待发 QTA UI自动化测试框架迎来大更新 1
整装待发 QTA UI自动化测试框架迎来大更新 QTA是什么 QTA是一个跨平台的测试自动化工具,适用于后台.原生或混合型客户端应用的测试.在腾讯内部,QTA是腾讯元老级的自动化测试项目,从研发至今已 ...
- python3.7界面设计_基于selenium+Python3.7+yaml+Robot Framework的UI自动化测试框架
前端自动化测试框架 项目说明 本框架是一套基于selenium+Python3.7+yaml+Robot Framework而设计的数据驱动UI自动化测试框架,Robot Framework 作为执行 ...
- python ui自动化测试框架_基于python语言下的UI自动化测试框架搭建(一)
最近在搭一个UI自动化测试框架,想把整个搭建过程分享出来,如果有不对的地方,希望大家能够指正,首先创建一个名称为,antomation_framework_demo的工程文件, pycharm中工程及 ...
- WEB UI自动化测试框架搭建(一)_公用方法Utils
本栏目内的所有项目使用的都是PyCharm 2020.1专业版,可以下载后自行在网上找教程破解. WEB UI自动化测试框架搭建(一)~(七)源代码:https://download.csdn.net ...
最新文章
- ubuntu 14.04 安装redmine
- wenbao与string
- 一方包,二方包,三方包的区别
- Objects.equals 有坑!!!
- 信息学奥赛一本通(2038:【例5.5】最大数位置)
- 使用ResourceBundle读取配置文件
- Python列表和元组比较
- Java 重载、重写(Override、Overload)
- 由于未安装.net framework 4.0的miscrosoft office支持,无法加载以下解决方案 ***.vsto
- java treetable_00035-layui+java 树形表格treeTable(异步请求)
- 内外网双网卡同时上网
- Java 基础 —— Hello World
- 语音识别语言模型介绍
- android图片按比例缩放,Android开发之imageView图片按比例缩放的实现方法
- REWORK读书笔记
- 职场打拼小妙招,建议你们收藏使用!
- android音乐播放器实验报告总结,音乐播放器设计实验报告.docx
- 微信信息如何在服务器加密,微信 消息加解密说明
- 关于移动端IOS input弹起键盘时,引起高度问题
- node 项目打包工具ncc
热门文章
- Rxjava入门与使用
- 计算机设备没有音频,电脑没有音频设备怎么办,小编教你电脑没有音频设备怎么解决...
- 帝国CMS7.5仿《女人说》模板源码/帝国CMS内核女性生活时尚门户网站模板
- 别再纠结页面设计!挑选小程序页面设计模板就对了
- android gps nmea,读取Android GPS NMEA数据
- Lisp语言:列表(List)
- 上奇产业通:全国人工智能产业分析报告
- 火狐浏览器被恶意篡改,劫持(打开同时跳出主页和2345网页)
- 仅用3年,狂揽国内70%的软件市场,低代码已成气候!
- u-boot 2015.01 :has EABI version 0, but target u-boot has EABI version 4