Cursor + Selenium/Appium：AI时代的自动化测试新姿势

# 创建虚拟环境python -m venv venvsource venv/bin/activate  # Windows: venv\Scripts\activate# 安装依赖pip install selenium pytest webdriver-manager pytest-html# 验证python -c "from selenium import webdriver; print('Selenium OK')"pytest --version

project/├── pages/│   ├── __init__.py│   ├── base_page.py       # BasePage公共方法│   ├── login_page.py      # 登录页Page Object│   ├── search_page.py     # 搜索页Page Object│   └── cart_page.py       # 购物车页Page Object├── tests/│   ├── __init__.py│   ├── conftest.py        # pytest fixtures│   └── test_login_search_cart.py  # 测试用例├── utils/│   └── __init__.py├── pytest.ini└── requirements.txt

from selenium.webdriver.support.ui import WebDriverWaitfrom selenium.webdriver.support import expected_conditions as ECfrom selenium.webdriver.common.by import Byimport osclass BasePage:    """所有Page Object的基类，封装公共操作"""    def __init__(self, driver):        self.driver = driver        self.wait = WebDriverWait(driver, 10)    def find_element(self, *locator):        return self.wait.until(            EC.presence_of_element_located(locator)        )    def find_clickable(self, *locator):        return self.wait.until(            EC.element_to_be_clickable(locator)        )    def click(self, *locator):        self.find_clickable(*locator).click()    def input_text(self, text, *locator):        element = self.find_element(*locator)        element.clear()        element.send_keys(text)    def get_text(self, *locator):        return self.find_element(*locator).text    def take_screenshot(self, name="screenshot"):        path = os.path.join("screenshots", f"{name}.png")        os.makedirs("screenshots", exist_ok=True)        self.driver.save_screenshot(path)

from selenium.webdriver.common.by import Byfrom pages.base_page import BasePageclass LoginPage(BasePage):    """登录页Page Object"""    # 定位策略：id优先，css其次，xpath兜底    USERNAME_INPUT = (By.ID, "username")    PASSWORD_INPUT = (By.ID, "password")    LOGIN_BUTTON = (By.CSS_SELECTOR, "button[type='submit']")    ERROR_MESSAGE = (By.CLASS_NAME, "error-msg")    def login(self, username, password):        """执行登录操作"""        self.input_text(username, *self.USERNAME_INPUT)        self.input_text(password, *self.PASSWORD_INPUT)        self.click(*self.LOGIN_BUTTON)    def get_error_message(self):        """获取错误提示信息"""        return self.get_text(*self.ERROR_MESSAGE)    def is_loaded(self):        """验证页面是否加载完成"""        return self.find_element(*self.USERNAME_INPUT).is_displayed()

import pytestfrom pages.login_page import LoginPagefrom pages.search_page import SearchPagefrom pages.cart_page import CartPagedef test_login_search_add_cart(driver):    """测试流程：登录→搜索手机→加购物车→验证"""    # Step 1: 登录    login_page = LoginPage(driver)    login_page.login("testuser", "testpass123")    assert login_page.is_loaded() is False  # 登录成功应跳转    # Step 2: 搜索    search_page = SearchPage(driver)    search_page.search("手机")    assert search_page.get_result_count() > 0    # Step 3: 加购物车    search_page.click_first_product()    cart_page = CartPage(driver)    cart_page.add_to_cart()    cart_count = cart_page.get_cart_count()    assert cart_count >= 1, f"购物车数量异常: {cart_count}"

