TestableMock 使用教程

1. 项目的目录结构及介绍

TestableMock 是一个用于简化单元测试中 Mock 操作的开源项目。以下是其主要目录结构及其介绍：

|-- testable-parent ➜ 提供各子模块的公共父pom文件
|-- testable-all ➜ 依赖聚合，便于一次性引用所有子模块功能
|-- testable-processor ➜ 编译期代码预处理模块，提供测试辅助功能
|-- testable-agent ➜ JavaAgent模块，提供Mock测试相关功能
|-- testable-core ➜ 基础功能模块，提供Mock相关注解和工具类
|-- testable-maven-plugin ➜ Maven插件模块，用于简化JavaAgent注入
|-- tool ➜ 项目开发过程中的工具脚本
|-- demo
|   |-- java-demo ➜ Java语言的示例代码
|   |-- kotlin-demo ➜ Kotlin语言的示例代码
|   |-- android-demo ➜ Android项目的示例代码
|   `-- spock-demo ➜ Spock测试框架的示例代码
`-- docs ➜ 项目使用文档

2. 项目的启动文件介绍

TestableMock 项目本身是一个库，因此没有传统意义上的“启动文件”。它通过 Maven 或 Gradle 插件集成到你的项目中。以下是主要的启动相关文件：

• testable-agent 模块中的 TestableAgent.java：这是 JavaAgent 的核心文件，负责在运行时注入 Mock 功能。
• testable-maven-plugin 模块中的 TestableMavenPlugin.java：这是 Maven 插件的核心文件，用于简化 JavaAgent 的注入过程。

3. 项目的配置文件介绍

TestableMock 的配置主要通过 Maven 或 Gradle 的构建文件进行。以下是主要的配置文件：

• pom.xml：在 Maven 项目中，你需要在 pom.xml 文件中添加 TestableMock 的依赖和插件配置。

示例配置：

<dependencies>
    <dependency>
        <groupId>com.alibaba.testable</groupId>
        <artifactId>testable-all</artifactId>
        <version>最新版本</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>com.alibaba.testable</groupId>
            <artifactId>testable-maven-plugin</artifactId>
            <version>最新版本</version>
            <executions>
                <execution>
                    <goals>
                        <goal>prepare</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

通过以上配置，你可以在 Maven 项目中集成 TestableMock，并使用其提供的 Mock 功能进行单元测试。