Dropbox Dropshots 项目常见问题解决方案

Dropbox Dropshots 项目常见问题解决方案

dropshots Easy on-device screenshot testing for Android. 项目地址: https://gitcode.com/gh_mirrors/dr/dropshots

项目基础介绍

Dropshots 是一个由 Dropbox 开发的开源库和 Gradle 插件，旨在为 Android 平台提供便捷的设备截图测试功能。该项目的核心功能是允许开发者直接在设备上执行截图测试，并与版本控制中的参考图像进行对比，从而简化测试流程。主要编程语言为 Java 和 Kotlin。

新手常见问题及解决步骤

问题一：如何将 Dropshots 集成到 Android 项目中？

解决步骤：

1. 在项目的 build.gradle 文件中应用 Dropshots 插件。如果是使用 Kotlin DSL，添加以下代码：

   plugins {
       id("com.android.application")
       id("com.dropbox.dropshots") version "0.4.2"
   }
   

2. 如果使用的是传统的 Groovy DSL，则添加以下代码：

   apply plugin: 'com.android.application'
   apply plugin: 'com.dropbox.dropshots'
   

3. 确保在 settings.gradle 文件中添加了 Maven Central 作为仓库源：

   pluginsManagement {
       repositories {
           mavenCentral()
           gradlePluginPortal()
       }
   }
   

4. 在 build.gradle 文件中的 dependencies 部分添加 Dropshots 的依赖：

   dependencies {
       classpath "com.dropbox.dropshots:dropshots-gradle-plugin:0.4.2"
   }
   

问题二：如何在项目中创建和验证截图？

解决步骤：

1. 创建一个标准的 Android Instrumentation 测试，使用 Dropshots 的运行时库。
2. 在测试类中，使用 Dropshots.create() 方法创建一个新的截图任务，并使用 assert 方法来验证截图。
3. 例如：

   class ExampleTest : InstrumentationTestCase() {
       fun testScreenshot() {
           val screenshot = Dropshots.create(testContext, "example")
           screenshot.assert("example.png")
       }
   }
   

问题三：如何管理参考图像？

解决步骤：

1. 使用 Dropshots 插件自动创建的 Gradle 任务来管理参考图像。这些任务包括 dropshotsCreate, dropshotsValidate, 和 dropshotsUpdate。
2. 要创建新的参考图像，运行 ./gradlew dropshotsCreate 任务。
3. 要验证现有的截图与参考图像是否匹配，运行 ./gradlew dropshotsValidate 任务。
4. 如果需要更新参考图像，运行 ./gradlew dropshotsUpdate 任务。这将替换当前版本控制中的图像。

通过上述步骤，新手开发者可以顺利地集成和利用 Dropshots 来进行 Android 设备上的截图测试。

dropshots Easy on-device screenshot testing for Android. 项目地址: https://gitcode.com/gh_mirrors/dr/dropshots