从零到一：用UI Automator构建你的第一个Android自动化测试脚本

糖果HTML

75人浏览 · 2026-02-14 00:13:02

糖果HTML · 2026-02-14 00:13:02 发布

从零到一：用UI Automator构建你的第一个Android自动化测试脚本

在移动应用开发领域，自动化测试已经成为保障产品质量的关键环节。对于Android开发者而言，UI Automator作为官方提供的黑盒测试框架，能够在不修改应用源码的情况下，模拟用户操作并验证界面交互逻辑。无论你是独立开发者还是测试工程师，掌握UI Automator都能显著提升测试效率，减少重复劳动。本文将带你从环境搭建到脚本部署，完整实现第一个自动化测试案例，特别针对初学者常见的环境配置痛点提供解决方案。

1. 环境准备与工具配置

搭建UI Automator测试环境需要确保开发工具链的完整性和兼容性。首先需要安装Java Development Kit（JDK），推荐使用JDK 8或11这两个长期支持版本。安装完成后需配置JAVA_HOME环境变量，并将JDK的bin目录添加到系统PATH中。可以通过命令行执行java -version验证安装是否成功。

Android Studio是推荐的集成开发环境，它内置了Android SDK管理工具。安装完成后打开SDK Manager，确保以下组件已安装：

Android SDK Platform（对应API级别16及以上）
Android SDK Build-Tools
Android SDK Platform-Tools
Android SDK Tools

特别需要注意SDK路径的配置，后续构建脚本时需要引用此路径下的uiautomator库文件。建议将Android SDK的platform-tools目录也添加到系统PATH中，方便使用adb命令行工具。

提示：如果遇到构建失败提示"Class not found: javac1.8"等版本兼容性问题，可能是因为Ant工具版本过旧。建议从Apache官网下载最新版Ant，替换旧版本并更新环境变量。

2. 创建测试项目结构

在Android Studio中创建新项目时，选择"Java Library"模块类型而非标准Android应用。项目命名建议体现测试特性，如"AppNameUITests"。创建完成后需要手动添加依赖库，右键点击项目选择"Open Module Settings"，在Dependencies标签页中添加以下库文件：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'junit:junit:4.13.2'
    implementation files('${android_sdk_path}/platforms/android-xx/android.jar')
    implementation files('${android_sdk_path}/tools/lib/uiautomator.jar')
}

其中${android_sdk_path}需要替换为本地SDK安装路径，android-xx中的xx代表目标API级别。建议使用与测试设备相同的API级别以确保兼容性。

项目目录结构应合理组织，推荐按功能模块分包：

src/
  main/
    java/
      com/
        example/
          tests/
            core/
            flows/
            utils/

这种结构有利于后期维护和扩展，当测试用例增多时仍能保持清晰的组织逻辑。

3. 编写第一个测试脚本

UI Automator测试类的编写需要继承UiAutomatorTestCase基类，并遵循JUnit测试命名规范。下面是一个完整的示例，模拟用户打开设置菜单并调整声音选项的流程：

package com.example.tests;

import com.android.uiautomator.core.UiObject;
import com.android.uiautomator.core.UiObjectNotFoundException;
import com.android.uiautomator.core.UiScrollable;
import com.android.uiautomator.core.UiSelector;
import com.android.uiautomator.testrunner.UiAutomatorTestCase;

public class SettingsSoundTest extends UiAutomatorTestCase {
    
    public void testSoundSettingsNavigation() throws UiObjectNotFoundException {
        // 模拟按下Home键返回主屏幕
        getUiDevice().pressHome();
        
        // 等待主界面完全加载
        getUiDevice().waitForIdle(3000);
        
        // 定位并点击"应用"按钮进入应用列表
        UiObject appsButton = new UiObject(new UiSelector()
            .descriptionMatches("(?i)apps|应用"));
        appsButton.clickAndWaitForNewWindow();
        
        // 在应用列表中定位设置应用
        UiScrollable appList = new UiScrollable(new UiSelector()
            .scrollable(true).className("android.widget.ListView"));
        
        UiObject settingsApp = appList.getChildByText(new UiSelector()
            .className("android.widget.TextView"), "Settings");
        settingsApp.clickAndWaitForNewWindow();
        
        // 验证已进入设置界面
        UiObject settingsValidation = new UiObject(new UiSelector()
            .packageName("com.android.settings"));
        assertTrue("设置应用未正常启动", settingsValidation.exists());
        
        // 滚动查找声音选项
        UiScrollable settingsList = new UiScrollable(new UiSelector()
            .scrollable(true).resourceId("android:id/list"));
        
        UiObject soundOption = settingsList.getChildByText(new UiSelector()
            .className("android.widget.TextView"), "Sound");
        soundOption.clickAndWaitForNewWindow();
        
        // 验证声音设置界面
        UiObject volumesOption = new UiObject(new UiSelector()
            .textContains("Volume"));
        assertTrue("声音设置界面未正常加载", volumesOption.exists());
        
        // 返回主屏幕结束测试
        getUiDevice().pressHome();
    }
}

这段代码展示了UI Automator的核心操作模式：通过选择器定位界面元素，执行点击、滚动等交互操作，并使用断言验证预期结果。注意异常处理的重要性，UI操作可能因界面加载延迟而失败，适当的等待机制能提高测试稳定性。

