移动测试云真机平台（BrowserStack 与 Sauce Labs）

# BrowserStack App Automate - Appium Python Client 配置示例
from appium import webdriver

capabilities = {
    # ---- BrowserStack 平台配置 ----
    "bstack:options": {
        "userName": "your_username",            # BrowserStack 账户名
        "accessKey": "your_access_key",         # 访问密钥（建议从环境变量读取）
        "projectName": "订单回归测试",          # 项目名（用于报告聚合）
        "buildName": "build-2026-08-12-001",    # 构建名（与 CI build 号对齐）
        "sessionName": "下单-支付宝-正常流程",  # 单次用例名
        "deviceLogs": True,                     # 收集设备日志（logcat/syslog）
        "networkLogs": True,                    # 抓取网络请求（HAR 格式）
        "video": True,                          # 录制执行视频
        "screenshot": True,                     # 自动截图
        "geoLocation": "CN",                    # 模拟地理位置（中国）
        "networkProfile": "4g-lte-good",        # 模拟 4G 网络环境
        "app": "bs://<hashed_app_id>",          # 已上传应用的 hash id
    },
    # ---- Appium 通用配置 ----
    "platformName": "Android",                  # 平台名
    "platformVersion": "14.0",                  # 系统版本
    "deviceName": "Google Pixel 8 Pro",         # 指定机型
    "automationName": "UiAutomator2",           # 自动化引擎
    "appPackage": "com.example.shop",           # 被测包名
    "appActivity": ".MainActivity",             # 启动 Activity
    "noReset": True,                            # 保留应用数据（兼容性场景设为 False）
    "newCommandTimeout": 300,                   # 单条命令超时（秒）
}

# 平台地址指向 BrowserStack 云端
driver = webdriver.Remote(
    command_executor="https://hub-cloud.browserstack.com/wd/hub",
    desired_capabilities=capabilities,
)

# 执行业务操作
driver.find_element("id", "com.example.shop:id/checkout").click()
driver.quit()

# .github/workflows/mobile-regression.yml - GitHub Actions 集成示例
name: 移动端回归测试

