告别卡顿与黑屏：Android TV应用的UI自动化测试实践指南

2026-02-05 04:02:42作者：滑思眉Philip

你是否还在为Android TV应用频繁出现的卡顿、黑屏和遥控器操作无响应问题烦恼？作为电视直播类应用，用户体验直接取决于界面响应速度和操作流畅度。本文将以my-tv项目为例，详解如何使用UI Automator构建高效的自动化测试框架，解决90%的常见UI问题。

读完本文你将掌握：

针对遥控器导航的自动化测试用例设计
视频播放场景的稳定性测试方案
跨设备兼容性测试的实现方法
结合CI/CD的自动化测试流程

项目背景与测试挑战

my-tv是一款流行的电视直播应用，支持国内外多个频道播放。根据更新日志显示，项目迭代过程中曾多次面临以下UI相关问题：

设备兼容性问题：如斐讯N1盒子无法自启(HISTORY.md#L40)、中国移动盒子闪退(HISTORY.md#L44)
遥控器操作异常：返回键无法退出(HISTORY.md#L82)、左右键功能失效(HISTORY.md#L177)
显示问题：设置页显示不全(HISTORY.md#L11)、全面屏适配问题(HISTORY.md#L57)

这些问题的根本原因在于TV设备碎片化严重，传统手动测试难以覆盖所有场景。UI Automator框架能够模拟真实遥控器操作，在各种设备上执行自动化测试，有效解决这些痛点。

测试环境搭建

基础依赖配置

首先需要在项目的app/build.gradle中添加UI Automator依赖：

android {
    defaultConfig {
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
}

dependencies {
    androidTestImplementation 'androidx.test.uiautomator:uiautomator-v18:2.2.0'
    androidTestImplementation 'androidx.test:runner:1.4.0'
    androidTestImplementation 'androidx.test:rules:1.4.0'
}

测试设备准备

推荐使用至少3类测试设备覆盖主要场景：

主流品牌TV：如小米电视、创维电视
电视盒子：如天猫魔盒、斐讯N1(HISTORY.md#L40)
低版本Android设备：Android 4.4+(HISTORY.md#L319)

通过ADB连接设备进行测试，参考安装指南：

adb connect <设备IP>
adb install -r app-debug.apk

核心测试场景实现

1. 遥控器导航测试

针对TV应用的核心交互方式，需重点测试遥控器按键操作。以下是频道切换测试用例：

@RunWith(AndroidJUnit4.class)
public class RemoteControlTest {
    private UiDevice mDevice;
    
    @Before
    public void setUp() throws Exception {
        mDevice = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation());
        mDevice.pressHome();
        // 启动应用
        Context context = ApplicationProvider.getApplicationContext();
        Intent intent = context.getPackageManager()
            .getLaunchIntentForPackage("com.lizongying.mytv");
        intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK);
        context.startActivity(intent);
        Thread.sleep(5000); // 等待应用启动
    }
    
    @Test
    public void testChannelNavigation() {
        // 测试上/下键切换频道
        for (int i = 0; i < 5; i++) {
            mDevice.pressDPadUp();
            Thread.sleep(2000);
            // 验证频道信息更新
            UiObject channelInfo = mDevice.findObject(By.res("com.lizongying.mytv:id/channel_info"));
            assertTrue("频道信息未更新", channelInfo.exists());
            
            mDevice.pressDPadDown();
            Thread.sleep(2000);
        }
        
        // 测试左右键打开菜单
        mDevice.pressDPadLeft();
        Thread.sleep(1000);
        UiObject channelList = mDevice.findObject(By.res("com.lizongying.mytv:id/channel_list"));
        assertTrue("左侧频道列表未打开", channelList.exists());
        
        mDevice.pressDPadRight();
        Thread.sleep(1000);
        UiObject settingMenu = mDevice.findObject(By.res("com.lizongying.mytv:id/setting_menu"));
        assertTrue("右侧设置菜单未打开", settingMenu.exists());
    }
}

2. 视频播放稳定性测试

视频播放是my-tv的核心功能，需测试不同场景下的播放稳定性：

@Test
public void testVideoPlaybackStability() throws Exception {
    // 选择第一个频道
    mDevice.findObject(By.res("com.lizongying.mytv:id/channel_1")).click();
    Thread.sleep(10000); // 等待视频加载
    
    // 验证视频正在播放
    UiObject player = mDevice.findObject(By.res("com.lizongying.mytv:id/player_view"));
    assertTrue("播放器未加载", player.exists());
    
    // 持续播放测试(5分钟)
    long endTime = System.currentTimeMillis() + 5 * 60 * 1000;
    while (System.currentTimeMillis() < endTime) {
        // 检查是否黑屏
        assertFalse("播放过程中黑屏", isScreenBlack());
        
        // 检查是否卡顿(对比前后帧变化)
        Bitmap prevFrame = captureScreen();
        Thread.sleep(5000);
        Bitmap currFrame = captureScreen();
        assertTrue("视频卡顿超过5秒", isFrameChanged(prevFrame, currFrame));
    }
}

3. 错误场景处理测试

根据更新日志，应用曾多次修复错误处理相关问题。以下测试用例验证错误场景的处理能力：

@Test
public void testErrorHandling() {
    // 模拟网络断开
    setNetworkState(false);
    
    // 尝试播放频道
    mDevice.findObject(By.res("com.lizongying.mytv:id/channel_1")).click();
    Thread.sleep(3000);
    
    // 验证错误提示显示
    UiObject errorDialog = mDevice.findObject(By.res("com.lizongying.mytv:id/error_dialog"));
    assertTrue("错误提示未显示", errorDialog.exists());
    
    UiObject retryButton = mDevice.findObject(By.res("com.lizongying.mytv:id/retry_button"));
    assertTrue("重试按钮不存在", retryButton.exists());
    
    // 恢复网络并重试
    setNetworkState(true);
    retryButton.click();
    Thread.sleep(5000);
    assertTrue("重试后仍未恢复播放", mDevice.findObject(By.res("com.lizongying.mytv:id/player_view")).exists());
}

自动化测试集成

测试报告生成

使用Espresso Test Recorder录制测试用例，并结合Allure生成可视化报告：

./gradlew connectedAndroidTest
allure serve app/build/reports/allure-results

CI/CD集成

在项目的GitHub Actions配置中添加测试步骤(.github/workflows/android-test.yml)：

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Set up JDK 11
        uses: actions/setup-java@v3
        with:
          java-version: '11'
          distribution: 'temurin'
      
      - name: Run UI Tests
        run: ./gradlew connectedAndroidTest
      
      - name: Upload Test Report
        uses: actions/upload-artifact@v3
        with:
          name: test-report
          path: app/build/reports/androidTests/connected/