Appium Swift 客户端

SwiftAppium 是一个现代化的 Swift 客户端，用于 Appium 自动化服务器。它为移动应用测试提供类型安全、async/await API。

会话管理
- 创建/删除会话
- 获取活动会话
- 获取服务器状态
元素交互
- 查找元素
- 点击元素
- 发送键
- 获取元素文本
- 检查元素状态
应用管理
- 启动/关闭应用
- 重置应用状态
- 处理应用设置
设备控制
- 处理键盘
- 管理屏幕方向
- 截取屏幕截图

要求

macOS 14.0+
Swift 6.0+
Xcode 15.0+

安装设置

1. 安装 Appium 服务器

首先，确保您已安装 Node.js，然后安装 Appium

npm install -g appium

启动 Appium 服务器

appium

2. 将 SwiftAppium 添加到您的项目

将以下内容添加到您的 Package.swift

dependencies: [
    .package(url: "https://github.com/milcgroup/SwiftAppium.git", from: "1.0.0")
]

3. 基本用法

首先，在您的测试文件中导入 SwiftAppium

import SwiftAppium
import Testing

// Example test function
@Test
func testApp() async throws {
    // Start a session with desired capabilities
    let capabilities = [
        "platformName": "iOS",
        "automationName": "XCUITest",
        udid: "Device UUID",
        "deviceName": "iPhone 16",
        "app": "yourapp.bundle.id"
    ]
    
    // Get server status
    let status = try await client.getStatus()
    print("Server is ready: \(status.ready)")
    
    // Find and interact with elements
    try await client.waitAndClickElement(
        client, sessionId,
        strategy: .accessibilityId,
        selector: "button"
    )
}

贡献

欢迎贡献! 请随时提交 Pull Request。

许可证

本项目基于 Apache License 2.0 许可证 - 详情请参阅 LICENSE 文件。