查看Gerrit使用说明的源代码

==说明==

:本文介绍如何向 SylixOS 开源项目贡献源码，步骤如下：

:*1. 获取 gerrit 用户名和密码。发送邮件给 zthsoft@zthsoft.com 提交申请，或通过其它方式联系作者获取。

:*2. 安装 git 工具，在 windows 下执行，安装的 git 工具为 msgit。

:*3. 打开 git bash，输入命令“ssh-keygen -t rsa”，如下：
 Administrator@TECH-TIGER /D/sylixos/gitserver
 $ ssh-keygen -t rsa
 Generating public/private rsa key pair.
 Enter file in which to save the key (/c/Users/Administrator/.ssh/id_rsa): test
 Enter passphrase (empty for no passphrase):
 Enter same passphrase again:
 Your identification has been saved in test.
 Your public key has been saved in test.pub.
 The key fingerprint is:
 68:1d:b8:ea:ad:06:1f:10:e3:2c:64:c2:c4:a4:01:c8 Administrator@TECH-TIGER

:命令执行过程中会提示用户输入要生成的 rsa 密钥文件名，这里输入 test，命令完成后在当前目录生成 rsa 密钥对文件，包含一个公钥文件 test 和一个私钥文件 test.pub。

:*4. 使用第一步获取的用户名和密码登录 gerrit.sylixos.com，点击页面右上角的用户名，选择 setting 和设置用户相关信息。

:*5. 大部分设置都可以忽略，但必须添加公钥文件。选择“SSH Public Keys”选项页，使用记事本打开第3步生成的 test.pub 文件，全选并复制粘贴到“SSH Public Key”对话框，点击“Add”按钮完成公钥添加。

[[文件:添加rsa公钥.png]]

:*6. 将私钥文件拷贝到用户目录下的 /.ssh 目录，并更名为 id_rsa。

:*7. 检出工程。登录 gerrit.sylixos.com，点击 Project->List 列出所有工程，打开需要检出的工程。这里选择的 demo 工程，选择“clone with commit-msg hook”选项卡，复制 git 命令。如下图：

[[文件:Gerrit检出.png]]

:*8. 在 git bash 中粘贴复制的 git 命令，回车完成检出。

:*9. 提交修改，首先使用“git commit”命令 commit 更改到本地，然后使用“git push origin master:refs/for/master”命令将 push 更改到远程的 refs/for/master 分支，这是 gerrit 的要求，不能直接 push 到 master 分支。

:*10. push 完成后登录 gerrit.sylixos.com，会在 My->Changes 页面下看到本次 push 请求，处于等待代码 review 状态，当代码 review 通过后，代码提交人可在 gerrit 页面中将更改提交到 master 分支。

:（注：关于gerrit 的原理和更为详细的使用方法，可在网上搜索得到，下面列出一些参考网页）

:[http://www.worldhello.net/2010/11/10/2059.html gerrit原理简介]

:[http://www.cnblogs.com/hyb1/archive/2013/04/25/3041989.html gerrit使用简介]