import pytestfrom appium import webdriverfrom appium.webdriver.common.appiumby import AppiumByfrom appium.webdriver.common.touch_action import TouchActionfrom selenium.webdriver.support.ui import WebDriverWaitfrom selenium.webdriver.support import expected_conditions as EC@pytest.mark.androidclass TestAndroidLoginBrowse:    @pytest.fixture(scope="class")    def driver(self):        desired_caps = {            "platformName": "Android",            "automationName": "UiAutomator2",            "appPackage": "com.example.app",  # 替换为实际包名            "appActivity": ".MainActivity",     # 替换为实际Activity            "noReset": True,            "newCommandTimeout": 300,        }        driver = webdriver.Remote("http://127.0.0.1:4723", desired_caps)        yield driver        driver.quit()    def test_login_browse_logout(self, driver):        wait = WebDriverWait(driver, 10)        # Step 1: 登录        username = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "username_input")        ))        username.send_keys("testuser")        password = driver.find_element(            AppiumBy.ACCESSIBILITY, "password_input"        )        password.send_keys("testpass123")        driver.find_element(            AppiumBy.ACCESSIBILITY, "login_button"        ).click()        # Step 2: 验证登录成功（首页元素出现）        home_tab = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "home_tab")        ))        assert home_tab.is_displayed(), "登录后未进入首页"        # Step 3: 滑动浏览首页3次        action = TouchAction(driver)        size = driver.get_window_size()        for i in range(3):            action.press(x=size["width"]//2, y=size["height"]//4) \                 .move_to(x=size["width"]//2, y=size["height"]*3//4) \                 .release().perform()        # Step 4: 点击第2个商品        product = wait.until(EC.presence_of_element_located(            (AppiumBy.XPATH, "(//android.widget.ImageView)[2]")        ))        product.click()        # Step 5: 返回首页→打开侧边栏→退出登录        driver.back()        driver.find_element(            AppiumBy.ACCESSIBILITY, "menu_button"        ).click()        logout_btn = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "logout_button")        ))        logout_btn.click()        # 确认退出        confirm = wait.until(EC.presence_of_element_located(            (AppiumBy.ID, "android:id/button1")        ))        confirm.click()        # 验证回到登录页        login_screen = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "username_input")        ))        assert login_screen.is_displayed(), "退出后未回到登录页"

@pytest.mark.iosclass TestIOSLoginBrowse:    @pytest.fixture(scope="class")    def driver(self):        desired_caps = {            "platformName": "iOS",            "automationName": "XCUITest",            "platformVersion": "17.0",            "deviceName": "iPhone 15",            "app": "/path/to/MyApp.app",  # 替换为实际app路径            "noReset": True,            "newCommandTimeout": 300,        }        driver = webdriver.Remote("http://127.0.0.1:4723", desired_caps)        yield driver        driver.quit()    def test_login_browse_logout(self, driver):        wait = WebDriverWait(driver, 10)        # Step 1: 登录        username = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "username_input")        ))        username.send_keys("testuser")        password = driver.find_element(            AppiumBy.ACCESSIBILITY, "password_input"        )        password.send_keys("testpass123")        driver.find_element(            AppiumBy.ACCESSIBILITY, "login_button"        ).click()        # Step 2: 处理可能的iOS原生alert弹窗        try:            alert = driver.switch_to.alert            alert.accept()        except:            pass  # 无弹窗则继续        # Step 3: 验证登录成功        home_tab = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "home_tab")        ))        assert home_tab.is_displayed()        # Step 4: iOS滑动（用ActionChains）        from selenium.webdriver.common.action_chains import ActionChains        size = driver.get_window_size()        for i in range(3):            ActionChains(driver) \                .move_by_offset(size["width"]//2, size["height"]//4) \                .click_and_hold() \                .move_by_offset(0, size["height"]//2) \                .release() \                .perform()            ActionChains(driver).reset_actions()        # Step 5: 点击第2个商品        product = wait.until(EC.presence_of_element_located(            (AppiumBy.XPATH, "(//XCUIElementTypeImage)[2]")        ))        product.click()        # Step 6: 混合App context切换（如果需要）        if "WEBVIEW" in driver.contexts:            driver.switch_to.context("WEBVIEW")            # 在WebView中操作...            driver.switch_to.context("NATIVE_APP")  # 切回原生        # Step 7: 退出登录        driver.find_element(            AppiumBy.ACCESSIBILITY, "menu_button"        ).click()        logout_btn = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "logout_button")        ))        logout_btn.click()        confirm = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "确认退出")        ))        confirm.click()        # 验证回到登录页        login_screen = wait.until(EC.presence_of_element_located(            (AppiumBy.ACCESSIBILITY, "username_input")        ))        assert login_screen.is_displayed(), "退出后未回到登录页"

# 项目：自动化测试框架# 语言：Python 3.10+# 框架：pytest + Selenium/Appium## 代码结构规则- 使用POM（Page Object Model）设计模式- BasePage封装公共操作，所有Page类继承BasePage- 测试用例文件放在tests/目录，Page Object放在pages/目录- 每个Page类只负责一个页面的元素和操作## 定位策略优先级- Web：id > name > css_selector > xpath- Android：accessibility_id > id > xpath- iOS：accessibility_id > predicate_string > xpath- 禁止使用绝对xpath（如/html/body/div[3]/...）## 等待策略- 统一使用WebDriverWait + expected_conditions- 显式等待超时时间：10秒（可通过参数覆盖）- 禁止使用time.sleep()- 页面加载等待用dom_to_be_loaded## 断言规则- 使用pytest原⽣assert，不引入unittest.AssertionError- 每个测试步骤至少一个断言- 断言失败信息包含：期望值、实际值、上下文## 命名规范- Page类：大驼峰+Page后缀，如LoginPage- 测试函数：test_小驼峰+场景描述，如test_login_with_valid_credentials- 定位变量：全大写+下划线，如USERNAME_INPUT