APPIUM API整理（python）---元素查找

Posted 2020-10-08

最近在学习自动化框架appium，网上找一些API相关资料整理了一下

1.find_element_by_id

find_element_by_id(self, id_):

Finds element within this element‘s children by ID（通过元素的ID定位元素）

:Args: - id_ - ID of child element to locate.

用法 driver. find_element_by_id(“id”)

find_element_by_id方法，是对于那些有id而且可以互相区分的控件的操作使用，一般通过android sdk 的tools路径下的uiautomatorviewer.bat自带工具来获取，

使用这个工具首先要确保前面环境配置ok，然后确定测试机器或android模拟器处于连接状态（cmd上输入adb devices），下面是使用uiautomatorviewer.bat工具

获取resource-id

代码举例：

#点击天气应用
driver.find_element_by_id(‘com.huawei.android.totemweather:id/mulan_widget_currentweather_smallicon‘).click()　　

 2.find_element_by_xpath

find_element_by_xpath(self, xpath):

Finds element by xpath（通过Xpath定位元素，详细方法可参阅http://www.w3school.com.cn/xpath/ ）

```
:Args:

xpath - xpath of element to locate. "//input[@class=‘myelement‘]"

Note: The base path will be relative to this element‘s location.

This will select the first link under this element.

::

myelement.find_elements_by_xpath(".//a")

However, this will select the first link on the page.

::

myelement.find_elements_by_xpath("//a")
```

用法 find_element_by_xpath(“//*”)

find_element_by_xpath方法也需要使用uiautomatorviewer.bat工具来定位控件，如下图所示右边相机控件id为空，这时就需要使用xpath来定位元素了，

我们可以使用xpath用text和index来定位元素，可以这样定位相机： 

driver.find_element_by_xpath("//android.widget.TextView[contains(@text,‘相机‘)]")

driver.find_element_by_xpath("//android.widget.TextView[contains(@index,8)]")

如下图的图库那个控件index和天气温度控件是相同的，都是index=7，就只能用text或text与index结合了，如：

driver.find_element_by_xpath("//android.widget.TextView[contains(@text,‘图库‘)]")

driver.find_element_by_xpath("//android.widget.TextView[contains(@text,‘图库‘)[email protected]=‘7‘]")

上面的代码就可以这样写 

# -*-coding=utf-8 -*-

from appium import webdriver
import time
desired_caps = {
‘platformName‘ : ‘Android‘,
‘deviceName‘ : ‘76P4C15813005463‘,
‘platformVersion‘ : ‘5.1‘,
#测试apk包名
‘appPackage‘ : ‘com.huawei.android.launcher‘,
#测试apk的launcherActivity
‘appActivity‘ : ‘.Launcher‘,
}
#进入android系统launcher
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘,desired_caps)
time.sleep(5)
#从launcher主界面进入相机应用并退出的两种方法
driver.keyevent(‘3‘)
#xpath使用text定位控件
driver.find_element_by_xpath("//android.widget.TextView[contains(@text,‘相机‘)]").click()
time.sleep(2)
driver.keyevent(‘3‘)
time.sleep(2)
#xpath使用index定位控件
driver.find_element_by_xpath("//android.widget.TextView[contains(@index,8)]").click()
time.sleep(2)
driver.keyevent(‘3‘)
time.sleep(2)