on:
  pull_request:
    branches: [ main, release/* ]
  workflow_dispatch:        # 支持手动触发

jobs:
  browserstack-test:
    runs-on: ubuntu-latest
    timeout-minutes: 30
    steps:
      - uses: actions/checkout@v4

      - name: 安装 Python 与依赖
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - run: |
          pip install Appium-Python-Client==4.0.1 pytest==8.3.2
          pip install browserstack-local==1.4.8   # 本地测试隧道

      - name: 上传应用到 BrowserStack
        id: upload
        run: |
          # 通过 REST API 上传 APK，返回 app_url
          APP_URL=$(curl -s -u "$BROWSERSTACK_USER:$BROWSERSTACK_KEY" \
            -X POST "https://api-cloud.browserstack.com/app-automate/upload" \
            -F "file=@app/build/outputs/apk/release/app-release.apk" \
            | jq -r '.app_url')
          echo "app_url=$APP_URL" >> $GITHUB_OUTPUT
        env:
          BROWSERSTACK_USER: ${{ secrets.BROWSERSTACK_USER }}
          BROWSERSTACK_KEY: ${{ secrets.BROWSERSTACK_KEY }}

      - name: 启动 BrowserStack Local 隧道（访问内网接口）
        run: |
          # 当被测应用需要回连公司内网 API 时，启动本地隧道
          BrowserStackLocal --key $BROWSERSTACK_KEY \
            --local-identifier ${{ github.run_id }} \
            --daemon start
        env:
          BROWSERSTACK_KEY: ${{ secrets.BROWSERSTACK_KEY }}

      - name: 执行并行测试
        run: |
          pytest tests/mobile/ -n 5 \
            --browserstack-app ${{ steps.upload.outputs.app_url }} \
            --local-identifier ${{ github.run_id }}
        env:
          BROWSERSTACK_USER: ${{ secrets.BROWSERSTACK_USER }}
          BROWSERSTACK_KEY: ${{ secrets.BROWSERSTACK_KEY }}

      - name: 上传测试报告
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: browserstack-report
          path: reports/

# Sauce Labs Real Device Cloud - Appium 配置示例
from appium import webdriver

capabilities = {
    # ---- Sauce Labs 平台配置（sauce:options 命名空间）----
    "sauce:options": {
        "username": "your_username",
        "accessKey": "your_access_key",
        "build": "release/2.8.0",                # 构建标识
        "name": "支付回退-银联通道",              # 用例名
        "tags": ["regression", "payment"],       # 标签（用于报告过滤）
        "custom-data": {"release": "2.8.0"},     # 自定义元数据
        "tunnelIdentifier": "ci-tunnel-001",     # Sauce Connect 隧道标识
        "recordVideo": True,                     # 录制视频
        "recordScreenshots": True,               # 自动截图
        "recordLogs": True,                      # 收集日志
        "networkCapture": True,                  # 抓包（HAR）
        "proxyHost": "proxy.corp.com",           # 走公司代理
    },
    # ---- 设备配置 ----
    "platformName": "iOS",
    "appium:platformVersion": "17.5",
    "appium:deviceName": "iPhone 15 Pro Max",
    "appium:automationName": "XCUITest",
    "appium:app": "storage:filename=Shop-iOS-2.8.0.ipa",  # 已上传应用名
    "appium:noReset": True,
    "appium:xcodeOrgId": "TEAM_ID",              # iOS 签名团队
    "appium:xcodeSigningId": "iPhone Developer",
    "appium:updatedWDABundleId": "com.shop.wda", # 自定义 WDA 包名
}

driver = webdriver.Remote(
    command_executor="https://ondemand.us-west-1.saucelabs.com/wd/hub",
    options=capabilities,
)

# 启动 Sauce Connect 隧道（后台运行，--pid 保存进程 ID）
sc -u $SAUCE_USERNAME -k $SAUCE_ACCESS_KEY \
  -i ci-tunnel-001 \                # 隧道标识（与 capabilities 中的 tunnelIdentifier 对应）
  --region us-west \                # 区域
  --pidfile /tmp/sc.pid \
  --daemon start

# Firebase Test Lab - 通过 gcloud 命令执行测试

# 1. 上传应用到 Firebase（自动生成 result id）
gcloud firebase test android run \
  --type robo \                              # 测试类型：robo（智能爬虫）
  --app app/build/outputs/apk/release/app-release.apk \
  --device model=Pixel8,version=34,locale=zh_CN,orientation=portrait \  # 设备矩阵
  --device model=galaxy-s24-ultra,version=34,locale=zh_CN,orientation=portrait \
  --timeout 300s \                           # 单设备超时
  --results-bucket=gs://my-test-results \    # GCS 存储桶（保存截图/视频/日志）
  --results-dir=build-2026-08-12             # 结果目录

# 2. 运行 Instrumentation 测试（Espresso）
gcloud firebase test android run \
  --type instrumentation \
  --app app/build/outputs/apk/release/app-release.apk \
  --test app/build/outputs/apk/androidTest/release/app-release-androidTest.apk \
  --device model=Pixel8,version=34 \
  --device model=galaxy-s24-ultra,version=34 \
  --num-shards 4 \                           # 分片并行（4 个设备各跑 1/4 用例）
  --test-targets "class com.shop.CheckoutTest" \  # 指定测试类
  --use-orchestrator                          # 使用 Android Test Orchestrator（用例隔离）

# 3. 在 CI 中获取结果（gcloud 返回 result id 后查询）
gcloud firebase test android describe <RESULT_ID> \
  --format="value(testState)"                 # 输出测试状态

- name: 设置 Google Cloud 凭据
  uses: google-github-actions/auth@v2
  with:
    credentials_json: ${{ secrets.GCP_SERVICE_ACCOUNT }}

- name: 配置 gcloud
  uses: google-github-actions/setup-gcloud@v2

- name: 运行 Firebase Test Lab
  run: |
    gcloud firebase test android run \
      --type robo \
      --app app/build/outputs/apk/release/app-release.apk \
      --device model=Pixel8,version=34 \
      --timeout 300s