Robotframework-Appium 之常用API（二）
续接上一文，更多API详细如下：
注：更多官方详情信息见 http://robotframework.org/robotframework/
28. Name: Install App
Source: AppiumLibrary <test library>
Arguments: [ app_path | app_package ]
Install App via Appium.
通过Appium安装App。
Android only.
app_path - path to app
app_package - package of install app to verify
29. Name: Launch Application
Source: AppiumLibrary <test library>
Arguments: [ ]
Launch application. Application can be launched while Appium session running. This keyword can be used to launch application during test case or between test cases.
启动程序。 应用程序可以在Appium会话运行时启动。 此关键字可用于在测试用例期间或测试用例之间启动应用程序。
This keyword works while `Open Application` has a test running. This is good practice to `Launch Application` and `Quit Application` between test cases. As Suite Setup is `Open Application`, `Test Setup` can be used to `Launch Application`
30. Name: Log Source
Source: AppiumLibrary <test library>
Arguments: [ loglevel=INFO ]
Logs and returns the entire html source of the current page or frame.
记录并返回当前页面或框架的整个html源。
The `loglevel` argument defines the used log level. Valid log levels are `WARN`, `INFO` (default), `DEBUG`, `TRACE` and `NONE` (no logging).
31. Name: Long Press
Source: AppiumLibrary <test library>
Arguments: [ locator ]
Long press the element.
长按某元素。
32. Name: Long Press Keycode
Source: AppiumLibrary <test library>
Arguments: [ keycode | metastate=None ]
Sends a long press of keycode to the device.
向设备发送长按键代码。
Android only.
See `press keycode` for more details.
33. Name: Open Application
Source: AppiumLibrary <test library>
Arguments: [ remote_url | alias=None | **kwargs ]
Opens a new application to given Appium server.
打开一个新应用通过Appium服务器。
Capabilitiesofappiumserver,AndroidandiOS,Pleasecheckhttp://appium.io/slate/en/master/?python#appium-server-capabilities
34. Name: Press Keycode
Source: AppiumLibrary <test library>
Arguments: [ keycode | metastate=None ]
Sends a press of keycode to the device.
向设备发送按键代码。
Android only.
Possible keycodes& meta states can be found in http://developer.android.com/reference/android/view/KeyEvent.html
35. Name:Quit Application
Source: AppiumLibrary <test library>
Arguments:[ ]
Quit application. Application can be quit while Appium session is kept alive. This keyword can be used to close application during test case or between test cases.
退出应用。 在Appium会话保持活动状态时，应用程序可以退出。 此关键字可用于在测试用例期间或测试用例之间关闭应用程序。
See `Launch Application` for an explanation.
New in AppiumLibrary 1.4.6
36. Name: Remove Application
Source: AppiumLibrary <test library>
Arguments: [ application_id ]
Removes the application that is identified with an application id .
删除应用程序。
Example:
Remove Application com.netease.qa.orangedemo
37. Name: Reset Application
Source: AppiumLibrary <test library>
Arguments: [ ]
Reset application. Open Application can be reset while Appium session is kept alive.
重置应用。 Appium会话保持活动状态时，可以重置打开应用程序。
38. Name: Scroll
Source: AppiumLibrary <test library>
Arguments: [ start_locator | end_locator ]
Scrolls from one element to another Key attributes for arbitrary elements are `id` and `name`. See `introduction` for details about locating elements.
39. Name: Scroll Down
Source: AppiumLibrary <test library>
Arguments: [ locator ]
Scrolls down to element.
向下滚动到元素。
40. Name: Scroll Up
Source: AppiumLibrary <test library>
Arguments: [ locator ]
Scrolls up to element.
向上滚动到元素。
41. Name: Shake
Source: AppiumLibrary <test library>
Arguments: [ ]
Shake the device.
摇晃设备。
42. Name: Start Activity
Source: AppiumLibrary <test library>
Arguments: [ appPackage | appActivity | **opts ]
Opens an arbitrary activity during a test. If the activity belongs to another application, that application is started and the activity is opened.
在测试期间打开一个活动。 如果活动属于另一个应用程序，则启动该应用程序并打开活动。
Android only.
appPackage - The package containing the activity to start.
appActivity - The activity to start.
appWaitPackage - Begin automation after this package starts (optional).
appWaitActivity - Begin automation after this activity starts (optional).
intentAction - Intent to start (opt_ional).
intentCategory - Intent category to start (optional).
intentFlags - Flags to send to the intent (optional).
optionalIntentArguments - Optional arguments to the intent (optional).
stopAppOnReset - Should the app be stopped on reset (optional)?
43. Name: Swipe
Source: AppiumLibrary <test library>
Arguments:[ start_x | start_y | offset_x | offset_y | duration=1000 ]
Swipe from one point to another point, for an optional duration.
连续从一个点滑动到另一个点。
Args:
start_x - x-coordinate at which to start
start_y - y-coordinate at which to start
offset_x - x-coordinate distance from start_x at which to stop
offset_y - y-coordinate distance from start_y at which to stop
duration - (optional) time to take the swipe, in ms.
Usage:
Swipe 500 100 100 0 1000
NOTE: Android 'Swipe' is not working properly, use offset_x and offset_y as if these are destination points.
44. Name: Switch To Context
Source: AppiumLibrary <test library>
Arguments: [ context_name ]
Switch to a new context.
切换到新的上下文。
45. Name: Tap
Source: AppiumLibrary <test library>
Arguments: [ locator | x_offset=None | y_offset=None | count=1 ]
Tap element identified by locator.
点击已定位标识的元素。
Args:
x_offset - (optional) x coordinate to tap, relative to the top left corner of the element.
y_offset - (optional) y coordinate. If y is used, x must also be set, and vice versa
count - can be used for multiple times of tap on that element
46. Name: Zoom
Source: AppiumLibrary <test library>
Arguments: [ locator | percent=200% | steps=1 ]
Zooms in on an element a certain amount.
放大元素到一定数量。
47. Name: Wait Activity
Source: AppiumLibrary <test library>
Arguments: [ activity | timeout | interval=1 ]
Wait for an activity: block until target activity presents or time out.
等待一个活动：阻止直到目标活动出现或超时。
Android only.
activity - target activity
timeout - max wait time, in seconds
interval - sleep interval between retries, in seconds
上面都是实践过程会经常用的API，需熟练掌握~
