添加docs,完善IOS的Readme
This commit is contained in:
134
docs/ios_setup/ios_setup.md
Normal file
134
docs/ios_setup/ios_setup.md
Normal file
@@ -0,0 +1,134 @@
|
||||
# iOS 环境配置指南
|
||||
|
||||
本文档介绍如何为 Open-AutoGLM 配置 iOS 设备环境。
|
||||
|
||||
## 环境要求
|
||||
|
||||
- macOS 操作系统
|
||||
- Xcode(最新版本,在App store中下载)
|
||||
- 苹果开发者账号(免费账号即可,无需付费)
|
||||
- iOS 设备(iPhone/iPad)
|
||||
- USB 数据线或同一 WiFi 网络
|
||||
|
||||
|
||||
## WebDriverAgent 配置
|
||||
|
||||
WebDriverAgent 是 iOS 自动化的核心组件,需要在 iOS 设备上运行。
|
||||
|
||||
### 1. 克隆 WebDriverAgent
|
||||
|
||||
```bash
|
||||
git clone https://github.com/appium/WebDriverAgent.git
|
||||
cd WebDriverAgent
|
||||
```
|
||||
|
||||
直接点击`WebDriverAgent.xcodeproj`即可使用Xcode打开。
|
||||
|
||||
### 2. 设置 Signing & Capabilities
|
||||
|
||||
1. 在 Xcode 中选中 `WebDriverAgent`,出现General、Signing&Capabilities等选项。
|
||||
2. 进入 `Signing & Capabilities` 选项卡
|
||||
3. 勾选 `Automatically manage signing`。在Team中选择自己的开发者账号
|
||||
4. 将 Bundle ID 改为唯一标识符,例如:`com.yourname.WebDriverAgentRunner`
|
||||

|
||||
|
||||
5. TARGETS中,建议将WebDriverAgentLib、WebDriverAgentRunner、IntegrationApp的`Signing & Capabilities` 都按照相同方式设置。
|
||||

|
||||
|
||||
### 3. 测试XCode的GUI模式和UI自动化设置
|
||||
|
||||
建议先测试GUI模式能否成功安装WebDriverAgent,再进行后续步骤。
|
||||
Mac和iPhone有USB和WiFi两种连接方式,建议通过USB方式,成功率更高。
|
||||
|
||||
#### 通过 WiFi 连接
|
||||
|
||||
需要满足以下条件:
|
||||
1. 通过USB连接。在Finder中选中连接的IPhone,在“通用”中勾选"在 WiFi 中显示这台 iPhone"
|
||||
2. Mac 与 iPhone 处于同一 WiFi 网络之下
|
||||
|
||||
#### 具体步骤
|
||||
1. 从项目 Target 选择 `WebDriverAgentRunner`
|
||||
2. 选择你的设备
|
||||
|
||||

|
||||
|
||||
3. 长按"▶️"运行按钮,选择 "Test" 后开始编译并部署到你的 iPhone 上
|
||||
|
||||

|
||||
|
||||
部署成功的标志:1. XCode没有报错。2. 你可以在iPhone上找到名为WebDriverAgentRunner的App
|
||||
|
||||
#### 设备信任配置
|
||||
|
||||
首次运行时,需要在 iPhone 上完成以下设置,然后重新编译和部署:
|
||||
|
||||
1. **输入解锁密码**
|
||||
2. **信任开发者应用**
|
||||
- 进入:设置 → 通用 → VPN与设备管理
|
||||
- 在“开发者 App”中选择对应开发者
|
||||
- 点击信任“XXX”
|
||||
|
||||

|
||||
|
||||
3. **启用 UI 自动化**
|
||||
- 进入:设置 → 开发者
|
||||
- 打开 UI 自动化设置
|
||||
|
||||

|
||||
|
||||
### 4. XCode命令行模式部署
|
||||
|
||||
1.安装libimobiledevice,用于与 iPhone / iPad 建立连接与通信。
|
||||
|
||||
```
|
||||
brew install libimobiledevice
|
||||
# 设备检查
|
||||
idevice_id -ln
|
||||
```
|
||||
2.使用xcodebuild安装WebAgent。命令行也需要进行“设备信任配置”,参考GUI模式下的方法。
|
||||
|
||||
```
|
||||
cd WebDriverAgent
|
||||
|
||||
xcodebuild -project WebDriverAgent.xcodeproj \
|
||||
-scheme WebDriverAgentRunner \
|
||||
-destination 'platform=iOS,name=YOUR_PHONE_NAME' \
|
||||
test
|
||||
```
|
||||
这里,YOUR_PHONE_NAME可以在xcode的GUI中看到。
|
||||
WebDriverAgent 成功运行后,会在 Xcode 控制台输出类似以下信息:
|
||||
|
||||
```
|
||||
ServerURLHere->http://[设备IP]:8100<-ServerURLHere
|
||||
```
|
||||
|
||||
同时,观察到手机上安装好了WebDriverAgentRunner,屏幕显示Automation Running字样。
|
||||
其中,**http://[设备IP]:8100**为WiFi所需的WDA_URL。
|
||||
|
||||
## 使用 AutoGLM
|
||||
|
||||
以上配置完成后,先打开一个新终端,在后台建立端口映射(使用WiFi连接则不需要):
|
||||
|
||||
```bash
|
||||
iproxy 8100 8100
|
||||
```
|
||||
|
||||
之后,打开一个新终端,通过以下命令使用AutoGLM(WiFi则使用上述获得的WDA_URL):
|
||||
|
||||
```bash
|
||||
python ios.py --base-url "YOUR_BASE_URL" \
|
||||
--model "autoglm-phone" \
|
||||
--api-key "YOUR_API_KEY" \
|
||||
--wda-url http://localhost:8100 \
|
||||
"TASK"
|
||||
```
|
||||
|
||||
## 参考资源
|
||||
|
||||
- [WebDriverAgent 官方仓库](https://github.com/appium/WebDriverAgent)
|
||||
- [PR141](https://github.com/zai-org/Open-AutoGLM/pull/141)
|
||||
- [Gekowa提供的ios方案](https://github.com/gekowa/Open-AutoGLM/tree/ios-support)
|
||||
|
||||
---
|
||||
|
||||
如有其他问题,请参考主项目 README 或提交 Issue。
|
||||
Reference in New Issue
Block a user