feat: 重构测试框架 — 覆盖 6 端 (管理端 + 小程序 + 4 个移动端)
目录结构: tests/web/admin/ 管理端 (Playwright) tests/web/mini_program/ 司机端小程序 (Playwright/微信 WebView) tests/app/driver_android/ 司机安卓 (Appium) tests/app/shipper_android/ 货主安卓 (Appium) tests/app/driver_ios/ 司机苹果 (Appium) tests/app/shipper_ios/ 货主苹果 (Appium) 公共模块: tests/app/_shared.py driver+ensure_logged_in 工厂 tests/app/_base_page.py App Page Object 基类 配置: test_config.yaml 拆分为 6 个独立 section + 货主账号
This commit is contained in:
xst
@@ -1,19 +1,9 @@
|
||||
"""App Page Object 基类 — 封装移动端页面共享的通用操作。
|
||||
|
||||
每个 App 页面应继承 AppBasePage，在 __init__ 中声明所有定位器。
|
||||
|
||||
Usage:
|
||||
class DriverHomePage(AppBasePage):
|
||||
def __init__(self, driver, platform):
|
||||
super().__init__(driver, platform)
|
||||
self.order_tab = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "tab_orders")
|
||||
"""
|
||||
"""通用 App Page Object 基类。"""
|
||||
|
||||
from datetime import datetime
|
||||
from pathlib import Path
|
||||
|
||||
from appium.webdriver.common.appiumby import AppiumBy
|
||||
from appium.webdriver.webdriver import WebDriver
|
||||
from selenium.webdriver.support.ui import WebDriverWait
|
||||
from selenium.webdriver.support import expected_conditions as EC
|
||||
|
||||
@@ -21,42 +11,33 @@ SCREENSHOTS_DIR = Path("output/screenshots")
|
||||
|
||||
|
||||
class AppBasePage:
|
||||
"""App Page Object 基类。"""
|
||||
"""App Page Object 基类 — 各端通用。"""
|
||||
|
||||
def __init__(self, driver: WebDriver, platform: str, timeout_ms: int = 30_000):
|
||||
def __init__(self, driver, platform: str, timeout_ms: int = 30_000):
|
||||
self.driver = driver
|
||||
self.platform = platform # "android" | "ios"
|
||||
self.timeout = timeout_ms / 1000 # WebDriverWait 使用秒
|
||||
|
||||
# ── 通用等待 ──
|
||||
self.platform = platform # "android" | "ios"
|
||||
self.timeout = timeout_ms / 1000
|
||||
|
||||
def wait_visible_by_id(self, accessibility_id: str, timeout_s: float | None = None) -> None:
|
||||
"""等待 accessibility_id 对应的元素可见。"""
|
||||
wait = WebDriverWait(self.driver, timeout=timeout_s or self.timeout)
|
||||
wait.until(
|
||||
EC.visibility_of_element_located((AppiumBy.ACCESSIBILITY_ID, accessibility_id))
|
||||
)
|
||||
|
||||
def wait_visible_by_text(self, text: str, timeout_s: float | None = None) -> None:
|
||||
"""等待页面上出现指定文本。"""
|
||||
wait = WebDriverWait(self.driver, timeout=timeout_s or self.timeout)
|
||||
|
||||
locator = (
|
||||
AppiumBy.XPATH, f"//*[@text='{text}']"
|
||||
(AppiumBy.XPATH, f"//*[@text='{text}']")
|
||||
if self.platform == "android"
|
||||
else (AppiumBy.XPATH, f"//*[@label='{text}']")
|
||||
)
|
||||
wait.until(EC.visibility_of_element_located(locator))
|
||||
|
||||
# ── 通用操作 ──
|
||||
|
||||
def tap_by_id(self, accessibility_id: str) -> None:
|
||||
"""按 accessibility_id 点击元素（推荐优先使用）。"""
|
||||
self.wait_visible_by_id(accessibility_id)
|
||||
self.driver.find_element(AppiumBy.ACCESSIBILITY_ID, accessibility_id).click()
|
||||
|
||||
def tap_by_text(self, text: str) -> None:
|
||||
"""按文本点击元素。"""
|
||||
strategy = AppiumBy.XPATH
|
||||
locator = (
|
||||
f"//*[@text='{text}']"
|
||||
@@ -68,14 +49,12 @@ class AppBasePage:
|
||||
self.driver.find_element(strategy, locator).click()
|
||||
|
||||
def fill_by_id(self, accessibility_id: str, value: str) -> None:
|
||||
"""按 accessibility_id 找到输入框并填入内容。"""
|
||||
self.wait_visible_by_id(accessibility_id)
|
||||
element = self.driver.find_element(AppiumBy.ACCESSIBILITY_ID, accessibility_id)
|
||||
element.clear()
|
||||
element.send_keys(value)
|
||||
|
||||
def scroll_down(self) -> None:
|
||||
"""向下滑动（从屏幕 70% 滑到 30%）。"""
|
||||
size = self.driver.get_window_size()
|
||||
self.driver.swipe(
|
||||
start_x=size["width"] // 2,
|
||||
@@ -85,10 +64,7 @@ class AppBasePage:
|
||||
duration=500,
|
||||
)
|
||||
|
||||
# ── 截图 ──
|
||||
|
||||
def screenshot(self, name: str) -> str:
|
||||
"""关键节点截图，返回文件路径。"""
|
||||
scenario_dir = SCREENSHOTS_DIR / self.__class__.__name__
|
||||
scenario_dir.mkdir(parents=True, exist_ok=True)
|
||||
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
|
||||
@@ -0,0 +1,125 @@
|
||||
"""App 端公共模块 — driver 创建 + ensure_logged_in 工厂。
|
||||
|
||||
所有 App 端 conftest 调用 share_* 函数即可，避免重复代码。
|
||||
"""
|
||||
|
||||
from datetime import datetime
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
SCREENSHOTS_DIR = Path("output/screenshots")
|
||||
|
||||
|
||||
def create_driver(section_config: dict, platform: str):
|
||||
"""创建 Appium driver。
|
||||
|
||||
Args:
|
||||
section_config: 配置中对应端的 section（如 config["driver_android"]）
|
||||
platform: "android" | "ios"
|
||||
"""
|
||||
try:
|
||||
from appium import webdriver
|
||||
from appium.options.android import UiAutomator2Options
|
||||
from appium.options.ios import XCUITestOptions
|
||||
except ImportError:
|
||||
pytest.skip("Appium-Python-Client 未安装，跳过 App 测试。")
|
||||
|
||||
appium_host = section_config.get("appium_host", "http://localhost:4723")
|
||||
|
||||
if platform == "android":
|
||||
options = UiAutomator2Options()
|
||||
options.device_name = section_config["device_name"]
|
||||
options.app_package = section_config["app_package"]
|
||||
options.app_activity = section_config["app_activity"]
|
||||
options.no_reset = section_config.get("no_reset", True)
|
||||
options.new_command_timeout = section_config.get("new_command_timeout", 120)
|
||||
options.automation_name = "UiAutomator2"
|
||||
else:
|
||||
options = XCUITestOptions()
|
||||
options.device_name = section_config["device_name"]
|
||||
options.bundle_id = section_config["bundle_id"]
|
||||
options.no_reset = section_config.get("no_reset", True)
|
||||
options.new_command_timeout = section_config.get("new_command_timeout", 120)
|
||||
options.automation_name = "XCUITest"
|
||||
|
||||
return webdriver.Remote(appium_host, options=options)
|
||||
|
||||
|
||||
def make_ensure_logged_in(
|
||||
section_config: dict,
|
||||
config: dict,
|
||||
account_role: str,
|
||||
home_indicator: str = "tab_home",
|
||||
):
|
||||
"""创建一个 ensure_logged_in 闭包。
|
||||
|
||||
Args:
|
||||
section_config: App 端配置
|
||||
config: 全局配置
|
||||
account_role: 默认账号角色名（如 "driver"、"shipper"）
|
||||
home_indicator: 首页元素的 accessibility_id
|
||||
"""
|
||||
from selenium.webdriver.support.ui import WebDriverWait
|
||||
from selenium.webdriver.support import expected_conditions as EC
|
||||
from appium.webdriver.common.appiumby import AppiumBy
|
||||
|
||||
def _ensure_logged_in(driver, timeout_s: float = 10.0) -> None:
|
||||
skip_login = section_config.get("skip_login", True)
|
||||
wait = WebDriverWait(driver, timeout=timeout_s)
|
||||
|
||||
try:
|
||||
wait.until(
|
||||
EC.visibility_of_element_located((AppiumBy.ACCESSIBILITY_ID, home_indicator))
|
||||
)
|
||||
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如需自动化登录，请设置 skip_login: false。"
|
||||
)
|
||||
account = config["accounts"].get(account_role, {})
|
||||
login_input.send_keys(account.get("phone", ""))
|
||||
driver.find_element(
|
||||
AppiumBy.ACCESSIBILITY_ID, "login_password_input"
|
||||
).send_keys(account.get("password", ""))
|
||||
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "login_submit_btn").click()
|
||||
wait.until(
|
||||
EC.visibility_of_element_located((AppiumBy.ACCESSIBILITY_ID, home_indicator))
|
||||
)
|
||||
return
|
||||
except RuntimeError:
|
||||
raise
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
raise RuntimeError("无法确定 APP 的登录状态！请确保 APP 已启动且首页或登录页可见。")
|
||||
|
||||
return _ensure_logged_in
|
||||
|
||||
|
||||
def save_failure_screenshot(driver, section_config, platform, request):
|
||||
"""失败自动截图（各端 conftest teardown 中调用）。"""
|
||||
if (
|
||||
section_config.get("screenshot_on_failure", True)
|
||||
and hasattr(request.node, "rep_call")
|
||||
and request.node.rep_call.failed
|
||||
):
|
||||
scenario_dir = SCREENSHOTS_DIR / request.node.name
|
||||
scenario_dir.mkdir(parents=True, exist_ok=True)
|
||||
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
|
||||
path = str(scenario_dir / f"FAIL_{platform}_{ts}.png")
|
||||
driver.save_screenshot(path)
|
||||
|
||||
|
||||
@pytest.hookimpl(tryfirst=True, hookwrapper=True)
|
||||
def pytest_runtest_makereport(item, call):
|
||||
outcome = yield
|
||||
rep = outcome.get_result()
|
||||
setattr(item, f"rep_{rep.when}", rep)
|
||||
@@ -1,198 +0,0 @@
|
||||
"""
|
||||
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 — 当前平台
|
||||
"""
|
||||
|
||||
from datetime import datetime
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
SCREENSHOTS_DIR = Path("output/screenshots")
|
||||
|
||||
|
||||
@pytest.fixture(scope="session")
|
||||
def app_config(config):
|
||||
"""session 级：App 配置段。"""
|
||||
return config["app"]
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def platform(app_config) -> str:
|
||||
"""当前执行的平台。"""
|
||||
return app_config.get("platforms", ["android"])[0]
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def driver(app_config, platform, request):
|
||||
"""每个用例独立的 Appium driver，失败自动截图。
|
||||
|
||||
前提: Appium Server 已启动（appium --log-level info）。
|
||||
noReset=true → app 不重置 → 登录态持久保留。
|
||||
"""
|
||||
try:
|
||||
from appium import webdriver
|
||||
from appium.options.android import UiAutomator2Options
|
||||
from appium.options.ios import XCUITestOptions
|
||||
except ImportError:
|
||||
pytest.skip("Appium-Python-Client 未安装，跳过 App 测试。")
|
||||
|
||||
appium_host = app_config.get("appium_host", "http://localhost:4723")
|
||||
screenshot_on_failure = app_config.get("screenshot_on_failure", True)
|
||||
|
||||
driver = None
|
||||
try:
|
||||
if platform == "android":
|
||||
android_cfg = app_config["android"]
|
||||
options = UiAutomator2Options()
|
||||
options.device_name = android_cfg["device_name"]
|
||||
options.app_package = android_cfg["app_package"]
|
||||
options.app_activity = android_cfg["app_activity"]
|
||||
options.no_reset = android_cfg.get("no_reset", True)
|
||||
options.new_command_timeout = android_cfg.get("new_command_timeout", 120)
|
||||
options.automation_name = "UiAutomator2"
|
||||
else:
|
||||
ios_cfg = app_config["ios"]
|
||||
options = XCUITestOptions()
|
||||
options.device_name = ios_cfg["device_name"]
|
||||
options.bundle_id = ios_cfg["bundle_id"]
|
||||
options.no_reset = ios_cfg.get("no_reset", True)
|
||||
options.new_command_timeout = ios_cfg.get("new_command_timeout", 120)
|
||||
options.automation_name = "XCUITest"
|
||||
|
||||
driver = webdriver.Remote(appium_host, options=options)
|
||||
|
||||
yield driver
|
||||
|
||||
# ── 失败自动截图 ──
|
||||
if (
|
||||
screenshot_on_failure
|
||||
and hasattr(request.node, "rep_call")
|
||||
and request.node.rep_call.failed
|
||||
and driver is not None
|
||||
):
|
||||
scenario_dir = SCREENSHOTS_DIR / request.node.name
|
||||
scenario_dir.mkdir(parents=True, exist_ok=True)
|
||||
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
|
||||
path = str(scenario_dir / f"FAIL_{platform}_{ts}.png")
|
||||
driver.save_screenshot(path)
|
||||
|
||||
finally:
|
||||
if driver is not None:
|
||||
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):
|
||||
"""记录用例执行结果，供失败截图使用。"""
|
||||
outcome = yield
|
||||
rep = outcome.get_result()
|
||||
setattr(item, f"rep_{rep.when}", rep)
|
||||
@@ -0,0 +1,27 @@
|
||||
"""司机安卓端 fixture — Appium + 登录态复用。"""
|
||||
|
||||
import pytest
|
||||
from tests.app._shared import create_driver, make_ensure_logged_in, save_failure_screenshot
|
||||
|
||||
from tests.app._shared import pytest_runtest_makereport # noqa: F401 — report hook
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def driver(driver_android_config, request):
|
||||
"""司机安卓端 driver (noReset=true)。"""
|
||||
cfg = driver_android_config
|
||||
d = None
|
||||
try:
|
||||
d = create_driver(cfg, platform="android")
|
||||
yield d
|
||||
save_failure_screenshot(d, cfg, "android", request)
|
||||
finally:
|
||||
if d is not None:
|
||||
d.quit()
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def ensure_logged_in(driver_android_config, config):
|
||||
"""确保已登录态（司机角色）。"""
|
||||
fn = make_ensure_logged_in(driver_android_config, config, account_role="driver")
|
||||
return lambda d: fn(d)
|
||||
@@ -0,0 +1,26 @@
|
||||
"""司机安卓端 Page Object — 首页。"""
|
||||
|
||||
from tests.app._base_page import AppBasePage
|
||||
|
||||
|
||||
class DriverHomePage(AppBasePage):
|
||||
"""司机端 APP 首页。"""
|
||||
|
||||
def __init__(self, driver, platform: str = "android"):
|
||||
super().__init__(driver, platform)
|
||||
self.order_tab = "tab_orders"
|
||||
self.mine_tab = "tab_mine"
|
||||
self.home_tab = "tab_home"
|
||||
|
||||
def is_displayed(self) -> bool:
|
||||
try:
|
||||
self.wait_visible_by_id(self.home_tab, timeout_s=10)
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
def go_to_order_list(self) -> None:
|
||||
self.tap_by_id(self.order_tab)
|
||||
|
||||
def go_to_mine(self) -> None:
|
||||
self.tap_by_id(self.mine_tab)
|
||||
@@ -0,0 +1,18 @@
|
||||
"""司机安卓端 — 冒烟测试。"""
|
||||
|
||||
import pytest
|
||||
|
||||
pytestmark = [pytest.mark.driver_android]
|
||||
|
||||
|
||||
class TestDriverAndroidSmoke:
|
||||
"""司机安卓端基础验证。"""
|
||||
|
||||
@pytest.mark.p0
|
||||
@pytest.mark.smoke
|
||||
def test_home_page_loaded(self, driver, ensure_logged_in):
|
||||
"""验证登录态有效，首页正常。"""
|
||||
ensure_logged_in(driver)
|
||||
from appium.webdriver.common.appiumby import AppiumBy
|
||||
home = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "tab_home")
|
||||
assert home.is_displayed(), "首页 tab 应可见"
|
||||
@@ -0,0 +1,27 @@
|
||||
"""司机苹果端 fixture — Appium + 登录态复用。"""
|
||||
|
||||
import pytest
|
||||
from tests.app._shared import create_driver, make_ensure_logged_in, save_failure_screenshot
|
||||
|
||||
from tests.app._shared import pytest_runtest_makereport # noqa: F401
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def driver(driver_ios_config, request):
|
||||
"""司机苹果端 driver。"""
|
||||
cfg = driver_ios_config
|
||||
d = None
|
||||
try:
|
||||
d = create_driver(cfg, platform="ios")
|
||||
yield d
|
||||
save_failure_screenshot(d, cfg, "ios", request)
|
||||
finally:
|
||||
if d is not None:
|
||||
d.quit()
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def ensure_logged_in(driver_ios_config, config):
|
||||
"""确保已登录态（司机角色）。"""
|
||||
fn = make_ensure_logged_in(driver_ios_config, config, account_role="driver")
|
||||
return lambda d: fn(d)
|
||||
@@ -0,0 +1,18 @@
|
||||
"""司机苹果端 — 冒烟测试。"""
|
||||
|
||||
import pytest
|
||||
|
||||
pytestmark = [pytest.mark.driver_ios]
|
||||
|
||||
|
||||
class TestDriverIosSmoke:
|
||||
"""司机苹果端基础验证。"""
|
||||
|
||||
@pytest.mark.p0
|
||||
@pytest.mark.smoke
|
||||
def test_home_page_loaded(self, driver, ensure_logged_in):
|
||||
"""验证登录态有效，首页正常。"""
|
||||
ensure_logged_in(driver)
|
||||
from appium.webdriver.common.appiumby import AppiumBy
|
||||
home = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "tab_home")
|
||||
assert home.is_displayed(), "首页 tab 应可见"
|
||||
@@ -1,47 +0,0 @@
|
||||
"""司机端首页 — Page Object（App 端）。
|
||||
|
||||
Usage:
|
||||
from tests.app.pages.driver_home_page import DriverHomePage
|
||||
|
||||
home = DriverHomePage(driver, platform="android")
|
||||
home.go_to_order_list()
|
||||
"""
|
||||
|
||||
from appium.webdriver.webdriver import WebDriver
|
||||
|
||||
from tests.app.pages.base_page import AppBasePage
|
||||
|
||||
|
||||
class DriverHomePage(AppBasePage):
|
||||
"""运八司机端 APP 首页。"""
|
||||
|
||||
def __init__(self, driver: WebDriver, platform: str = "android"):
|
||||
super().__init__(driver, platform)
|
||||
# ⚠️ 以下 accessibility_id 需要根据实际 APP UI 确认
|
||||
self.order_tab = "tab_orders" # 运单 tab
|
||||
self.mine_tab = "tab_mine" # 我的 tab
|
||||
self.home_tab = "tab_home" # 首页 tab
|
||||
self.notification_badge = "badge_notification"
|
||||
|
||||
def is_displayed(self) -> bool:
|
||||
"""检查首页是否已展示。"""
|
||||
try:
|
||||
self.wait_visible_by_id(self.home_tab, timeout_s=10)
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
def go_to_order_list(self) -> None:
|
||||
"""点击进入运单列表。"""
|
||||
self.tap_by_id(self.order_tab)
|
||||
|
||||
def go_to_mine(self) -> None:
|
||||
"""点击进入「我的」页面。"""
|
||||
self.tap_by_id(self.mine_tab)
|
||||
|
||||
def get_notification_count(self) -> str:
|
||||
"""获取通知角标数量。"""
|
||||
element = self.driver.find_element(
|
||||
self.driver.find_element.ACCESSIBILITY_ID, self.notification_badge
|
||||
)
|
||||
return element.text if element else "0"
|
||||
@@ -0,0 +1,27 @@
|
||||
"""货主安卓端 fixture — Appium + 登录态复用。"""
|
||||
|
||||
import pytest
|
||||
from tests.app._shared import create_driver, make_ensure_logged_in, save_failure_screenshot
|
||||
|
||||
from tests.app._shared import pytest_runtest_makereport # noqa: F401
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def driver(shipper_android_config, request):
|
||||
"""货主安卓端 driver。"""
|
||||
cfg = shipper_android_config
|
||||
d = None
|
||||
try:
|
||||
d = create_driver(cfg, platform="android")
|
||||
yield d
|
||||
save_failure_screenshot(d, cfg, "android", request)
|
||||
finally:
|
||||
if d is not None:
|
||||
d.quit()
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def ensure_logged_in(shipper_android_config, config):
|
||||
"""确保已登录态（货主角色）。"""
|
||||
fn = make_ensure_logged_in(shipper_android_config, config, account_role="shipper")
|
||||
return lambda d: fn(d)
|
||||
@@ -0,0 +1,18 @@
|
||||
"""货主安卓端 — 冒烟测试。"""
|
||||
|
||||
import pytest
|
||||
|
||||
pytestmark = [pytest.mark.shipper_android]
|
||||
|
||||
|
||||
class TestShipperAndroidSmoke:
|
||||
"""货主安卓端基础验证。"""
|
||||
|
||||
@pytest.mark.p0
|
||||
@pytest.mark.smoke
|
||||
def test_home_page_loaded(self, driver, ensure_logged_in):
|
||||
"""验证登录态有效，首页正常。"""
|
||||
ensure_logged_in(driver)
|
||||
from appium.webdriver.common.appiumby import AppiumBy
|
||||
home = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "tab_home")
|
||||
assert home.is_displayed(), "首页 tab 应可见"
|
||||
@@ -0,0 +1,27 @@
|
||||
"""货主苹果端 fixture — Appium + 登录态复用。"""
|
||||
|
||||
import pytest
|
||||
from tests.app._shared import create_driver, make_ensure_logged_in, save_failure_screenshot
|
||||
|
||||
from tests.app._shared import pytest_runtest_makereport # noqa: F401
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def driver(shipper_ios_config, request):
|
||||
"""货主苹果端 driver。"""
|
||||
cfg = shipper_ios_config
|
||||
d = None
|
||||
try:
|
||||
d = create_driver(cfg, platform="ios")
|
||||
yield d
|
||||
save_failure_screenshot(d, cfg, "ios", request)
|
||||
finally:
|
||||
if d is not None:
|
||||
d.quit()
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def ensure_logged_in(shipper_ios_config, config):
|
||||
"""确保已登录态（货主角色）。"""
|
||||
fn = make_ensure_logged_in(shipper_ios_config, config, account_role="shipper")
|
||||
return lambda d: fn(d)
|
||||
@@ -0,0 +1,18 @@
|
||||
"""货主苹果端 — 冒烟测试。"""
|
||||
|
||||
import pytest
|
||||
|
||||
pytestmark = [pytest.mark.shipper_ios]
|
||||
|
||||
|
||||
class TestShipperIosSmoke:
|
||||
"""货主苹果端基础验证。"""
|
||||
|
||||
@pytest.mark.p0
|
||||
@pytest.mark.smoke
|
||||
def test_home_page_loaded(self, driver, ensure_logged_in):
|
||||
"""验证登录态有效，首页正常。"""
|
||||
ensure_logged_in(driver)
|
||||
from appium.webdriver.common.appiumby import AppiumBy
|
||||
home = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "tab_home")
|
||||
assert home.is_displayed(), "首页 tab 应可见"
|
||||
@@ -1,108 +0,0 @@
|
||||
"""App 登录功能测试用例。
|
||||
|
||||
覆盖:
|
||||
- (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 用例
|
||||
pytest -m p0 # 仅执行 P0 冒烟
|
||||
pytest -m smoke # 仅执行冒烟
|
||||
"""
|
||||
|
||||
import pytest
|
||||
from appium.webdriver.common.appiumby import AppiumBy
|
||||
|
||||
pytestmark = [pytest.mark.app]
|
||||
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════════
|
||||
# P0 — 冒烟测试（依赖手动登录后的持久化登录态）
|
||||
# ═══════════════════════════════════════════════════════════════════
|
||||
|
||||
class TestAppSmoke:
|
||||
"""验证 App 登录态有效，核心页面可正常访问。"""
|
||||
|
||||
@pytest.mark.p0
|
||||
@pytest.mark.smoke
|
||||
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
|
||||
|
||||
ensure_logged_in()
|
||||
home = DriverHomePage(driver, platform=platform)
|
||||
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 — 登录页验证（仅在 skip_login: false 时有意义）
|
||||
# ═══════════════════════════════════════════════════════════════════
|
||||
|
||||
class TestAppLoginPage:
|
||||
"""登录页基础验证。"""
|
||||
|
||||
@pytest.mark.p1
|
||||
def test_login_page_elements(self, driver, platform, app_config):
|
||||
"""验证登录页元素存在（不执行登录）。"""
|
||||
# ⚠️ 前提: app 当前在登录页（未登录状态）
|
||||
# 如果已登录，此用例可能找不到登录页元素
|
||||
from tests.app.conftest import is_logged_in
|
||||
|
||||
# 如果已登录，跳过此用例
|
||||
try:
|
||||
if is_logged_in:
|
||||
pytest.skip("APP 已登录，无法验证登录页元素")
|
||||
except Exception:
|
||||
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 已变更")
|
||||
Reference in New Issue
Block a user