用大模型实现APP自动化测试:Android,iOS,HarmonyOS一次搞定

# ========== 1. 安装Node.js ==========# 访问 https://nodejs.org/ 下载LTS版本# ========== 2. 安装Appium主程序 ==========npm install -g appium# ========== 3. 安装Appium Python客户端 ==========pip install Appium-Python-Client# ========== 4. 安装Android UiAutomator2驱动 ==========appium driver install uiautomator2# ========== 5. 安装HarmonyOS驱动 ==========appium driver install gestural# ========== 6. 启动Appium服务（默认监听4723端口） ==========appium --allow-cors

# 安装XCUITest驱动（覆盖iOS设备）appium driver install xcuitest

# 查看Android / HarmonyOS设备adb devices# 查看iOS模拟器列表xcrun simctl list devices

# SKILL.md — 跨平台移动端自动化代码生成专家name: app-automation-expertversion: "1.0"description: 跨平台移动端自动化测试代码生成专家，专注于 Android（Appium Python）、iOS（Appium XCUITest Python）、HarmonyOS（DevEco Testing ArkTS）三端自动化脚本生成与优化。## 角色定义你是一名资深移动端自动化测试工程师，精通 Android、iOS、HarmonyOS 三大平台的 UI 自动化框架，具备以下能力：- 熟练使用 Appium（Android/iOS）进行跨平台自动化测试- 熟练使用 DevEco Testing（HarmonyOS）进行 ArkTS 自动化测试- 深度理解 PageObject 设计模式与关键字驱动测试框架- 能够根据 UI 描述或截图生成稳定可靠的元素定位器- 能够处理复杂场景：多平台差异、弹窗、等待、异常恢复## 核心职责生成符合 spec.yaml 规范的 Android/iOS、HarmonyOS 自动化代码，确保：1. 代码可直接运行，无需额外修改2. 元素定位器优先使用稳定策略（id → accessibility_id → text → class）3. 每个操作步骤后必须有断言验证4. 三端代码风格统一，命名规范一致5. 包含完整的错误处理和日志输出## 三端统一规范要点### 命名格式| 类型 | Android/iOS | HarmonyOS ||------|-------------|-----------|| 测试用例 | test_业务动作_预期结果 | async test业务动作_预期结果() || 测试类 | Test{业务}Page | @Component struct {业务}Page || 元素定位器变量 | loc_{页面}_{元素} | loc_{页面}_{元素} |### 断言要求- 技术层断言：每个 UI 操作后必须验证元素存在或消失- 业务层断言：关键业务节点必须验证页面状态（如列表非空、搜索结果 > 0）- 格式统一：Android/iOS 使用 assertEqual / assertTrue，HarmonyOS 使用 expect()### 禁止事项- ❌ 禁止使用硬编码 sleep，必须使用显式等待（WebDriverWait / until）- ❌ 禁止使用绝对坐标点击，必须使用元素定位- ❌ 禁止在弹窗处理前不检查弹窗是否存在- ❌ 禁止生成没有断言的测试用例- ❌ 禁止使用 XPath 绝对路径，必须使用相对定位（id、text、class 组合）## 默认等待时间配置- 元素查找显式等待：10 秒- 页面加载等待：5 秒- 滑动操作后等待：1 秒- 弹窗检测最大重试：3 次（每次间隔 1 秒）---# 【关键提示】每次生成前必须完成以下检查清单1. [ ] 确认被测平台（Android / iOS / HarmonyOS）2. [ ] 确认操作序列完整（启动 → 操作 → 断言 → 退出）3. [ ] 检查每个操作步骤是否有对应断言4. [ ] 检查定位器是否遵循优先级规范5. [ ] 确认代码可以直接复制运行6. [ ] 确认截图保存路径规范且目录存在

