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
Run ./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
or
make build.backend
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
or
make build.ui
You can build docker images of backend
and ui
with 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=true
to compile project and generate source codes. The reason is that we use gRPC and protobuf.grpc-java
and java
folders in apm-protocol/apm-network/target/generated-sources/protobufgrpc-java
and java
folders in oap-server/server-core/target/generated-sources/protobufgrpc-java
and java
folders in oap-server/server-receiver-plugin/receiver-proto/target/generated-sources/fbsgrpc-java
and java
folders in oap-server/server-receiver-plugin/receiver-proto/target/generated-sources/protobufgrpc-java
and java
folders in oap-server/exporter/target/generated-sources/protobufgrpc-java
and java
folders in oap-server/server-configuration/grpc-configuration-sync/target/generated-sources/protobufgrpc-java
and java
folders in oap-server/server-alarm-plugin/target/generated-sources/protobufantlr4
folder in oap-server/oal-grammar/target/generated-sources