xst/Yb-QaAutomationHub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 框架增加登录态复用机制，绕过图形验证码

Browse Source 
Web 端 (storage_state):
- 新增 tests/web/save_auth.py: 手动登录后保存 cookies+localStorage
- conftest.py: skip_login:true 时自动加载 storage_state，跳过 UI 登录
- ensure_login fixture: 登录态有效则直接通过，过期则给出明确指引

App 端 (noReset):
- conftest.py: ensure_logged_in fixture，手动登录后无需重新登录
- noReset=true 持久化登录态，未登录自动检测并给出明确引导

配置文件:
- web.skip_login: true + storage_state_dir
- app.skip_login: true + 手动登录说明
This commit is contained in:
xst
2026-07-15 10:47:34 +08:00
parent aade9e39d0
commit 7b4a54f1ce
6 changed files with 518 additions and 161 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tests/app/conftest.py
+110 -10
View File
@@ -1,14 +1,23 @@
"""
App 端根级 fixture：Appium Driver 实例 + 失败自动截图。
App 端根级 fixture：Appium Driver 实例 + 登录态复用 + 失败自动截图。
核心机制 — 手动登录后复用:
Appium noReset=true 确保 app 数据不重置，登录态持久保留在设备上。
只需手动在设备上登录一次，后续用例通过 ensure_logged_in 检查首页是否已登录态。
如果检测到未登录（在登录页），给出明确指引让用户先去设备上手动登录。
配置 app.skip_login: true 时:
- 用例通过 ensure_logged_in() 检查是否已登录
- 未登录则抛出明确错误，引导用户先去设备上手动登录
- 已登录则直接开始执行
配置 app.skip_login: false 时:
- 每次用例尝试完整 UI 登录（有验证码时会失败）
提供:
app_config — session 级 App 配置
driver — Appium WebDriver（每个用例独立）
platform — 当前平台 android / ios
Usage:
def test_app_login(driver, platform):
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_btn").click()
app_config — session 级 App 配置
driver — Appium WebDriver（每个用例独立，失败自动截图）
platform — 当前平台
"""
from datetime import datetime
@@ -27,7 +36,7 @@ def app_config(config):
@pytest.fixture
def platform(app_config) -> str:
"""当前执行的平台（默认 android，后续可参数化）。"""
"""当前执行的平台。"""
return app_config.get("platforms", ["android"])[0]
@@ -35,7 +44,8 @@ def platform(app_config) -> str:
def driver(app_config, platform, request):
"""每个用例独立的 Appium driver，失败自动截图。
注意：运行前需确保 Appium Server 已启动（appium --log-level info）。
前提: Appium Server 已启动（appium --log-level info）。
noReset=true → app 不重置 → 登录态持久保留。
"""
try:
from appium import webdriver
@@ -89,6 +99,96 @@ def driver(app_config, platform, request):
driver.quit()
@pytest.fixture
def ensure_logged_in(driver, platform, app_config, config):
"""确保 APP 已处于登录状态。
使用方式:
def test_xxx(driver, ensure_logged_in):
ensure_logged_in() # 检查登录态，未登录则报错
# 后面直接写业务断言
"""
def _ensure_logged_in(timeout_s: float = 10.0) -> None:
skip_login = app_config.get("skip_login", True)
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from appium.webdriver.common.appiumby import AppiumBy
# ⚠️ home_tab 的 accessibility_id 需根据实际 APP UI 确认
HOME_INDICATOR_ID = "tab_home" # 首页 tab 的 accessibility_id
wait = WebDriverWait(driver, timeout=timeout_s)
try:
wait.until(
EC.visibility_of_element_located((AppiumBy.ACCESSIBILITY_ID, HOME_INDICATOR_ID))
)
# 已登录，无需操作
return
except Exception:
pass
# ── 未检测到首页元素，判断是否在登录页 ──
try:
# 尝试找登录页元素
login_input = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_phone_input")
if login_input.is_displayed():
if skip_login:
raise RuntimeError(
"APP 当前在登录页，未检测到登录态！\n"
"请在设备上手动完成一次登录（包含验证码），之后重新运行用例即可。\n"
"如需通过自动化登录，请设置 app.skip_login: false（不推荐，有验证码）。"
)
# skip_login: false — 走自动化登录
account = config["accounts"].get("driver")
if not account:
raise RuntimeError("配置中未找到 driver 账号")
login_input.send_keys(account["phone"])
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_password_input").send_keys(
account["password"]
)
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_submit_btn").click()
# 等待登录完成
wait.until(
EC.visibility_of_element_located(
(AppiumBy.ACCESSIBILITY_ID, HOME_INDICATOR_ID)
)
)
return
except RuntimeError:
raise # 重新抛出明确的错误提示
except Exception:
pass
raise RuntimeError(
f"无法确定 APP 的登录状态！请确保 APP 已启动且首页或登录页可见。\n"
f"当前平台: {platform}"
)
return _ensure_logged_in
@pytest.fixture
def is_logged_in(driver, platform, app_config) -> bool:
"""快速检查当前是否已登录（不执行登录操作）。"""
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from appium.webdriver.common.appiumby import AppiumBy
try:
wait = WebDriverWait(driver, timeout=5)
wait.until(
EC.visibility_of_element_located((AppiumBy.ACCESSIBILITY_ID, "tab_home"))
)
return True
except Exception:
return False
# ── pytest 报告 hook ──
@pytest.hookimpl(tryfirst=True, hookwrapper=True)
def pytest_runtest_makereport(item, call):
tests/app/test_login/test_login.py
+73 -48
View File
@@ -1,7 +1,14 @@
"""App 登录功能测试用例。
覆盖正常登录、异常登录。
按 ui_automation_best_practices.md §6.4 的范本结构编写。
覆盖:
- (skip_login: true) 验证预登录态有效，用例直接复用已登录状态
- (skip_login: false) 完整 UI 登录流程
前置条件:
1. Appium Server 已启动: appium --log-level info
2. (推荐) 已在设备上手动登录一次，后续用例自动跳过登录
3. app.skip_login: true（默认）→ 用例通过 ensure_logged_in 检查登录态
4. app.skip_login: false → 每次执行完整 UI 登录（有验证码会失败）
标记:
pytest -m app # 仅执行 App 用例
@@ -16,68 +23,86 @@ pytestmark = [pytest.mark.app]
# ═══════════════════════════════════════════════════════════════════
# P0 — 冒烟测试
# P0 — 冒烟测试（依赖手动登录后的持久化登录态）
# ═══════════════════════════════════════════════════════════════════
class TestAppLoginSuccess:
"""App 正常登录流程。"""
class TestAppSmoke:
"""验证 App 登录态有效，核心页面可正常访问。"""
@pytest.mark.p0
@pytest.mark.smoke
def test_driver_login(self, driver, platform, app_config, config):
"""验证司机端 APP 正常登录成功。"""
def test_already_logged_in(self, driver, platform, ensure_logged_in):
"""验证 APP 已处于登录状态（手动登录后 noReset 持久化）。"""
ensure_logged_in()
# 主页面 tab 应可见
home_tab = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "tab_home")
assert home_tab.is_displayed(), "登录后应展示首页 tab"
@pytest.mark.p0
@pytest.mark.smoke
def test_navigate_to_order_list(self, driver, platform, ensure_logged_in):
"""验证登录后可导航到运单列表。"""
from tests.app.pages.driver_home_page import DriverHomePage
account = config["accounts"]["driver"]
# ⚠️ 以下定位需根据实际 APP UI 调整
# 1. 输入手机号
phone_input = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_phone_input")
phone_input.send_keys(account["phone"])
# 2. 输入密码
password_input = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_password_input")
password_input.send_keys(account["password"])
# 3. 点击登录
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_submit_btn").click()
# 4. 验证首页展示
ensure_logged_in()
home = DriverHomePage(driver, platform=platform)
assert home.is_displayed(), "登录后应展示司机端首页"
home.go_to_order_list()
# 验证运单列表可见
# ⚠️ 定位需根据实际 APP UI 调整
order_list = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "order_list")
assert order_list.is_displayed(), "运单列表应可见"
@pytest.mark.p0
@pytest.mark.smoke
def test_tab_switching(self, driver, platform, ensure_logged_in):
"""验证底部 tab 可正常切换。"""
from tests.app.pages.driver_home_page import DriverHomePage
ensure_logged_in()
home = DriverHomePage(driver, platform=platform)
# 点击"我的"
home.go_to_mine()
# ⚠️ mine_page 的 accessibility_id 需根据实际 APP UI 确认
mine_view = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "mine_page")
assert mine_view.is_displayed(), "应展示「我的」页面"
# 切回首页
home.tap_by_id("tab_home")
assert home.is_displayed(), "应切回首页"
# ═══════════════════════════════════════════════════════════════════
# P1 — 异常与校验
# P1 — 登录页验证（仅在 skip_login: false 时有意义）
# ═══════════════════════════════════════════════════════════════════
class TestAppLoginValidation:
"""App 登录异常校验。"""
class TestAppLoginPage:
"""登录页基础验证。"""
@pytest.mark.p1
@pytest.mark.parametrize("phone,password,expected_toast", [
pytest.param("", "88888888", "请输入手机号", id="empty_phone"),
pytest.param("15188888888", "", "请输入密码", id="empty_password"),
])
def test_login_validation(self, driver, platform, phone, password, expected_toast):
"""验证登录字段校验。"""
if phone:
phone_input = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_phone_input")
phone_input.send_keys(phone)
if password:
password_input = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_password_input")
password_input.send_keys(password)
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_submit_btn").click()
# Toast 提示验证（⚠️ Toast 定位方式因设备/平台而异，可能需要调整）
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
def test_login_page_elements(self, driver, platform, app_config):
"""验证登录页元素存在（不执行登录）。"""
# ⚠️ 前提: app 当前在登录页（未登录状态）
# 如果已登录，此用例可能找不到登录页元素
from tests.app.conftest import is_logged_in
# 如果已登录，跳过此用例
try:
wait = WebDriverWait(driver, timeout=5)
toast_xpath = f"//*[contains(@text,'{expected_toast}')]"
wait.until(EC.visibility_of_element_located((AppiumBy.XPATH, toast_xpath)))
if is_logged_in:
pytest.skip("APP 已登录，无法验证登录页元素")
except Exception:
# Toast 可能已自动消失，这里不做硬断言，以实际调试为准
pass
# 验证登录页核心元素
try:
phone_input = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_phone_input")
assert phone_input.is_displayed(), "手机号输入框应可见"
password_input = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_password_input")
assert password_input.is_displayed(), "密码输入框应可见"
login_btn = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_submit_btn")
assert login_btn.is_displayed(), "登录按钮应可见"
except Exception:
pytest.skip("登录页元素未找到，APP 可能已登录或 UI 已变更")