维护SQLite的私有分支（二十六）

返回：SQLite—系列文章目录

上一篇：SQLite、MySQL 和 PostgreSQL 数据库速度比较（本文阐述时间很早比较，不具有最新参考性）（二十五）

下一篇：SQLite数据库中JSON 函数和运算符

1. 引言

SQLite旨在满足大多数开发人员的需求，而无需任何更改或自定义。当需要更改时，他们通常可以使用启动时（1）或运行时（2）（3）（4）配置方法完成或通过编译时选项。应用程序非常罕见开发人员需要编辑 SQLite 源代码才能将SQLite整合到产品中。

我们调用对保存的 SQLite 源代码的自定义修改对于单个应用程序的使用，一个“专用分支”。当私人分支变得必要，应用程序开发人员必须承担使私有分支与公共分支保持同步的任务 SQLite 源。这很乏味。它也可能很棘手，因为虽然 SQLite文件格式和发布的接口非常稳定， SQLite的内部实现变化非常快。数百或对于任何给定的 SQLite 点版本，数千行代码可能会发生变化。

本文概述了保留私有分支的一种可能方法与公共 SQLite 源代码同步的 SQLite。当然，维护私有分支的方法有很多种。没有人被迫使用这里描述的方法。本文无意将特定程序强加于人私有分支的维护者。本文的重点是提供维护专用分支的一个过程的示例，该过程可以用作设计最适合的流程的模板每个项目的情况。

2. 基本理念

我们建议使用化石软件配置管理系统来建立两个分支。一个分支（“公共分支”或“主干”）包含已发布的 SQLite 源，另一个分支是包含为项目自定义的代码的专用分支。每当 SQLite 发布新的公开版本时，该版本都会添加到公共分支，然后将更改合并到专用分支中。

本文件建议使用化石，但任何其他分布式软件配置管理系统，如 Monotone 或 Mercurial（又名“HG”）或 Git 也可以起到同样的作用。概念是一样的，尽管程序的具体细节会有所不同。

右图说明了这个概念。一个从标准的SQLite版本开始。对于举例来说，假设一个人打算创建一个 SQLite 版本 3.6.15 的私有分支。在图示：这是版本（1）。这维护者制作基线的精确副本 SQLite 进入分支空间，显示为版本（2）。请注意，（1）和（2）完全相同。然后维护者将私有更改应用于版本（2）导致版本（3）。换言之，版本（3）是 SQLite 版本 3.6.15 加上编辑。

稍后，SQLite 版本 3.6.16 发布，如下所示图中的圆圈（4）。在这一点上，私人分支维护者执行合并，该合并将所有从（1）到（4）的更改，并将这些更改应用于（3）.结果是版本（5），即SQLite 3.6.16 加上编辑。

可能存在合并冲突。换句话说，它可能从（2）到（3）的更改与从（1）更改为（4）。在这种情况下，维护者将必须手动解决冲突。希望冲突不会经常出现。冲突不太可能发生当私有编辑保持在最低限度时发生。

上面的循环可以重复很多次。这图显示了第三个 SQLite 版本，3.6.17 英寸圆圈（6）。私有分支维护者可以做另一个合并以合并更改从（4）移动到（6）进入专用分支，导致在版本（7）中。

3. 程序

本文档的其余部分将引导读者完成维护专用分支所需的步骤。总体思路与上述相同。本节仅提供更多内容细节。

我们再次强调，这些步骤并不是唯一的维护专用分支的可接受方法。这种方法是众多之一。使用本文档作为准备的基线特定于项目的程序。不要害怕尝试。

3.1. 获取软件

Fossil 是一个计算机程序在使用之前，必须将其安装在您的计算机上。幸运的是，安装化石非常容易。化石是单一的 “*.exe”文件，您只需下载并运行。要卸载化石，只需删除 EXE 文件即可。安装和入门的详细说明化石可在化石网站上找到。

3.2. 创建项目仓库

