Input Text和Click Button

Input Text 关键字一般用来给输入框进行输入操作，该关键字接收两个参数[ locator | text ]。

示例1：启动安卓手机上一个APP的MainActivity，在打开Activity，进入界面后，分别向两个EditText输入框中输入12，并且点击按钮“计算”来计算出输入的这两个数字的乘积。

APP的界面如下，提供了两个输入框，还有一个计算的Button按钮。

在写这个自动化案例前，我们可以使用安卓SDK提供的Ui Automator Viewer工具来进行这个界面的资源定位。通过定位后，可以看到第一个EditText输入框的resource-id为com.example.calculator:id/factorone，class为android.widget.EditText，name为请输入数字，如下图所示。

第二个EditText输入框的resource-id为com.example.calculator:id/factortwo，class为android.widget.EditText，name为请输入数字，如下图所示。

Button按钮的resource-id为com.example.calculator:id/commit，class为android.widget.Button，name为计算，如下图所示。

Click Button关键字用来模拟点击APP上的一个button按钮，该关键字接收一个参数[ index_or_name ]。

Open Application    http://localhost:4723/wd/hub  platformName=Android platformVersion=22       deviceName=98YFBP522VSU       app=C:/Users/yongqing/Desktop/app-debug.apk   appPackage=com.example.calculator    appActivity=MainActivity

Input Text      id=com.example.calculator:id/factorone   12

Input Text      id=com.example.calculator:id/factortwo   12

Click Button     计算

执行结果：

可以看到已经执行成功，上面是通过resource-id的方式来定位EditText输入框，并且通过name的方式来定位button按钮。

下面通过另一种方式，用name的方式来定位EditText输入框，通过index的方式来点击button按钮

Open Application   http://localhost:4723/wd/hub  platformName=Android platformVersion=22       deviceName=98YFBP522VSU       app=C:/Users/yongqing/Desktop/app-debug.apk   appPackage=com.example.calculator

Input Text       name=请输入数字 12

Input Text       name=请输入数字 14

Click Button   index=0

执行结果：

在通过index的方式来点击button按钮的时候，需要注意index的取值，不要和通过Ui Automator Viewer工具看到的index混淆，先看一段AppiumLibrary库的源码，在这里选取了源码中的三个函数。从如下三个函数中可以看到click_button关键字支持name和index两种方式来定位一个button，在使用index的时候，是根据class_name，即通过android.widget.Button这个class_name来找出当前界面中有几个button按钮（源码中通过elements = self._find_elements_by_class_name(class_name)来寻找有几个button按钮，就会返回几个element），然后每个 button按钮按照index的方式来取出（源码中通过element = elements[index]来得到具体的一个button按钮）。

AppiumLibrary库函数1：

def click_button(self, index_or_name):

""" Click button """

_platform_class_dict = {'ios': 'UIAButton',

'android': 'android.widget.Button'}

if self._is_support_platform(_platform_class_dict):

class_name = self._get_class(_platform_class_dict)

self._click_element_by_class_name(class_name, index_or_name)

AppiumLibrary库函数2：

def _click_element_by_class_name(self, class_name, index_or_name):

element = self._find_element_by_class_name(class_name, index_or_name)

self._info("Clicking element '%s'." % element.text)

try:

element.click()

except Exception as e:

raise 'Cannot click the %s element "%s"' % (class_name, index_or_name)

AppiumLibrary库函数3：

def _find_element_by_class_name(self, class_name, index_or_name):

elements = self._find_elements_by_class_name(class_name)

print 'elements:"%s"' % elements

if self._is_index(index_or_name):

try:

index = int(index_or_name.split('=')[-1])

print 'index:"%s"' % index

element = elements[index]

print 'element:' , element

except (IndexError, TypeError):

raise 'Cannot find the element with index "%s"' % index_or_name

else:

found = False

for element in elements:

self._info("'%s'." % element.text)

if element.text == index_or_name:

found = True

break

if not found:

raise 'Cannot find the element with name "%s"' % index_or_name

下面这个界面中，放入了两个button按钮，一个button按钮是计算按钮，一个button按钮是取消按钮。

在执行时，通过elements = self._find_elements_by_class_name(class_name)得到所有的button按钮后，再用print 'elements:"%s"' % elements可以打印出获取到的elements，也就是所有的button，从如下的输出结果可以看到，elements会存放在一个list列表中，该list 列表中，共有两个元素，代表取到了两个button按钮。

