This document will help you compile and build a project in your maven and set your IDE.
Since we are using Git submodule, we do not recommend using the
GitHub tag or release page to download source codes for compiling.
If you need to execute build behind the proxy, edit the .mvn/jvm.config and set the follow properties:
-Dhttp.proxyHost=proxy_ip -Dhttp.proxyPort=proxy_port -Dhttps.proxyHost=proxy_ip -Dhttps.proxyPort=proxy_port -Dhttp.proxyUser=username -Dhttp.proxyPassword=password
Prepare git, JDK8+, and Maven 3.6+.
Clone the project.
If you want to build a release from source codes, set a
tag name by using
git clone -b [tag_name] ... while cloning.
git clone --recurse-submodules https://github.com/apache/skywalking.git cd skywalking/ OR git clone https://github.com/apache/skywalking.git cd skywalking/ git submodule init git submodule update
./mvnw clean package -Dmaven.test.skip
All packages are in
/dist (.tar.gz for Linux and .zip for Windows).
Apache source code release?
For each official Apache release, there is a complete and independent source code tar, which includes all source codes. You could download it from SkyWalking Apache download page. There is no requirement related to git when compiling this. Just follow these steps.
./mvnw clean package -Dmaven.test.skip.
/dist.(.tar.gz for Linux and .zip for Windows).
SkyWalking is a complex maven project that has many modules. Therefore, the time to compile may be a bit longer than usual. If you just want to recompile part of the project, you have the following options:
./mvnw package -Pbackend,dist
If you intend to compile a single plugin, such as one in the dev stage, you could
cd plugin_module_dir & mvn clean package
./mvnw package -Pui,dist
You can build docker images of
Makefile located in root folder.
Refer to Build docker image for more details.
NOTE: If you clone the codes from GitHub, please make sure that you have finished steps 1 to 3 in section Build from GitHub. If you download the source codes from the official website of SkyWalking, please make sure that you have followed the steps in section Build from Apache source code release.
./mvnw compile -Dmaven.test.skip=trueto compile project and generate source codes. The reason is that we use gRPC and protobuf.
javafolders in apm-protocol/apm-network/target/generated-sources/protobuf
javafolders in oap-server/server-core/target/generated-sources/protobuf
javafolders in oap-server/server-receiver-plugin/receiver-proto/target/generated-sources/fbs
javafolders in oap-server/server-receiver-plugin/receiver-proto/target/generated-sources/protobuf
javafolders in oap-server/exporter/target/generated-sources/protobuf
javafolders in oap-server/server-configuration/grpc-configuration-sync/target/generated-sources/protobuf
javafolders in oap-server/server-alarm-plugin/target/generated-sources/protobuf
antlr4folder in oap-server/oal-grammar/target/generated-sources