创建一个化石存储库来托管专用分支以下命令：

fossil new private-project.fossil

你可以用任何你喜欢的名字来称呼你的项目。“.fossil” 后缀是可选的。对于本文档，我们将继续调用项目“private-project.fossil”。请注意，private-project.fossil 是一个普通的磁盘文件（实际上是一个 SQLite 数据库），它将包含完整的项目历史记录。您只需复制项目即可备份项目一个文件。

如果要配置新项目，请键入：

fossil ui private-project.fossil

“ui”命令将导致 fossil 运行一个微型内置 Web 服务器并启动您的网络浏览器指向在该 Web 服务器上。您可以使用 Web 浏览器来配置您的项目以各种方式。有关其他信息，请参阅化石网站上的说明信息。

创建项目存储库后，创建一个打开的检出项目，通过移动到要保留所有项目源代码和键入：

fossil open private-project.fossil

如果需要，可以对同一项目进行多次签出。您可以将存储库“克隆”到不同的机器上，以便多个开发人员可以使用它。有关更多信息，请参阅化石网站。

3.3. 在 Fossil 中安装 SQLite 基线

在上一步中创建的存储库最初是空的。这下一步是加载基线 SQLite 版本 - 图中的圆圈（1）以上。

首先获取您使用的任何形式的 SQLite 副本。您获得的公共 SQLite 应该与您的私人编辑尽可能接近尽可能复制。如果您的项目使用 SQLite 合并，则获取合并的副本。如果使用预处理的源文件，请改为获取这些文件。将所有源文件放在在上一步中创建的签出目录。

公共 SQLite 版本中的源代码使用 unix 行结尾（ASCII 代码 10：仅限“换行符”，NL）和空格而不是制表符。如果你愿意将行尾更改为 Windows 样式的行尾（ASCII 代码 13、10：“回车”和“换行符”;CR-NL）或者如果你会将空格缩进更改为制表符缩进，请在签入基线之前立即进行更改。合并过程将仅起作用好吧，如果公共分支和私人分支之间的差异是极小。如果源文件的每一行都更改了 private branch，因为您从 NL 更改为 CR-NL 行结尾，然后合并步骤将无法正常工作。

假设您使用的是合并源代码。将基线添加到项目，如下所示：

fossil add sqlite3.c sqlite3.h

如果使用单独的源文件，请改为命名所有源文件仅两个合并源文件。完成此操作后，提交您的更改如下：

fossil commit

系统将提示您输入签到评论。想说什么就说什么。提交完成后，您的基线将成为存储库的一部分。如果您愿意，可以使用以下命令在“时间轴”上查看此内容：

fossil ui

最后一个命令与我们之前运行的“ui”命令相同。它启动正在运行的迷你 Web 服务器，并将 Web 浏览器指向它。但这次我们不必指定存储库文件，因为我们是位于结帐内，因此 Fossil 可以找出本身。如果要键入存储库文件名作为第二个参数，你可以。但这是可选的。

如果您不想使用 Web 浏览器查看新的签到，您可以使用以下命令从命令行获取一些信息这些：

fossil timeline
fossil info
fossil status

3.4. 创建私有分支

上一步在上图中创建了圆圈（1）。此步骤将创建圆圈（2）。运行以下命令：

fossil branch new private trunk -bgcolor "#add8e8"

此命令将创建一个名为“private”的新分支（您可以使用如果您愿意，可以使用不同的名称）并为其分配背景颜色浅蓝色（“#add8e8”）。如果需要，可以省略背景颜色，尽管拥有独特的背景确实更容易分辨时间轴上显示的“主干”（公共分支）的分支。你可以更改专用分支或公共的背景颜色分支（“主干”），如果您愿意，可以使用 Web 界面。

上面的命令创建了新分支。但您的结帐是仍然在主干上 - 您可以通过运行命令看到这一事实：

fossil info

要将您的退房更改为私人分行，请键入：

fossil update private

