贡献代码

<<nowiki>>
<<style class="redbox centered">>
**MariaDB 的源代码现在托管在 Github 上：https://github.com/MariaDB/server。请参阅[[using-git|使用 Git]]。下面的信息已过时，将在某个时候进行重写。**
<</style>>

== 先决条件

您需要[[http://bazaar-vcs.org|Bazaar]]进行版本控制。

= = = bzr 登录设置

* 在 https://launchpad.net/+login 上获取 launchpad 帐户。
* 登录后，设置您的 SSH 密钥
** 点击您的名称（右上角）
** 点击“更改详细信息”链接（右上方）
** 点击 SSH 密钥按钮（页面中央）
** 上传您的公共 SSH 密钥
([[https://help.launchpad.net/YourAccount/CreatingAnSSHKeyPair|如何获得公共密钥？]])
* 从本地命令行向 launchpad 注册自己：<<fixed>>bzr launchpad-login [yourloginid]<</fixed>>

=== 获取 MariaDB 代码

# 首先，[[getting-the-mariadb-source-code|获取 MariaDB 代码的干净副本]]
（对于某些人来说，最快的方法是按照“源树 Tarball”部分中的说明进行操作）。

#decimal.2 获取源代码的干净副本后，为您的更改创建工作副本：
<<code lang=sh inline=false indent=1>>
cd $maria-repo # 例如：~/repos/maria
bzr branch trunk maria-fix-bugNNNNNN
cd maria-fix-bugNNNNNN
<</code>>

<<style class="bluebox">>
**提示：**//使用描述性名称，例如 maria-fix-bugNNNNNN（其中 NNNNNN 当然是错误编号）。//
<</style>>

#decimal.3 现在，您应该准备好[[generic-build-instructions|编译 MariaDB]]了。在进行任何更改之前，编译此阶段是一个好主意，以确认您要修改的源代码树是否有效。

以下页面将帮助您快速上手 MariaDB 源代码：

* [[getting-the-mariadb-source-code|获取 MariaDB 源代码]]
* 设置构建环境：
** [[build-environment-setup-for-linux|Linux]]
** [[build-environment-setup-for-mac|Mac]]
** [[building-mariadb-on-windows|Windows]]
* [[compiling-mariadb-from-source|构建 MariaDB]]

== 设置测试

Maria 测试套件包含在源代码树的<<code>>./mysql-test/<</code>>子目录中。mysql-test 目录有两个子目录对您至关重要，即<<code>>t/<</code>>目录和<<code>>r/<</code>>目录（分别用于“测试”和“结果”）。确保检查并查看您的 bug 是否已有测试。

所有测试都在<<code>>t/<</code>>目录中。打开与您正在更改的功能相对应的文件（或添加新文件），并添加将重现 bug 或验证新功能的命令。

例如，下面的测试创建了一个新的测试表“t1”；显示了该 CREATE TABLE 语句的结果；最后，我们通过删除测试表来清理测试：

<<sql>>
#
# Bug #XXXXXX: INET_ATON() returns signed, not unsigned
#
create table t1 select INET_ATON('255.255.0.1') as `a`;
show create table t1;
drop table t1;
<</sql>>

先添加测试，这将提醒您稍后重新记录测试输出文件（当然还会通知未来的努力您的预期输出）。现在是时候进行更改了。

查看现有的测试以更好地了解如何编写您的测试。

我们一直在寻找更好的测试，因此如果您创建了新的测试或改进了现有的测试，请将其上传到我们的“私人”文件夹中[[FTP]]服务器，然后在[[IRC]]上联系我们或发送一封邮件到Maria-Developers邮件列表，让我们知道。

== 编辑并添加您的贡献

有了可用的版本，您可以开始在新分支中进行更改，定期将代码提交到本地工作副本；随时提交早期和频繁的提交，因为您将稍后使用推送和提议来正式化您的贡献。

<<code lang=sh>>
cd $maria-repo/maria-fix-bugNNNNNN
# 进行更改
bzr commit -m "合并注释"
<</code>>

在发布完成的工作之前，您需要确认您的分支按预期工作并更新测试运行。

为了让其他人看到您的提交，您应该配置[[setting-up-and-using-bazaar-bzr-with-mariadb|bzr]]将其提交电子邮件发送到[[http://lists.askmonty.org/cgi-bin/mailman/listinfo/commits|commits 'at' mariadb 'dot' org]]电子邮件列表。

== 测试您的分支

确保您至少拥有libtool 1.5.22（[[http://www.gnu.org/software/libiconv/|在此找到]]）。

首先，检查所有测试是否都通过（还记得您之前设置的测试吗？它应该失败。没关系，您很快就会重新记录它）：

<<code lang=sh>>
cd $maria-repo/mysql-test
./mysql-test-run
<</code>>

任何失败的测试都需要重新记录。

<<code lang=sh>>
cd $maria-repo/mysql-test
./mysql-test-run --record $test # 其中$test是失败的测试名称
<</code>>

现在，您已经准备好合并到主干了。

== 合并最近的更改

在推送或发布之前，合并从主干到您的分支的任何更改都很重要。

更新本地主干。

<<code lang=sh>>
cd $maria-repo 
cd trunk
bzr pull   
<</code>>

更新本地分支。

<<code lang=sh>>
cd $maria-repo
cd maria-fix-bugNNNNNN
bzr merge ../trunk
bzr commit -m "从主干合并"
<</code>>

冲突可以通过bazaar解决：

<<code lang=sh>>
bzr resolve $filename
<</code>>

要恢复到分支上的最后一次提交，请使用：

<<code lang=sh>>
bzr revert $filename
<</code>>

（注意，在推送之前，您需要重新合并主干）

仔细验证差异

<<code lang=sh>>
bzr diff
<</code>>

== 发布您的分支

当所有更改都合并并且您的更改都是一致的时，您可以将分支推送到LaunchPad

<<code lang=sh inline=false>>
cd $maria-repos/$your-branch # 其中$your-branch是您要推送的分支（例如：maria-bugNNNN）
bzr push lp:~[yourloginid]/maria/$your-branch
<</code>>

如果您发现这需要很长时间（例如> 30分钟），则可以尝试使用'<<code>>bzr init-repo --format=1.9<</code>>'初始化一个新存储库并将您的工作合并到其中，然后再次推送。

== 如何提出合并请求

在您的Launchpad代码页面{{{https://code.launchpad.net/~{yourloginid}/maria/{branch-name} }}}上，单击“**建议将分支合并到另一个分支中**”链接，将分支建议给维护者合并到主干。

== 将您的代码放入MariaDB主树

MariaDB中的所有代码都来自以下来源之一：
* MySQL
* 由[[http://mariadb.org|MariaDB Foundation]]雇员开发的代码。
* 由[[http://mariadb.com|MariaDB Corporation]]雇员开发的代码。
* 在[[mca|MCA]]下与MariaDB Foundation共享的代码。
* 具有已知来源并在BSD或公共领域下的代码。

如果您希望代码成为主[[MariaDB]]树的一部分，您还需要向MariaDB Foundation提供您的代码的共享版权。这是必需的，以便基金会可以将代码提供给其他项目（如MySQL）。

您可以通过以下方式之一来完成此操作：

# 签署MariaDB贡献者协议（[[mca|MCA]]）并将其扫描并发送给基金会。
# 向[[http://launchpad.net/~maria-developers|maria-developers]]发送电子邮件，在其中说您的补丁及其所有修复均在[[mca|MCA]]下提供给MariaDB Foundation。
# 使用[[http://opensource.org/licenses/bsd-license.html|BSD许可证]]对您的代码进行许可。

我们需要共享版权的原因如下：
# 为了保护版权或GPL，如果有人侵犯它（这是自由软件基金会也要求其代码[[https://www.gnu.org/licenses/why-assign.html|分配版权]]的原因）
# 为了能够向MySQL捐赠代码（例如修复安全漏洞或新功能）
# 允许持有MySQL非免费许可证的公司也使用MariaDB（MCA / BSD允许我们向这些公司授予MySQL和MariaDB之间所有更改的权利，以便他们可以使用MariaDB而不是MySQL）

有关MCA的更多信息，请参见[[mca-faq|MCA FAQ]]页面。

== 修复分支（如果需要）

如果需要在您的分支上进行修复，则需要进行以下操作：进行更改，重新合并任何新更改到主干，提交和重新推送；您不需要重新提出。推送后，LaunchPad将自动捕获更改。

请注意，更改可能需要几分钟才能使LaunchPad将您的新更改合并到您的建议中。

== 如何重新提交建议

目前，这是一个棘手的过程，Launchpad上的“请求另一个审核”链接都不起作用。

要重新提交合并建议，请按照以下步骤操作：

# 在合并建议的主页面上，顶部一行将类似于“状态：需要审核”。在其右侧有一个小按钮；单击此按钮以更改状态。
# 从下拉菜单中选择“重新提交”，然后单击“更改状态”。
# 下一页应提示您重新提交合并建议并告知您新建议将取代旧建议
# 单击“重新提交”完成。

获取您的合并建议注意的几种简单方法是：

* 加入#maria [[IRC]]频道，请求人们审核/讨论您的合并。
* 订阅并向Launchpad上的[[http://launchpad.net/~maria-developers|maria-developers]]组发送电子邮件。
<</nowiki>>