#从launcher主界面进入图库应用并退出的两种方法
#xpath使用text定位控件
driver.find_element_by_xpath("//android.widget.TextView[contains(@text,‘图库‘).click()
time.sleep(2)
driver.keyevent(‘3‘)
time.sleep(2)
#xpath使用text与index一起定位控件
driver.find_element_by_xpath("//android.widget.TextView[contains(@text,‘图库‘)[email protected]=‘7‘]").click()
time.sleep(5)
driver.keyevent(‘3‘)
time.sleep(2)

driver.quit()

 3. find_element_by_name

find_element_by_name(self, name):

Finds element within this element‘s children by name【通过元素Name定位（元素的名称属性text）】

:Args: - name - name property of the element to find.

 

用法： driver.find_element_by_name(“name”)

find_elements_by_name方法的控件元素也需要使用uiautomatorviewer.bat工具来定位，如上面例子中带有text信息的控件就可以直接使用，如

driver.find_element_by_xpath("//android.widget.TextView[contains(@text,‘相机‘)]")

driver.find_element_by_xpath("//android.widget.TextView[contains(@index,8)]")　

可以使用

driver.find_element_by_name(‘相机‘)

脚本如下

from appium import webdriver
import time
desired_caps = {
‘platformName‘ : ‘Android‘,
‘deviceName‘ : ‘76P4C15813005463‘,
‘platformVersion‘ : ‘5.1‘,
#测试apk包名
‘appPackage‘ : ‘com.huawei.android.launcher‘,
#测试apk的launcherActivity
‘appActivity‘ : ‘.Launcher‘,
}
#进入android系统launcher
driver = webdriver.Remote(‘http://localhost:4723/wd/hub‘,desired_caps)
time.sleep(5)

#name方法进入相机应用
time.sleep(2)
driver.find_element_by_name("相机").click()
time.sleep(5)

driver.quit()

 4. find_element_by_class_name

find_element_by_class_name(self, name):

Finds element within this element‘s children by class name（通过元素class name属性定位元素 ）

:Args: - name - class name to search for.

用法 driver. find_element_by_class_name(“android.widget.LinearLayout”)

find_element_by_class_name方法其实很不实用，一般控件的class基本相同，如下图上面的应用控件class都是android.widget.TextView，所以不好区分元素。

 5. find_element_by_link_text

find_element_by_link_text(self, link_text):

Finds element within this element‘s children by visible link text.
通过元素可见链接文本定位
:Args:
- link_text - Link text string to search for.
用法 driver.find_element_by_link_text(“text”)　　

 

 6. find_elements_by_link_text

find_element_by_link_text(self, link_text):

Finds a list of elements within this element‘s children by visible link text
通过元素可见链接文本定位,含有该属性的所有元素
:Args:
- link_text - Link text string to search for.
用法 driver.find_elements_by_link_text(“text”)

 7. find_element_by_partial_link_text

find_element_by_partial_link_text(self, link_text): 

 

 8. find_element_by_tag_name

find_element_by_tag_name(self, name):

Finds element within this element‘s children by tag name.
通过查找html的标签名称定位元素
:Args:
- name - name of html tag (eg: h1, a, span)
用法 driver.find_element_by_tag_name(“name”) 

9. find_element_by_css_selector

find_element_by_css_selector(self, css_selector):

‘Finds element within this element‘s children by CSS selector.
通过CSS选择器定位元素
:Args:
- css_selector - CSS selctor string, ex: ‘a.nav#home‘　 
’

10. find_element_by_ios_uiautomation

find_element_by_ios_uiautomation(self, uia_string): 

Finds an element by uiautomation in iOS.
通过iOS uiautomation查找元素
:Args:
- uia_string - The element name in the iOS UIAutomation library

:Usage:
driver.find_element_by_ios_uiautomation(‘.elements()[1].cells()[2]‘)
用法dr. find_element_by_ios_uiautomation(‘elements’)　 

 11. find_element_by_accessibility_id

find_element_by_accessibility_id(self, id):

Finds an element by accessibility id.
通过accessibility id查找元素
:Args:
- id - a string corresponding to a recursive element search using the
Id/Name that the native Accessibility options utilize

:Usage:
driver.find_element_by_accessibility_id()
用法driver.find_element_by_accessibility_id(‘id’)

 

 

学习地址：

http://blog.csdn.net/bear_w/article/details/50330565

http://blog.csdn.net/bear_w/article/details/50330565