Development
page (#2520, #2551)
You can build and verify the sources as follows:
./mvnw verify
verify
goal runs validation and test steps next to building (i.e., compiling) the sources.
To speed up the build, you can skip verification:
./mvnw -DskipTests package
If you want to install generated artifacts to your local Maven repository, replace above verify
and/or package
goals with install
.
Note that if your /etc/hosts
file does not include an entry for your computer’s hostname, then many unit tests may execute slow due to DNS lookups to translate your hostname to an IP address in InetAddress.getLocalHost()
.
To remedy this, you can execute the following:
printf '127.0.0.1 %s\n::1 %s\n' `hostname` `hostname` | sudo tee -a /etc/hosts
You can run tests using the target JRE (i.e., JRE 8) as follows:
Maven Toolchains is used to employ additional JDKs required for tests.
You either need to have a user-level configuration in ~/.m2/toolchains.xml
or explicitly provide one to the Maven: ./mvnw --global-toolchains /path/to/toolchains.xml
.
toolchains.xml
containing a JDK 8 toolchain<?xml version="1.0" encoding="UTF8"?>
<toolchains>
<toolchain>
<type>jdk</type>
<provides>
<version>1.8.0_372</version>
</provides>
<configuration>
<jdkHome>/usr/lib/jvm/java-8-openjdk-amd64</jdkHome>
</configuration>
</toolchain>
</toolchains>
Run Maven tests with the java8-tests
profile:
./mvnw verify -Pjava8-tests,!java8-incompat-fixes
You can build the website as follows:
./mvnw compile # (1)
./mvnw site # (2)
Generate plugin descriptors that will be used to generate the plugin reference page.
Descriptors are placed under target/plugin-descriptors
.
Generate the website to target/site
You can view the generated website with a browser by pointing it to target/site
directory.
You can follow below steps for casual development needs:
Make sure you installed everything:
./mvnw install -DskipTests
After making a change to, say, log4j-core
, install your changes:
./mvnw install -pl :log4j-core -DskipTests
Run all tests associated with log4j-core
:
./mvnw test -pl :log4j-core-test
Run a particular test:
./mvnw test -pl :log4j-core-test -Dtest=FooBarTest
Make sure all build checks (Spotless, Spotbugs, BND, RAT, etc.) succeed:
./mvnw verify -DskipTests -pl :log4j-core,:log4j-core-test
Tip
|
You can connect your IDE to a
|
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。