/
BUILDING.txt
45 lines (27 loc) · 1.21 KB
/
BUILDING.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
Building Log4j 2
To build Log4j 2, you need a JDK implementation version 1.7 or greater, and Apache Maven.
Note that building the site requires Maven 3.0.5, while everything else works
fine with any version of Maven 3.
To perform the license release audit, a.k.a. "RAT check", run.
mvn apache-rat:check
To perform a Clirr check on the API modules, run
mvn clirr:check -pl log4j-api
mvn clirr:check -pl log4j-1.2-api
To build the site with Java 7, make sure you give Maven enough memory using
MAVEN_OPTS with options appropriate for your JVM. Alternatively, you can
build with Java 8 and not deal with MAVEN_OPTS.
To build the site, from a command line, run:
mvn clean install
mvn site
On Windows, use a local staging directory, for example:
mvn site:stage-deploy -DstagingSiteURL=file:///%HOME%/log4j
On UNIX, use a local staging directory, for example:
mvn site:stage-deploy -DstagingSiteURL=file:///$HOME/log4j
To test, run:
mvn test
Then, to test OSGi, you must first create the jars:
mvn install -DskipTests
mvn package -DskipTests
Next, you can run the tests as usual, which will pick up the jar files to use as OSGi bundles from the various target
directories:
mvn test