feat: one-click Windows setup scripts + fix Appium v3 commands in docs

- scripts/setup_execute_env.bat: auto-detect Android SDK, set PATH permanently, validate all deps
- scripts/start_appium.bat: one-click Appium Server startup with v3-compatible params
- Fix all 'appium --allow-insecure' commands for Appium v3 (driver:feature format)
- Add Windows quick-start section to EXECUTE_SETUP_GUIDE.md
This commit is contained in:
xst
2026-07-10 15:13:09 +08:00
parent d37017534d
commit b958b75899
3 changed files with 231 additions and 10 deletions
+48 -10
View File
@@ -8,13 +8,40 @@
## 目录
1. [架构概览](#1-架构概览)
2. [PC Web 端配置 (Playwright)](#2-pc-web-端配置-playwright)
3. [Android 端配置 (Appium)](#3-android-端配置-appium)
4. [iOS 端配置 (Appium + XCUITest)](#4-ios-端配置-appium--xcuitest)
5. [验证环境](#5-验证环境)
6. [运行 Execute 战区](#6-运行-execute-战区)
7. [常见问题](#7-常见问题)
1. [一键配置(Windows 用户优先看这里)](#一键配置windows-用户优先看这里)
2. [架构概览](#1-架构概览)
3. [PC Web 端配置 (Playwright)](#2-pc-web-端配置-playwright)
4. [Android 端配置 (Appium)](#3-android-端配置-appium)
5. [iOS 端配置 (Appium + XCUITest)](#4-ios-端配置-appium--xcuitest)
6. [验证环境](#5-验证环境)
7. [运行 Execute 战区](#6-运行-execute-战区)
8. [常见问题](#7-常见问题)
---
## 一键配置(Windows 用户优先看这里)
如果你用的是 Windows,我们提供了一键配置脚本,自动处理 PATH、环境变量、验证所有依赖:
```batch
cd QaAutomationHub
scripts\setup_execute_env.bat
```
这个脚本会:
- 自动检测 Android SDK 路径
- 设置 `ANDROID_HOME``sdkmanager``emulator``adb` 到 PATH
- 永久写入系统 PATH(以后开新窗口也生效)
- 逐项验证 Python / Playwright / Java / adb / Appium / Agent
- 打印常用命令速查卡片
**你要手动做的只剩下**
1. 装 Playwright 浏览器(如果脚本提示未安装)
2. 创建 Android 模拟器(只需一次)
3. 启动 Appium Server
下面手动步骤为 macOS / Linux 用户和需要精细控制的场景准备。
---
@@ -429,10 +456,10 @@ source .venv/bin/activate
```bash
# 新开一个终端窗口
appium --allow-insecure chromedriver_autodownload
appium --allow-insecure "uiautomator2:chromedriver_autodownload"
# 或后台运行
appium --allow-insecure chromedriver_autodownload &
appium --allow-insecure "uiautomator2:chromedriver_autodownload" &
```
### 6.3 手动运行生成的脚本
@@ -516,11 +543,22 @@ sudo apt install fonts-noto-cjk
### Q5: Appium 报 `chrome-driver` 相关错误
**解决**: Android WebView/H5 测试需要匹配的 chromedriver
**解决**: Android WebView/H5 测试需要匹配的 chromedriver
注意 Appium v3.x 和 v2.x 的参数格式不同:
```bash
# Appium v3.x(当前版本) — 格式: 驱动名:功能名
appium --allow-insecure "uiautomator2:chromedriver_autodownload"
# Appium v2.x — 旧格式
appium --allow-insecure chromedriver_autodownload
```
也可以用项目自带的脚本一键启动:
```batch
scripts\start_appium.bat
```
### Q6: 部分设备连接后 `adb` 不识别
**解决**: