AppiumLibrary用户关键字

Posted 2020-09-25 悠然现南山

*** Settings ***
Library           AppiumLibrary
Library           AutoItLibrary
Library           os

*** Keywords ***
xpath应该匹配次数
    [Arguments]    ${xpath}    ${count}
    Xpath Should Match X Times    ${xpath}    ${count}

上传文件
    [Arguments]    ${path}    ${data}    ${encode}=base64
    Push File    ${path}    ${data}    ${encode}

元素不应该包含文本
    [Arguments]    ${locator}    ${expected}    ${msg}=
    Element Should not Contain Text    ${locator}    ${expected}    ${msg}

元素值应该是
    [Arguments]    ${locator}    ${expected}
    Element Value Should Be    ${locator}    ${expected}

元素名应该是
    [Arguments]    ${path}    ${name}
    Element Name Should Be    ${path}    ${name}

元素属性应该匹配
    [Arguments]    ${locator}    ${attr_name}    ${match_pattern}    ${regx}=False
    Element Attribute Should Match    ${locator}    ${attr_name}    ${match_pattern}    ${regx}

元素应该包含文本
    [Arguments]    ${locator}    ${expected}    ${msg}=None
    Element Should Contain Text    ${locator}    ${expected}    ${msg}

元素应该失效
    [Arguments]    ${locator}    ${level}=INFO
    Element should be disabled    ${locator}    ${level}

元素应该有效
    [Arguments]    ${locator}    ${level}=INFO
    Element should be enabled    ${locator}    ${level}

元素文本应该是
    [Arguments]    ${locator}    ${expected}    ${msg}=None
    Element Text Should Be    ${locator}    ${expected}    ${msg}

关闭当前应用
    Close Application

关闭所有应用
    Close All Applications

切换应用
    [Arguments]    ${index_or_alias}
    Switch Application    ${index_or_alias}

切换页面内容
    [Arguments]    ${webview}
    Switch To Context    ${webview}

卸载应用
    [Arguments]    ${application_id}
    Remove Application    ${application_id}

后台运行
    [Arguments]    ${sec}
    Background App    ${sec}

向上滚动
    [Arguments]    ${locator}
    Scroll Up    ${locator}

向下滚动
    [Arguments]    ${locator}
    Scroll Down    ${locator}

失败后运行关键字
    [Arguments]    ${keyword}
    [Documentation]    Example:    # Disables run-on-failure functionality and stores the previous kw name in a variable.    # Restore to the previous keyword.
    ...
    ...    Register Keyword To Run On Failure \ \ \ Log Source
    ...    \ \ \ \ \ \ \ # Run `Log Source` on failure.
    ...
    ...    ${previous kw}=
    ...    Register Keyword To Run On Failure \ \ Nothing
    ...
    ...
    ...    Register Keyword To Run On Failure \ \ \ \ ${previous kw} \ \ \     Register Keyword To Run On Failure    ${keyword}

打印资源
    [Arguments]    ${level}
    Log Source    ${level}

打开URL
    [Arguments]    ${url}
    [Documentation]    Example:
    ...
    ...    打开应用
    ...    http://localhost:4755/wd/hub \ platformName=ios \ platformVersion=7.0
    ...    deviceName=‘iPhone Simulator‘
    ...    browserName=Safari
    ...
    ...    打开URL \ http://m.webapp.com
    Go To URL    ${url}

打开应用
    [Arguments]    ${url}    ${platformName}    ${version}    ${deviceName}    ${app}
    [Documentation]    打开应用 ${url} ${platformName} ${version} \ \ ${devicename} ${app} @{args}
    ...
    ...    例如：
    ...
    ...    打开应用 http://localhost:4723/wd/hub android 5.1.1 5e25d20d ${CURDIR}${/}app${/}fft.apk
    ...
    ...    ${url} 是用于访问应用的地址，一般是固定的。 url 和 端口可以根据具体地址修改。
    ...    ${version} \ 是安卓的版本
    ...    ${devicename} 是手机的UDID, 可以打开cmd 然后用 adb devices -l \ 看到设备列表。
    ...    UDID 是看到的第一列的内容，真机是一串字符串，模拟器是 \ ip:port \ 的形式
    ...    ${app} 是apk 存放的路径 ${CURDIR} 系统变量，取得当前脚本路径。 ${/} 系统变量 ‘/‘
    open application    ${url}    platformName=${platformName}    platformVersion=${version}    deviceName=${deviceName}    app=${app}