# spec.yaml — 跨平台移动端自动化代码生成规范# 版本：1.0 | 适用平台：Android / iOS / HarmonyOSmetadata:  last_updated: "2025-01-15"  maintainer: QA Team  version: "1.0"# ==================== 命名规范 ====================naming_conventions:  android:    test_case: "test_{module}_{action}_{expected}"    test_class: "Test{Module}Page"    locator_variable: "loc_{page}_{element}"  ios:    test_case: "test_{module}_{action}_{expected}"    test_class: "Test{Module}Page"    locator_variable: "loc_{page}_{element}"  harmonyos:    test_function: "async test{Module}{Action}{Expected}()"    component_struct: "{Module}Page"    locator_variable: "loc{Page}{Element}"# ==================== 元素定位器优先级 ====================locator_priority:  levels:    - name: "优先级1：ID / Resource-ID（最稳定）"      android: "By.id, driver.find_element_by_id"      ios: "By.ACCESSIBILITY_ID（推荐）"      harmonyos: "driver.findComponent(By.id)"    - name: "优先级2：Accessibility ID"      android: "By.accessibility_id"      harmonyos: "By.accessibility"    - name: "优先级3：Text / Label 文本匹配"      android: "By.xpath with contains(@text, '...')"      ios: "By.name"      harmonyos: "By.text"    - name: "优先级4：Class + Index 组合"      android: "By.xpath with class + index"      ios: "By.class_name + index"      harmonyos: "By.type + index"    - name: "优先级5：坐标（最后手段）"      android: "TouchAction + tap(x, y)"      ios: "XCUIElement.coordinate(x: y:)"      harmonyos: "driver.tap([x, y])"# ==================== 断言规范 ====================assertion_rules:  technical:    - "元素出现：assertTrue(element.is_displayed())"    - "元素消失：assertFalse(exists)"    - "元素可点击：assertTrue(element.is_enabled())"  business:    - "搜索结果数 > 0：assertTrue(len(results) > 0)"    - "页面标题正确：assertEqual(driver.title, '期望标题')"    - "列表非空：assertTrue(len(list_items) > 0)"# ==================== 禁止事项 ====================forbidden_patterns:  - rule: "禁止硬编码 sleep"    correct: "WebDriverWait(driver, 10).until(EC.presence_of_element_located(...))"    wrong: "time.sleep(3)  # ❌ 禁止"  - rule: "禁止 XPath 绝对路径"    correct: "By.id('com.example:id/btn_confirm')"    wrong: "//android.widget.Button[3]/android.view.View[1]  # ❌ 禁止"# ==================== 等待配置 ====================wait_config:  explicit_wait: 10       # 元素查找显式等待（秒）  page_load_wait: 5       # 页面加载等待（秒）  swipe_wait: 1          # 滑动后稳定等待（秒）  popup_retry: 3          # 弹窗检测重试次数

"""douyin_android.py — 抖音APP自动化测试（Android）依赖：pip install Appium-Python-Client运行：python douyin_android.py"""import os, timefrom appium import webdriverfrom appium.options.android import UiAutomator2Optionsfrom appium.webdriver.common.appiumby import AppiumByfrom selenium.webdriver.support.ui import WebDriverWaitfrom selenium.webdriver.support import expected_conditions as ECDOUYIN_PACKAGE = "com.ss.android.ugc.aweme"DOUYIN_ACTIVITY = ".main.MainActivity"SCREENSHOT_DIR = "./screenshots/android"os.makedirs(SCREENSHOT_DIR, exist_ok=True)def get_driver():    caps = UiAutomator2Options()    caps.platform_name = "Android"    caps.device_name = "Android_Emulator"    caps.app_package = DOUYIN_PACKAGE    caps.app_activity = DOUYIN_ACTIVITY    caps.no_reset = False    caps.auto_grant_permissions = True    return webdriver.Remote("http://localhost:4723", options=caps)def dismiss_privacy_popup(driver):    """关闭隐私协议弹窗（首次启动必须处理）"""    try:        for text in ["同意", "确认", "好的", "允许"]:            btn = WebDriverWait(driver, 3).until(                EC.element_to_be_clickable(                    (AppiumBy.ANDROID_UIAUTOMATOR, f'textContains("{text}")')                )            )            btn.click()            time.sleep(1)            break    except Exception:        pass  # 无弹窗或已处理def swipe_up(driver, duration=800):    """向上滑动一页视频"""    size = driver.get_window_size()    x = size["width"] // 2    start_y = int(size["height"] * 0.75)    end_y = int(size["height"] * 0.25)    driver.swipe(start_x=x, start_y=start_y, end_x=x, end_y=end_y, duration=duration)    time.sleep(1.5)def click_search_icon(driver):    """点击搜索入口"""    try:        search_icon = WebDriverWait(driver, 10).until(            EC.element_to_be_clickable(                (AppiumBy.ID, f"{DOUYIN_PACKAGE}:id/search_icon")            )        )    except Exception:        search_icon = WebDriverWait(driver, 5).until(            EC.element_to_be_clickable(                (AppiumBy.ANDROID_UIAUTOMATOR, 'textContains("搜索")')            )        )    search_icon.click()    time.sleep(1)def search_and_capture(driver, keyword):    """输入关键词搜索并截图"""    search_input = WebDriverWait(driver, 10).until(        EC.presence_of_element_located(            (AppiumBy.ID, f"{DOUYIN_PACKAGE}:id/search_edit")        )    )    search_input.clear()    search_input.send_keys(keyword)    search_btn = WebDriverWait(driver, 5).until(        EC.element_to_be_clickable(            (AppiumBy.ANDROID_UIAUTOMATOR, 'text("搜索")')        )    )    search_btn.click()    time.sleep(3)    timestamp = time.strftime("%Y%m%d_%H%M%S")    screenshot_path = os.path.join(SCREENSHOT_DIR, f"search_result_{timestamp}.png")    driver.get_screenshot_as_file(screenshot_path)    print(f"截图已保存: {screenshot_path}")    return screenshot_pathdef test_douyin_full_flow():    driver = get_driver()    try:        dismiss_privacy_popup(driver)   # Step1: 关闭隐私弹窗        time.sleep(2)        swipe_up(driver)                 # Step2: 向上滑动        click_search_icon(driver)       # Step3: 点击搜索入口        time.sleep(2)        search_and_capture(driver, "APP自动化测试")  # Step4: 搜索        print("✅ Android端Douyin自动化流程执行完成")    finally:        driver.terminate_app(DOUYIN_PACKAGE)  # Step5: 退出APP        driver.quit()if __name__ == "__main__":    test_douyin_full_flow()

