sing-box移动端自动化测试：使用Appium进行UI测试

你是否还在为sing-box移动端应用的兼容性测试而烦恼？手动测试不同设备、系统版本耗时费力，且容易遗漏关键场景。本文将带你使用Appium实现sing-box移动端UI自动化测试，覆盖Android和iOS平台，提高测试效率和覆盖率。读完本文，你将掌握测试环境搭建、测试用例编写、测试报告生成的完整流程。

测试环境准备

必要工具安装

进行sing-box移动端UI测试前，需要安装以下工具：

• Appium Server：用于控制移动设备执行测试用例
• Android SDK：针对Android平台测试，需配置环境变量
• Xcode Command Line Tools：针对iOS平台测试
• Appium Inspector：用于定位UI元素

项目测试资源

sing-box提供了Android和iOS客户端源码，位于以下目录：

• Android客户端：clients/android/
• iOS客户端：clients/apple/

Android平台测试实现

测试配置文件

创建Android测试配置文件android-test-config.json，指定设备信息和应用路径：

{
  "platformName": "Android",
  "deviceName": "Android Emulator",
  "app": "clients/android/app/build/outputs/apk/debug/app-debug.apk",
  "automationName": "UiAutomator2"
}

基本测试用例示例

使用Java编写简单的启动测试用例，验证应用能否正常打开：

import io.appium.java_client.android.AndroidDriver;
import org.openqa.selenium.remote.DesiredCapabilities;
import java.net.URL;

public class SingBoxAndroidTest {
    public static void main(String[] args) throws Exception {
        DesiredCapabilities caps = new DesiredCapabilities();
        caps.setCapability("platformName", "Android");
        caps.setCapability("deviceName", "Android Emulator");
        caps.setCapability("app", "clients/android/app/build/outputs/apk/debug/app-debug.apk");
        
        AndroidDriver driver = new AndroidDriver(new URL("http://localhost:4723/wd/hub"), caps);
        Thread.sleep(5000); // 等待应用启动
        driver.quit();
    }
}

iOS平台测试实现

测试环境配置

iOS测试需要额外配置Xcode和iOS模拟器，确保以下依赖已安装：

• Xcode 14+
• iOS Simulator SDK
• Carthage依赖管理工具

元素定位与操作

使用Appium Inspector定位iOS应用元素，以设置页面为例，获取"服务器地址"输入框并输入文本：

// 定位服务器地址输入框
MobileElement serverInput = driver.findElement(By.id("server_address_input"));
serverInput.sendKeys("proxy.example.com");

// 点击保存按钮
MobileElement saveButton = driver.findElement(By.accessibilityId("save_button"));
saveButton.click();

测试报告生成

集成Allure报告

通过Maven集成Allure报告插件，在pom.xml中添加依赖：

<dependency>
    <groupId>io.qameta.allure</groupId>
    <artifactId>allure-junit4</artifactId>
    <version>2.13.0</version>
    <scope>test</scope>
</dependency>

生成测试报告

执行测试后，生成Allure报告：

mvn test
allure serve target/allure-results

持续集成配置

GitHub Actions工作流

创建.github/workflows/ui-test.yml文件，配置自动化测试工作流：

name: UI Tests
on: [push]
jobs:
  android-test:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v3
      - name: Set up JDK 11
        uses: actions/setup-java@v3
        with:
          java-version: '11'
          distribution: 'temurin'
      - name: Run Android UI tests
        run: mvn test -Dtest=AndroidTestSuite

常见问题解决

元素定位失败

• 确保Appium Inspector使用正确的应用版本
• 尝试使用 accessibilityId替代xpath定位
• 增加元素等待时间：WebDriverWait wait = new WebDriverWait(driver, 10);

测试稳定性问题

• 避免硬编码等待时间，使用显式等待
• 实现测试用例重试机制
• 定期清理测试环境数据

总结与展望

本文介绍了使用Appium进行sing-box移动端UI自动化测试的完整流程，包括环境搭建、用例编写、报告生成和持续集成。通过自动化测试，可以显著提高测试效率和应用质量。未来可以进一步探索：

• 视觉AI测试：集成图像识别验证UI一致性
• 性能测试：结合Appium获取应用响应时间
• 云测试平台：利用Sauce Labs扩展测试设备覆盖范围

希望本文能帮助你构建稳定高效的sing-box移动端测试体系，如有问题可参考官方文档docs/support.md获取支持。