基于 Python 的 Web 与 App 端自动化测试实践

3. 控制 App 的 Driver scope="class"，Appium 控制设备在第一次调用 driver 的 class 中是连续的，执行完第一个测试用例后在执行第二个之前不会重启 App。

@pytest.fixture(scope='class')
def create_driver():
    desired_cap = {
        "platformName": "Android",
        "platformVersion": "6",  # 建议移除，除非必要，Appium 会自动检测
        "deviceName": "设备名称",  # 可改为通用名称
        "udid": "udid",          # 关键：使用 udid 指定你的设备
        "appPackage": "app 名",
        "appActivity": "初始化界面 app 活动名",
        "automationName": "UiAutomator2",
        "noReset": True,
        "newCommandTimeout": 900,
        "autoGrantPermissions": True,
        "unicodeKeyboard": True,
        "resetKeyboard": True
    }
    options = AppiumOptions()
    options.load_capabilities(desired_cap)
    driver = None
    try:
        driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", options=options)
        driver.implicitly_wait(30)
        print("驱动初始化成功，设备已连接")
        yield driver  # 将 driver 提供给外部使用
    finally:
        if driver:
            driver.quit()
            print("驱动已关闭")

4. 日志生成器 调用 logging 模块后声明日志工具。

@pytest.fixture(scope="session")
def logger():
    logger = logging.getLogger("日志")
    logger.setLevel("DEBUG")
    log_dir = "./log"
    if not os.path.exists(log_dir):
        os.makedirs(log_dir)
    log_file = os.path.join(log_dir, 'log.txt')
    log_handler = logging.handlers.RotatingFileHandler(log_file, mode='w', encoding='utf-8')
    log_format = "%(asctime)s-%(levelname)s-%(process)d-%(message)s"
    fmt = logging.Formatter(fmt=log_format)
    log_handler.setFormatter(fmt)
    logger.addHandler(log_handler)
    yield logger
    print("销毁日志记录器")

有了这个日志工具后，在测试用例文件中要打印什么直接 logger.info("") 或者 logger.error("")。

三、PO 模式具体使用

在 pages 软件包中添加 py 文件 login.py。

from playwright.sync_api import Page

class PatientScreen:
    def __init__(self, page: Page):
        self.page = page

    def navigate(self):
        self.page.get_by_text()
        self.page.get_by_role()
        # ... 其他操作

类 PatientScreen 是封装的一个页面，__init__ 方法中声明此类的属性 page。

关于这个页面下的操作如何写，推荐使用 Playwright 自带的 codegen 录制工具，能自动生成操作相应的代码。

playwright codegen "http://..."

在测试文件 py 中如何调用呢？

class TestPatientScreen:
    def test_template_color(self, page, create_driver, logger):
        logger.info("case1: 测试一览表背景颜色切换")
        login_page = WebLogin(page)
        patientscreen_page = PatientScreen(page)

声明测试类后，在测试函数中可以直接调用在 common 中声明的生成器 page，然后声明一个 PO 模式中类的对象作为我们要操作的对象。例如 login_page 是登录界面的可以执行类中动作的对象。

四、Appium 定位元素的新方法总结

1. 跨端图片比对 遇到一个在 Web 端上传图片后验证 App 端是否正确上传了的测试点。先获取设备上的图片：

logo = create_driver.find_element(By.XPATH, '/hierarchy/android.widget.FrameLayout/android.widget.LinearLayout/android.widget.FrameLayout/android.widget.LinearLayout/android.widget.FrameLayout/android.widget.FrameLayout/android.widget.FrameLayout/android.widget.RelativeLayout/android.widget.FrameLayout[1]/android.widget.LinearLayout/android.widget.ImageView')
screenshot_bytes = logo.screenshot_as_png
with open(device_logo_path, "wb") as f:
    f.write(screenshot_bytes)

然后再把原图保存在工程的一个位置（建议保存在 setting 下面），比较图片是否是同一张的方法：计算汉明距离。

from PIL import Image
import imagehash

def hash_compare(img1_path, img2_path, threshold=16):
    hash1 = imagehash.phash(Image.open(img1_path))
    hash2 = imagehash.phash(Image.open(img2_path))
    hamming_distance = int(hash1) - int(hash2)
    is_similar = hamming_distance <= threshold
    if is_similar:
        print("同一张图片")
    else:
        print("不是同一张")

threshold 是比较的严格程度，越小越严格，最大 64。根据经验，两张完全不同的图片选择 64 会被判断为一样，取 16 可以分辨不同的图片，所以最终选了 16。

2. 坐标滑动 Web 端开启手动滑动功能，远程工具连接设备，鼠标确实能拖动小窗口上下滑动，但是通过 Appium 定位不到这个可滑动的元素。于是采用坐标滑动的方法。

def swipe_up(driver, start_x_percent=0.2, start_y_percent=0.8, end_y_percent=0.2):
    width = driver.get_window_size()['width']
    height = driver.get_window_size()['height']
    actions = ActionChains(driver)
    actions.w3c_actions = ActionBuilder(driver, mouse=PointerInput(interaction.POINTER_TOUCH, "TOUCH"))
    actions.w3c_actions.pointer_action.move_to_location(start_x_percent * width, start_y_percent * height)
    actions.w3c_actions.pointer_action.pointer_down()
    actions.w3c_actions.pointer_action.move_to_location(start_x_percent * width, end_y_percent * height)
    actions.w3c_actions.pointer_action.pointer_up()
    actions.perform()

注：之前的 swipe 方法简单又快捷，但现在好像只支持 ActionChains 这种方法。