ProGuard Maven Plugin 使用指南

一、项目目录结构及介绍

ProGuard Maven Plugin 的仓库基于 GitHub 提供，其典型的目录结构如下：

proguard-maven-plugin/
├── pom.xml                    <- 插件的核心配置文件
├── src/
│   ├── main/                  <- 源代码和资源文件
│   │   └── java/              <- 插件实现的Java源码
│   └── test/                 <- 测试代码
├── LICENSE                   <- 许可证文件
├── README.md                 <- 项目说明文档
└── ...                       <- 其他辅助或文档文件

• pom.xml 是Maven的核心配置文件，包含了插件本身的依赖、版本信息以及如何构建和发布这个插件。
• src/main/java 包含了插件的主要Java源码，实现了ProGuard整合到Maven生命周期的能力。
• src/test 部分通常用于存放测试该插件的案例，确保功能正确无误。

二、项目的启动文件介绍

对于ProGuard Maven Plugin而言，并没有直接的“启动文件”概念，它的使用集成在Maven构建生命周期中。主要通过在你的项目中的pom.xml添加此插件的引用及配置来“启动”其功能。例如，你需要在<build>标签下添加以下配置片段以启用插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <!-- 注意：以下是示例性配置，实际应指向正确的版本 -->
            <version>版本号</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <!-- ProGuard相关的配置将在这里 -->
                    </configuration>
                </execution>
            </executions>
        </plugin>
        <!-- 正确的引用应该是下面这样，上面是混淆与合并示例 -->
        <!--
        <plugin>
            <groupId>com.pyx4j</groupId>
            <artifactId>proguard-maven-plugin</artifactId>
            <version>版本号</version>
            <executions>
                ...
            </executions>
        </plugin>
        -->
    </plugins>
</build>

实际上，错误地提到了maven-shade-plugin作为示例启动过程的一部分，正确的是应该直接使用proguard-maven-plugin进行配置。请注意替换“版本号”为你实际想使用的版本。

三、项目的配置文件介绍

ProGuard Maven Plugin的配置主要位于你的项目的pom.xml文件内，通过指定执行目标和详细参数完成。一个基本的配置例子如下：

<configuration>
    <proguardConfig>proguard-project.txt</proguardConfig> <!-- 指定ProGuard配置文件路径 -->
    <libs>
        <lib>${java.home}/lib/rt.jar</lib> <!-- Java运行时库 -->
    </libs>
    <injar>your-app-jar-name.jar</injar> <!-- 输入jar文件名 -->
    <outjar>your-app-obf-jar-name.jar</outjar> <!-- 输出（混淆后）jar文件名 -->
</configuration>

这里的proguardConfig指定了外部ProGuard配置文件，通常用来定义保留哪些类、方法等规则，而libs部分定义了ProGuard处理时需要引用的库。injar和outjar分别指定了输入和输出的jar文件。

请根据实际情况调整上述配置，确保所有路径和文件名正确对应你的项目需求。