tristaZero commented on a change in pull request #11997: URL: https://github.com/apache/shardingsphere/pull/11997#discussion_r695560214
########## File path: docs/community/content/contribute/establish-project.cn.md ########## @@ -0,0 +1,141 @@ ++++ +title = "搭建项目及环境指南" +weight = 2 +chapter = true ++++ + + +# 本地构建 ShardingSphere 软件环境及获取最新安装包 + + + +## 软件环境 + + + +| **软件** | **JDK** | **Maven** | **Idea** | +| :--: | :--: |:--: | :--: | +| **版本** | >=1.8 | >=3.6.0 | 最新版本即可 | + + + +## 安装步骤（ Mac 为例） + + + +## 1.JDK 安装 + + + +- 下方链接获取适合自己环境的安装包（ mac 选取 .dmg 格式） + + https://www.oracle.com/java + +  + +- 下载完成后直接安装即可 +## 2.Maven 环境部署 + + + +- 下方链接获取适合自己环境的安装包（本文选 tar 包） + + https://maven.apache.org/download.cgi + +  + +- 下载后解压即可 +## 3.设置环境变量 + + + +```shell +vim ~/.zprofile +``` + + + +- 在下方添加环境变量： + +```shell +#jdk环境通过 .dmg 方式安装后默认为下方路径 +JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Home +#假设解压路径为/Users/hanmeimei/apache-maven-3.8.1 +MAVEN_HOME=/Users/hanmeimei/apache-maven-3.8.1 + + +PATH=$JAVA_HOME/bin:$PATH:. +PATH=$MAVEN_HOME/bin:$PATH:. + +CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:. + +export JAVA_HOME +export MAVEN_HOME +export PATH +export CLASSPATH +``` + + + +```shell +source ~/.zprofile +``` + +## 4.Idea 下载安装 + + + +- 下方链接获取适合自己环境的安装包 + + https://www.jetbrains.com/idea/download/#section=mac +- 下载后直接安装 + +## 5.Idea clone 代码 + + + +- 进入 Idea +- 工具栏-->Git-->Clone-->Url(https://github.com/apache/shardingsphere.git) + +  +- 等待结束就有刚刚克隆的最新的代码了 + +## 6.项目编译 + + + +```shell +#假设项目路径为 /Users/hanmeimei/IdeaProjects/shardingsphere/ + +cd /Users/hanmeimei/IdeaProjects/shardingsphere/ +``` + + + +### 编译环境 + +```shell +mvn -Dmaven.javadoc.skip=true -Djacoco.skip=true -DskipITs -DskipTests clean install +``` + + + +### 获取最新的项目 + +```shell +mvn -Dmaven.javadoc.skip=true -Djacoco.skip=true -DskipITs -DskipTests clean install -Prelease + +#进入下方目录位置 +cd /Users/hanmeimei/shardingsphere/shardingsphere/shardingsphere-distribution/shardingsphere-proxy-distribution/target + +#即可看到打包好最新的软件 +apache-shardingsphere-5.0.0-RC1-SNAPSHOT-shardingsphere-proxy-bin.tar.gz +``` + + + +## 结语 + +完成以上操作后，您已经有了 ShardingSphere 的软件环境，可以根据下方《贡献者指南》 参与到 ShardingSphere 的社区建设 + +https://shardingsphere.apache.org/community/cn/contribute/contributor/ Review comment: It is supposed to be a md link, i.e, [《贡献者指南》](https://shardingsphere.apache.org/community/cn/contribute/contributor/) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