"""douyin_ios.py — 抖音APP自动化测试（iOS）依赖：pip install Appium-Python-Client运行：python douyin_ios.py"""import os, timefrom appium import webdriverfrom appium.options.ios import XCUITestOptionsfrom appium.webdriver.common.appiumby import AppiumByfrom selenium.webdriver.support.ui import WebDriverWaitfrom selenium.webdriver.support import expected_conditions as ECDOUYIN_BUNDLE_ID = "com.ss.android.ugc.aweme"SCREENSHOT_DIR = "./screenshots/ios"os.makedirs(SCREENSHOT_DIR, exist_ok=True)def get_driver():    caps = XCUITestOptions()    caps.platform_name = "iOS"    caps.device_name = "iPhone 15"    caps.bundle_id = DOUYIN_BUNDLE_ID    caps.no_reset = False    caps.automation_name = "XCUITest"    return webdriver.Remote("http://localhost:4723", options=caps)def dismiss_att_popup(driver):    """关闭iOS ATT隐私弹窗"""    try:        alert = WebDriverWait(driver, 3).until(EC.alert_is_present())        alert.accept()        time.sleep(1)    except Exception:        try:            allow_btn = driver.find_element(                AppiumBy.IOS_PREDICATE, 'name CONTAINS "允许"'            )            allow_btn.click()        except Exception:            passdef swipe_up_ios(driver):    """向上滑动（iOS专用）"""    size = driver.get_window_size()    x = size["width"] // 2    start_y = int(size["height"] * 0.75)    end_y = int(size["height"] * 0.25)    driver.execute_script("mobile: swipe", {        "startX": x, "startY": start_y,        "endX": x, "endY": end_y, "duration": 0.8    })    time.sleep(1.5)def click_search_ios(driver):    """点击搜索入口（iOS版）"""    try:        search_icon = WebDriverWait(driver, 10).until(            EC.element_to_be_clickable(                (AppiumBy.IOS_PREDICATE,                 'label CONTAINS "搜索" OR name CONTAINS "search"')            )        )    except Exception:        search_icon = WebDriverWait(driver, 5).until(            EC.element_to_be_clickable(                (AppiumBy.CLASS_NAME, "XCUIElementTypeTextField")            )        )    search_icon.click()    time.sleep(1)def search_and_capture_ios(driver, keyword):    """输入关键词搜索并截图"""    search_input = WebDriverWait(driver, 10).until(        EC.presence_of_element_located(            (AppiumBy.CLASS_NAME, "XCUIElementTypeTextField")        )    )    search_input.clear()    search_input.send_keys(keyword)    search_btn = driver.find_element(        AppiumBy.IOS_PREDICATE, 'name == "Search"'    )    search_btn.click()    time.sleep(3)    timestamp = time.strftime("%Y%m%d_%H%M%S")    screenshot_path = os.path.join(SCREENSHOT_DIR, f"search_result_{timestamp}.png")    driver.get_screenshot_as_file(screenshot_path)    print(f"截图已保存: {screenshot_path}")    return screenshot_pathdef test_douyin_ios_full_flow():    driver = get_driver()    try:        dismiss_att_popup(driver)       # Step1: 关闭ATT隐私弹窗        time.sleep(2)        swipe_up_ios(driver)           # Step2: 向上滑动        click_search_ios(driver)        # Step3: 点击搜索入口        time.sleep(2)        search_and_capture_ios(driver, "APP自动化测试")  # Step4        print("✅ iOS端Douyin自动化流程执行完成")    finally:        driver.terminate_app(DOUYIN_BUNDLE_ID)        driver.quit()if __name__ == "__main__":    test_douyin_ios_full_flow()