按关键字
    [Arguments]    ${keycode}    ${metastate}=None
    Press Keycode    ${keycode}    ${metastate}

摇动手机
    Shake

放大元素
    [Arguments]    ${locator}    ${percent}=200%    ${step}=1
    Zoom    ${locator}    ${percent}    ${step}

敲击元素
    [Arguments]    ${locator}
    Tap    ${locator}

横屏
    [Documentation]    手机设置横屏
    LANDSCAPE

清除文本
    [Arguments]    ${locator}
    Clear Text    ${locator}

滑动
    [Arguments]    ${start_x}    ${start_y}    ${end_x}    ${end_y}
    swipe    ${start_x}    ${start_y}    ${end_x}    ${end_y}

滚动
    [Arguments]    ${start_locator}    ${end_locator}
    [Documentation]    从一个元素滚动到另一个元素
    Scroll    ${start_locator}    ${end_locator}

点击元素
    [Arguments]    ${locator}
    Click Element    ${locator}

点击元素坐标
    [Arguments]    ${coordinate_x}    ${coordinate_y}
    Click Element At Coordinates    ${coordinate_x}    ${coordinate_y}

点击固定点
    [Arguments]    ${x}    ${y}    @{args}
    Click A Point    ${x}    ${y}    @{args}

点击按钮
    [Arguments]    ${index_or_name}
    Click Button    ${index_or_name}

点击文本
    [Arguments]    ${text}    ${exact_match}=false
    [Documentation]    点击匹配到文本的元素：
    ...
    ...    点击文本 "text"
    ...    点击文本 "text" True
    ...
    ...    默认模糊匹配所有元素，可以设置成精确匹配。
    ...    如果可以匹配到两个或两个以上的元素，那么需要用 click Element 元素，去处理。
    Click Text    ${text}    ${exact_match}

睡眠
    [Arguments]    ${sec}
    sleep    ${sec}

竖屏
    PORTRAIT

等待页面元素出现
    [Arguments]    ${locator}    ${timeout}=100    ${err}=None
    Wait Until Page Contains Element    ${locator}    ${timeout}    ${err}

等待元素出现文本
    [Arguments]    ${text}    ${timeout}=10    ${err}=None
    Wait Until Page Contains    ${text}    ${timeout}    ${err}

等待页面不包含元素
    [Arguments]    ${locator}    ${timeout}=10    ${err}=None
    Wait Until Page Does Not Contain Element    ${locator}    ${timeout}    ${err}

等待页面不包含文本
    [Arguments]    ${text}    ${timeout}=10    ${err}=None
    Wait Until Page Does Not Contain    ${text}    ${timeout}    ${err}

缩小元素
    [Arguments]    ${locator}    ${percent}=200%    ${step}=1
    Pinch    ${locator}    ${percent}    ${step}

获取Appium超时时间
    ${timeout}    Get Appium Timeout
    [Return]    ${timeout}

获取Web元素
    [Arguments]    ${locator}
    [Documentation]    获取匹配的定位器的第一个元素：
    ...
    ...    ${element} 获取Web元素 id=name
    ...    点击元素 ${element}
    ${element}    Get Webelement    ${locator}
    [Return]    ${element}

获取元素坐标
    [Arguments]    ${locator}
    ${location}    Get Element Location    ${locator}
    [Return]    ${location}