控件定位策略有多种选择，可以根据实际界面结构灵活运用：

定位方式	示例代码	适用场景
文本匹配	`new UiSelector().text("Submit")`	按钮、标签等有明确文本的元素
描述符匹配	`new UiSelector().description("menu")`	图像按钮、无障碍辅助功能
类名匹配	`new UiSelector().className("android.widget.Button")`	按控件类型批量操作
资源ID匹配	`new UiSelector().resourceId("com.example:id/btn")`	最精确的定位方式，需要API18+

注意：在实际项目中，建议将选择器字符串提取为常量或资源文件，避免硬编码提高维护性。同时考虑封装常用操作如clickSafe()方法，包含重试机制处理瞬时异常。

4. 构建与部署测试包

完成代码编写后，需要将项目构建为JAR包并部署到设备执行。首先在项目根目录生成构建配置文件：

android create uitest-project -n AutomationDemo -t android-25 -p ./TestProject

其中-t参数指定目标API级别，需与测试设备Android版本匹配。执行成功后会在项目目录生成build.xml文件，这是Ant构建脚本的定义文件。

使用Ant进行构建：

cd TestProject
ant build

构建成功后会在bin目录生成AutomationDemo.jar文件。接下来连接Android设备或启动模拟器，通过adb命令推送测试包：

adb push AutomationDemo.jar /data/local/tmp/

执行测试命令指定要运行的测试类：

adb shell uiautomator runtest AutomationDemo.jar -c com.example.tests.SettingsSoundTest

测试结果会实时输出到控制台，包括每个操作步骤的执行情况和最终测试结果。如果测试失败，会显示具体的失败原因和堆栈跟踪，帮助快速定位问题。

为了提高测试效率，可以考虑以下优化措施：

使用批处理脚本或Makefile自动化构建部署流程
集成持续集成工具如Jenkins实现定时自动测试
使用adb logcat捕获设备日志辅助调试
分模块构建测试包，减少单个包体积提高执行速度

5. 高级技巧与最佳实践

基础的线性脚本虽然简单，但难以应对复杂的测试场景。下面介绍几种提升测试代码质量的实践方法。

页面对象模式（Page Object Pattern） 将界面元素封装为可重用的对象类：

public class HomeScreen {
    private final UiDevice mDevice;
    
    public HomeScreen() {
        mDevice = UiDevice.getInstance();
    }
    
    public AppLauncher openAppDrawer() throws UiObjectNotFoundException {
        UiObject appsButton = new UiObject(new UiSelector()
            .description("Apps"));
        appsButton.click();
        return new AppLauncher();
    }
}

public class AppLauncher {
    public SettingsApp openSettings() throws UiObjectNotFoundException {
        UiScrollable appList = new UiScrollable(new UiSelector()
            .scrollable(true));
        UiObject settingsApp = appList.getChildByText(new UiSelector()
            .className("android.widget.TextView"), "Settings");
        settingsApp.click();
        return new SettingsApp();
    }
}

这种模式大幅提高了代码的可读性和维护性，特别适合大型测试项目。

数据驱动测试 允许使用外部数据源参数化测试用例：

@Parameterized.Parameters
public static Collection<Object[]> testData() {
    return Arrays.asList(new Object[][] {
        { "Sound", "Volumes" },
        { "Display", "Brightness" },
        { "Storage", "Internal storage" }
    });
}

public void testSettingsOptions(String menuItem, String validationText) {
    // 使用参数化数据执行测试
    UiObject option = new UiObject(new UiSelector().text(menuItem));
    option.click();
    
    UiObject validation = new UiObject(new UiSelector().textContains(validationText));
    assertTrue("选项验证失败", validation.exists());
}

屏幕截图与错误报告 在测试失败时自动捕获现场：

try {
    // 测试操作
} catch (Exception e) {
    File screenshot = new File("/sdcard/test_failure.png");
    getUiDevice().takeScreenshot(screenshot);
    throw e;
}

这些高级技巧能够显著提升测试代码的健壮性和可维护性，值得在项目中逐步引入和实施。

6. 常见问题与调试技巧

初学者在使用UI Automator时常会遇到各种问题，以下是几个典型场景的解决方案。

元素定位失败 是最常见的问题，通常是因为界面尚未加载完成或选择器不够精确。解决方法：

增加等待时间：getUiDevice().waitForIdle(5000)
使用更具体的选择器：结合多个属性定位元素
启用UI Automator Viewer工具分析界面结构

跨应用测试权限 需要特殊处理，特别是在Android 6.0+版本上：

# 授予必要权限
adb shell pm grant com.android.settings android.permission.CHANGE_CONFIGURATION

测试执行超时 可能由于设备性能或网络延迟导致，可以调整超时设置：

UiConfigurator.getInstance().setWaitForSelectorTimeout(10000);

日志记录是调试的重要手段，可以在测试代码中添加详细日志：

import android.util.Log;

public class Logger {
    public static void debug(String tag, String message) {
        Log.d(tag, message);
    }
}

// 使用示例
Logger.debug("SettingsTest", "点击声音选项");

当遇到难以解决的问题时，可以参考以下排查流程：