树洞

靡不有初,鲜克有终

走向开源之路

首先你需要:

  1. 畅通的网络环境;
  2. 一个Github账号;
  3. 本机安装Git软件;
  4. Don’t panic !

Fork 项目

首先,在Github仓库Fork他人项目。然后复制自己仓库的项目地址(HTTP或SSH都可),在本地Clone下来。

如果项目文件体积大,可使用如下方式:

  1. (推荐)在浏览器上安装Github加速插件,使用其中的镜像地址; Clone完代码,建议执行git remote set-url origin 自己的Github项目地址
  2. (推荐)在gitee.com网站,导入Github项目,使用gitee的项目地址进行Clone; Clone完代码,建议执行git remote set-url origin 自己的Github项目地址
  3. 使用命令 git clone --depth=1 进行Clone最新一次的提交代码,之后使用git pull --unshallow

同步项目代码

  1. 添加上游项目地址: git remote add upstream 原始项目地址 查看远程地址: git remote -v 查看远程分支: git branch -r
  2. 拉取最新代码: git fetch upstream
  3. 合并最新代码: 本地代码无修改git rebase upstream/master 本地代码有修改git merge upstream/master
  4. 将最新代码上传到自己的远程仓库: git push

构建项目(使用Maven)

确保编译版本和项目建议版本相一致。

执行命令mvn clean install ,或命令mvn clean install -Dmaven.test.skip=true -Dmaven.javadoc.skip=true -Drat.skip=true -Dcheckstyle.skip=true -e 跳过测试等过程。

如果某个模块构建失败,多次执行mvn install 即可。

参考链接:

Soul 之 PR 提交流程 · 语雀

如何从小白成长为 Apache Committer?