生成和安装 Log4j

以下信息适用于想要修改 Log4j 或为 Log4j 做出贡献的开发人员。如果您的目标是将日志记录添加到应用程序中,而无需使用源代码进行构建,则可以download预先构建的二进制文件。

Log4j 2 托管在 Apache Software Foundation 的 Git 存储库中。有关获取最新源代码的详细信息,请参见Log4j 源存储库。您可以按照Log4j Downloads的说明下载最新版本的源代码。

Log4j 2.x 使用 Maven 3 作为其构建工具。 Log4j 2.x 除了在路径中安装的 Java 版本外,还使用 Java 9 编译器。这是通过使用 Maven 的工具链支持来完成的。 Log4j 2 在根文件夹中提供了示例工具链 XML 文件。可以通过修改它并将其作为 Toolchains.xml 安装到.m2 文件夹中来使用,或在调用 Maven 时使用以下命令来使用它。

[Macintosh] -t ./toolchains-sample-mac.xml 
[Windows] -t ./toolchains-sample-win.xml 
[Linux] -t ./toolchains-sample-linux.xml

要在本地 Maven 缓存中从父项目目录并使用 Java 7 或 8 构建并安装 Log4j,请运行:mvn install

请注意,如果/ etc/hosts 文件不包含计算机主机名的条目,则由于 DNS 查找将主机名转换为InetAddress::getLocalHost的 IP 地址,许多单元测试可能会执行缓慢。为了解决这个问题,您可以执行以下操作:

printf '127.0.0.1 %s\n::1 %s\n' `hostname` `hostname` | sudo tee -a /etc/hosts

然后,要构建完整站点,必须使用本地暂存目录:

mvn site
[Windows] mvn site:stage-deploy -DstagingSiteURL=file:///%HOME%/log4j
[Unix] mvn site:stage-deploy -DstagingSiteURL=file:///$HOME/log4j

要仅重建更改并执行测试,请运行:mvn test

要从头开始重建,请添加“ clean”,例如:mvn clean test

Releasing Log4j

请参阅 Wiki Log4j2ReleaseGuide