您可以再次运行“info”命令以验证您是否在私有分支。若要返回到公共分支，请键入：

fossil update trunk

通常，fossil 会在切换时修改您结帐时的所有文件在私人和公共分支之间。但是在这一点上，文件在两个分支中是相同的，因此无需进行任何修改。

3.5. 向私有分支中的代码添加自定义项

现在是时候对SQLite进行私有的自定义修改了这是本练习的重点。切换到专用分支（如果您还没有）使用“Fossil Update Private” 命令，然后在文本编辑器中调出源文件并制作无论您想进行什么更改。一旦你完成制作更改，请使用以下命令提交这些更改：

fossil commit

系统将再次提示您输入一个提交，描述您的变化。然后将发生提交。提交将创建一个新的签入在与上图中的圆圈（3）相对应的存储库中。

现在公共分支和专用分支不同，您可以运行 “Fossil Update Trunk”和“Fossil Update Private” 命令，并看到 Fossil 确实更改了结帐中的文件当您在分支之间来回切换时。

请注意，在上图中，我们将私有编辑显示为单个犯。这只是为了清晰地呈现。没有什么可以阻止的你从做几十个或几百个单独的微小的改变和承诺每个都单独。事实上，进行许多小的改变是首选的方式工作。在一次提交中执行所有更改的唯一原因是它使图表更容易绘制。

3.6. 合并新的公共 SQLite 版本

假设一段时间后（通常大约一个月）一个新版本的 SQLite 发布：3.6.16。您将希望合并这个新的 SQLite 的公共版本进入公共分支中的存储库（树干）。为此，请先将存储库更改为主干：

fossil update trunk

然后下载新版本的 SQLite 源并覆盖签出中的文件。

如果将 NL 更改为 CR-NL，则更改行尾或制表符空格缩进更改原始基线，进行相同的更改添加到新的源文件。

一切准备就绪后，运行“fossil commit”命令以签入更改。这将在上图中创建圆圈（4）。

3.7. 将公共 SQLite 更新合并到私有分支中

下一步是将公共分支中的更改移动到私有分支。换句话说，我们想在上图。首先，使用 “化石更新私人”。然后键入以下命令：

fossil merge trunk

“merge”命令尝试应用将（1）和（4）圈到本地结帐中的文件。请注意，圆圈（5）尚未创建。您需要运行 “提交”创建圆圈（5）。

可能是合并中存在冲突。冲突当同一行代码以不同的方式更改时发生圆圈（1）和（4）与圆圈（2）和（3）。merge 命令将宣布任何冲突，并将包括冲突的两个版本输出中的行。您将需要调出包含以下内容的文件冲突并手动解决冲突。

解决冲突后，很多用户喜欢编译和测试新版本，然后再提交到存储库。或者你可以提交先测试，后测试。无论哪种方式，都运行“化石提交” 签入圆圈（5）版本的命令。

3.8. 进一步更新

随着新版本的 SQLite 发布，重复步骤 3.6 和 3.7 到将新版本中的更改添加到专用分支。其他私有更改可以是如果需要，在两次发布之间的私有分支上制作。

4. 变化

由于本文档首次编写，规范的 SQLite 源代码已从古老的 CVS 系统移至 SQLite: Documentation 的 Fossil 存储库。这意味着，如果您正在使用规范的 SQLite 源代码（与合并源代码相反）文件，sqlite3.c 和 sqlite3.h），然后您可以创建私有存储库只需克隆官方存储库：

fossil clone https://www.sqlite.org/src private-project.fossil

此命令既会创建新存储库，又会填充所有最新的SQLite代码。然后，您可以创建专用分支，作为在第 3.4 节中描述。

通过克隆创建私有存储库时，合并新的公共SQLite版本也变得容易得多。要拉入所有来自公共 SQLite 存储库的最新更改，只需移动到打开结账并执行以下操作：

fossil update

然后继续将“trunk”中的更改与“private”合并第 3.7 节中所述的更改。