打印输出结果：

elements:"[<appium.webdriver.webelement.WebElement (session="8e85c12f-2243-4b82-abfc-d091fddbed8b", element="4")>, <appium.webdriver.webelement.WebElement (session="8e85c12f-2243-4b82-abfc-d091fddbed8b", element="5")>]"

当index 为0时，会取到第一个按钮，也就是“计算”这个button按钮，当index为1时，会取到第二个按钮，也就是“取消”这个button按钮。当index超过1后，那么就会报错啦，此时源码中会通过raise 'Cannot find the element with index "%s"' % index_or_name来抛出一个异常，告诉使用者，不能通过当前的index获取到element（也就是此时无法获取到任何button按钮啦）。

示例2：通过xpath的方式定位元素，这里依旧用上面的APP界面为示例。

用xpath的方式定位第一个EditText输入框和第二个EditText输入框，示例如下：

Open Application    http://localhost:4723/wd/hub    platformName=Android    platformVersion=22    deviceName=98YFBP522VSU app=C:/Users/yongqing/Desktop/app-debug.apk appPackage=com.example.calculator    appActivity=MainActivity

Input Text  xpath=//android.widget.EditText[1]  12

Input Text  xpath=//android.widget.EditText[2]  14

Click Button    计算

执行结果：

Starting test: RobotFrameworkTest1.TestSuite5.TestCase005

20170510 13:45:07.381 :  INFO : Typing text '12' into text field 'xpath=//android.widget.EditText[1]'

20170510 13:45:07.381 :  INFO : msg:find xpath=//android.widget.EditText[1]

20170510 13:45:07.381 :  INFO : prefix: xpath

20170510 13:45:07.397 :  INFO : criteria: //android.widget.EditText[1]

20170510 13:45:10.462 :  INFO : elements: [<appium.webdriver.webelement.WebElement (session="ec48b38a-9cbe-457d-94a0-dec662d3f9cb", element="1")>]

20170510 13:45:15.313 :  INFO : Typing text '14' into text field 'xpath=//android.widget.EditText[2]'

20170510 13:45:15.313 :  INFO : msg:find xpath=//android.widget.EditText[2]

20170510 13:45:15.313 :  INFO : prefix: xpath

20170510 13:45:15.313 :  INFO : criteria: //android.widget.EditText[2]

20170510 13:45:15.906 :  INFO : elements: [<appium.webdriver.webelement.WebElement (session="ec48b38a-9cbe-457d-94a0-dec662d3f9cb", element="2")>]

20170510 13:45:21.307 :  INFO : '计算'.

20170510 13:45:21.385 :  INFO : Clicking element '计算'.

Ending test:   RobotFrameworkTest1.TestSuite5.TestCase005

从上面的执行结果看，通过xpath=//android.widget.EditText[1] 定位到了第一个输入框，通过xpath=//android.widget.EditText[2] 定位到了第二个输入框。

示例3：通过accessibility_id的方式定位元素，accessibility_id对应到安卓APP后，其对应的属性为content-desc，这里依旧用上面的APP界面为示例，但是我们对第一个EditText输入框加入了content-desc属性，如下图所示。

Open Application    http://localhost:4723/wd/hub    platformName=Android    platformVersion=22    deviceName=98YFBP522VSU app=C:/Users/yongqing/Desktop/app-debug.apk appPackage=com.example.calculator    appActivity=MainActivity

Input Text  accessibility_id=输入框 23

Input Text  id=com.example.calculator:id/factortwo 12

Click Button    计算

执行结果：

Starting test: RobotFrameworkTest1.TestSuite5.TestCase006

20170510 14:23:09.735 :  INFO : Typing text '23' into text field 'accessibility_id=输入框'

20170510 14:23:09.735 :  INFO : msg:find accessibility_id=输入框

20170510 14:23:16.573 :  INFO : Typing text '12' into text field 'id=com.example.calculator:id/factortwo'

20170510 14:23:16.573 :  INFO : msg:find id=com.example.calculator:id/factortwo

20170510 14:23:22.799 :  INFO : '计算'.

20170510 14:23:22.901 :  INFO : Clicking element '计算'.

Ending test:   RobotFrameworkTest1.TestSuite5.TestCase006

从执行结果看，通过   accessibility_id=输入框 也可以定位到EditText输入框。