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:
+48
-10
@@ -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` 不识别
|
||||
|
||||
**解决**:
|
||||
|
||||
Reference in New Issue
Block a user