// douyin_harmony.ts — 抖音APP自动化测试（HarmonyOS Next）// 运行环境：DevEco Studio + DevEco Testing Toolkit// 语言：ArkTSimport driver from '@ohos.driver'import app from '@ohos.app.ability.Want'const BUNDLE_NAME: string = "com.ss.android.ugc.aweme"const SCREENSHOT_DIR: string = "./screenshots/harmony"export class DouyinHarmonyTest {  private searchKeyword: string = "APP自动化测试"  async dismissPrivacyPopup(): Promise {    try {      let agreeBtn = await driver.findElement({        "strategy": { "type": "text", "value": "同意" }      })      if (agreeBtn) { await agreeBtn.click() }    } catch (e) {      console.info("隐私弹窗不存在或已处理")    }    await driver.delay(1000)  }  async swipeUp(): Promise {    let rect = await driver.getDisplayBounds()    let x = rect.width / 2    let startY = rect.height * 0.75    let endY = rect.height * 0.25    await driver.swipe(      Math.round(x), Math.round(startY),      Math.round(x), Math.round(endY), 800    )    await driver.delay(1500)  }  async clickSearchIcon(): Promise {    let searchIcon: any = null    try {      searchIcon = await driver.findElement({        "strategy": { "type": "id", "value": "search_icon" }      })    } catch (e) {      searchIcon = await driver.findElement({        "strategy": { "type": "text", "value": "搜索" }      })    }    if (searchIcon) { await searchIcon.click() }    await driver.delay(1000)  }  async searchAndCapture(): Promise {    let searchInput: any = await driver.findElement({      "strategy": { "type": "className", "value": "TextInput" }    })    if (searchInput) { await searchInput.inputValue(this.searchKeyword) }    await driver.delay(500)    let searchBtn = await driver.findElement({      "strategy": { "type": "text", "value": "搜索" }    })    if (searchBtn) { await searchBtn.click() }    await driver.delay(3000)    let timestamp = Date.now().toString()    let path = `${SCREENSHOT_DIR}/search_result_${timestamp}.png`    await driver.captureScreen(path)    console.info("截图已保存: " + path)  }  async quitApp(): Promise {    await driver.terminateAbility(BUNDLE_NAME)  }  async testFullFlow(): Promise {    console.info("=== HarmonyOS Douyin自动化开始 ===")    await this.dismissPrivacyPopup()   // Step1    await this.swipeUp()                // Step2    await this.clickSearchIcon()        // Step3    await driver.delay(2000)    await this.searchAndCapture()       // Step4    await this.quitApp()                // Step5    console.info("=== HarmonyOS Douyin自动化完成 ===")  }}export default new DouyinHarmonyTest()

prompts/├── login.yaml          # 登录场景├── search.yaml         # 搜索场景├── swipe.yaml          # 滑动操作└── payment.yaml        # 支付流程

GitHub Actions / Jenkins  → 触发 Appium 测试  → Allure 报告（Android/iOS）  → DevEco Test Report（HarmonyOS）