获取元素尺寸
    [Arguments]    ${locator}
    ${size}    Get Element Size    ${locator}
    [Return]    ${size}

获取元素属性
    [Arguments]    ${locator}    ${name_or_value}
    [Documentation]    获取元素属性：（name 或者 value)
    ...    ${val} \ 获取元素属性 ${locator} ${name_or_value}
    ...
    ...    例如：
    ...    ${val} 获取元素属性 id=xxxx name
    ...    ${val} 获取元素属性 id=xxxx value
    ${val}    Get Element Attribute    ${locator}    ${name_or_value}
    [Return]    ${val}

获取匹配xpath数
    [Arguments]    ${xpath}
    [Documentation]    例如：
    ...
    ...    ${count} \ \ \ 获取匹配xpath数 \ \ //android.view.View[@text=‘Test‘]
    ${count}    Get Matching Xpath Count    ${xpath}
    [Return]    ${count}

获取可见文本
    ${contents}    Get Contexts
    [Return]    ${contents}

获取当前文本
    ${context}    Get Current Context
    [Return]    ${context}

获取所有web元素
    [Arguments]    ${locator}
    [Documentation]    @{element} 获取所有web元素 id=my_element
    ...    点击元素 @{element}[2]
    @{element}    Get Webelements    ${locator}
    [Return]    @{element}

获取文件
    [Arguments]    ${file_path}    ${decode}=False
    pull file    ${file_path}    ${decode}

获取文件夹
    [Arguments]    ${folder_path}    ${decode}=False
    Pull Folder    ${folder_path}    ${decode}

获取文本
    [Arguments]    ${locator}
    [Documentation]    获取符合元素的文本：
    ...    ${text} \ 获取文本 \ //*[contains(@text,‘foo‘)]
    ${text}    Get Text    ${locator}
    [Return]    ${text}

获取网络连接情况
    ${stat}    Get Network Connection Status
    [Return]    ${stat}

获取资源
    ${source}    Get Source
    [Return]    ${source}

设置Appium超时
    [Arguments]    ${sec}
    Set Appium Timeout    ${sec}

设置网络连接状态
    [Arguments]    ${sec}
    Set Network Connection Status    ${sec}

输入值
    [Arguments]    ${locator}    ${val}
    Input Value    ${locator}    ${val}

输入密码
    [Arguments]    ${path}    ${passwd}
    Input Password    ${path}    ${passwd}

输入文本
    [Arguments]    ${path}    ${text}
    Input Text    ${path}    ${text}

返回
    [Documentation]    浏览器返回上一个的页面
    Go Back

重置应用
    Reset Application

锁屏
    [Arguments]    ${sec}
    [Documentation]    这个方法只使用于IOS
    Lock    ${sec}

长按元素
    [Arguments]    ${locator}
    Long Press    ${locator}

长按关键字
    [Arguments]    ${keycode}    ${metastate}=None
    [Documentation]    keycode 可以在这个网址里面找到：
    ...    http://developer.android.com/reference/android/view/KeyEvent.html.
    ...
    ...    Args:
    ...    \ \ \ \ - keycode - the keycode to be sent to the device
    ...    \ \ - metastate - meta information about the keycode being sent
    Long Press Keycode    ${keycode}    ${metastate}

隐藏键盘
    Hide Keyboard

页面不应该包含元素
    [Arguments]    ${locator}    ${lvl}=INFO
    Page Should Not Contain Element    ${locator}    ${lvl}

页面不应该包含文本
    [Arguments]    ${locator}    ${lvl}=INFO
    Page Should Not Contain Text    ${locator}    ${lvl}

页面应该包含元素
    [Arguments]    ${locator}    ${lvl}=INFO
    Page Should Contain Element    ${locator}    ${lvl}

页面应该包含文本
    [Arguments]    ${locator}    ${lvl}=INFO
    Page Should Contain Text    ${locator}    ${lvl}

页面截图
    [Arguments]    ${filename}=
    Capture Page Screenshot    ${filename}