Gordon 开源项目常见问题解决方案

Gordon 开源项目常见问题解决方案

Gordon Android Test Runner 项目地址: https://gitcode.com/gh_mirrors/gordo/Gordon

1. 项目基础介绍和主要编程语言

Gordon 是一个专为 Android 设计的仪器化测试运行器，旨在提高测试的速度、简洁性和可靠性。该项目是为了解决现有测试框架如 Spoon 和 Fork 的速度和可靠性问题而开发的。Gordon 从零开始构建，使用了现代的 Gradle 功能和 Kotlin 协程，提供了多种池策略、智能重试、灵活的测试过滤等功能，并支持 JUnit 和 HTML 报告。

主要编程语言：Kotlin

2. 新手使用项目时需要注意的三个问题及解决步骤

问题一：如何配置项目以使用 Gordon

问题描述： 新手在使用 Gordon 时，不知道如何配置项目以集成 Gordon。

解决步骤：

1. 在项目的根目录下的 settings.gradle.kts 文件中添加以下插件管理配置：

   pluginManagement {
       repositories {
           gradlePluginPortal()
           google()
           mavenCentral()
       }
       plugins {
           id("com.banno.gordon") version "$gordonVersion"
       }
   }
   

2. 在需要运行测试的模块的 build.gradle.kts 文件中添加以下插件应用配置：

   plugins {
       id("com.banno.gordon")
   }
   

3. 如果使用旧的 Gradle 插件语法，需要在根目录下的 build.gradle 文件的 buildscript 部分添加以下依赖：

   buildscript {
       repositories {
           gradlePluginPortal()
           google()
           mavenCentral()
       }
       dependencies {
           classpath "com.banno.gordon:gordon-plugin:$gordonVersion"
       }
   }
   

   并在每个需要运行测试的模块中应用插件：

   apply plugin: "com.banno.gordon"
   

问题二：如何配置设备池策略

问题描述： 新手在使用 Gordon 时，不知道如何配置设备池策略。

解决步骤：

1. 在需要配置设备池的模块的 build.gradle.kts 文件中添加以下配置：

   gordon {
       poolingStrategy = PoolingStrategy.PoolPerDevice // 默认为 PoolPerDevice
       // 或者可以配置为特定的设备池
       poolingStrategy = PoolingStrategy.Manual(
           mapOf(
               "poolOne" to setOf("deviceSerial1", "deviceSerial2"),
               "poolTwo" to setOf("deviceSerial3", "deviceSerial4")
           )
       )
   }
   

问题三：如何生成测试报告

问题描述： 新手在使用 Gordon 时，不知道如何生成测试报告。

解决步骤：

1. 在配置了 Gordon 的模块的 build.gradle.kts 文件中确保已经配置了以下插件：

   plugins {
       id("com.banno.gordon")
   }
   

2. 运行测试命令后，Gordon 会自动生成 JUnit 和 HTML 格式的测试报告。报告通常位于项目的 build/reports 目录下。

通过以上步骤，新手可以更好地开始使用 Gordon 项目，并有效地解决常见问题。

Gordon Android Test Runner 项目地址: https://gitcode.com/gh_mirrors/gordo/Gordon