Appium之Toast元素识别教程与实例
一、Toast简介
Toast是Android系统中的轻量级消息提示框，以浮动形式短暂显示（通常2-3秒），无法被点击且不会获取焦点。常见于登录失败、操作提示等场景，如“密码错误”或“网络异常”。传统定位工具无法直接捕获，需借助Appium的特定配置实现。

二、环境准备

Node.js安装

官网下载并安装Node.js，验证安装成功：npm -v。
切换npm镜像源

使用淘宝镜像加速依赖下载：

npm config set registry https://registry.npm.taobao.org

安装cnpm替代npm：

npm install -g cnpm --registry=https://registry.npm.taobao.org
```[2](@ref)[3](@ref)

安装uiautomator2驱动

执行命令：

cnpm install appium-uiautomator2-driver

安装后检查node_modules目录是否存在相关文件。
安装Selenium

通过pip安装：

pip install selenium

验证版本：

pip show selenium

三、关键配置
在Capability中必须添加以下参数以启用UiAutomator2引擎：

desired_caps['automationName'] = 'uiautomator2'

⚠️ 注意：此配置可能导致Appium运行速度变慢，非必要场景建议使用默认引擎。

四、定位Toast元素的方法

1.XPath定位

通过文本内容：error_message = “登录密码错误”

xpath = '//*[@text="{}"]'.format(error_message)
toast_element = WebDriverWait(driver, 5).until(lambda x: x.find_element_by_xpath(xpath))
```[2](@ref)[5](@ref)

通过class属性（通用方法）：

toast_element = driver.find_element(AppiumBy.XPATH, "//*[@class='android.widget.Toast']")
```[6](@ref)[7](@ref)

2.显式等待与动态函数
使用WebDriverWait确保捕获短暂出现的Toast：

from selenium.webdriver.support.ui import WebDriverWait
toast = WebDriverWait(driver, timeout=5, poll_frequency=0.5).until(lambda x: x.find_element(AppiumBy.XPATH, "//*[@class='android.widget.Toast']")
)
```[5](@ref)[6](@ref)

五、实战案例：登录失败捕获Toast
场景：输入错误密码后获取提示“账号或密码错误”。
代码示例：

# coding=utf-8  # 必须添加，避免中文编码问题[3](@ref)[5](@ref)
from appium import webdriver
from selenium.webdriver.support.ui import WebDriverWait# 配置Capability
desired_caps = {"platformName": "Android","automationName": "uiautomator2","appPackage": "com.example.app","appActivity": ".MainActivity"
}
driver = webdriver.Remote("http://localhost:4723/wd/hub", desired_caps)# 执行登录操作
driver.find_element_by_id("username_input").send_keys("test")
driver.find_element_by_id("password_input").send_keys("wrong_password")
driver.find_element_by_id("login_btn").click()# 捕获Toast
try:toast_text = WebDriverWait(driver, 5).until(lambda x: x.find_element(AppiumBy.XPATH, "//*[contains(@text, '密码错误')]")).textprint("捕获到的Toast内容：", toast_text)
except TimeoutException:print("未找到Toast提示")

输出结果：

捕获到的Toast内容：账号或密码错误

六、常见问题与解决

1.Toast无法定位
检查automationName是否为uiautomator2。确保Appium版本≥1.6.3，建议使用1.20+。

2.中文乱码
在Python脚本开头添加# coding=utf-8。

3.Toast显示时间过短
缩短poll_frequency（如0.1秒），增加检测频率。

七、扩展：封装Toast判断函数

def get_toast_text(driver, timeout=5):try:toast_loc = (AppiumBy.XPATH, "//*[@class='android.widget.Toast']")toast_element = WebDriverWait(driver, timeout).until(EC.presence_of_element_located(toast_loc))return toast_element.textexcept:return None

调用示例：

toast = get_toast_text(driver)
if toast == "登录成功":print("测试通过")
```[6](@ref)[7](@ref)