如何下载规范的 SQLite 源代码

、简介

大多数程序员使用合并将 SQLite 编译到他们的应用程序中合并是 C 代码但不是“源代码”。合并是由脚本从源代码生成的

本文档描述了如何获取 SQLite 的规范源代码——构建合并的原始源文件。有关在获得规范源代码后如何处理的更多信息,请参阅如何编译 SQLite页面。

2.直接下载

SQLite 源代码官方发布的快照通常可以直接从SQLite 网站的下载页面获得。即使下载页面上没有列出所需的特定版本,命名约定也相当明确,因此程序员通常可以猜出历史版本的名称并以此方式下载。

3.直接从版本控制系统获取代码

对于 SQLite 的任何历史版本,可以从Fossil版本控制系统获取源代码树,或者下载特定版本的 tarball 或 ZIP 存档,或者通过克隆整个项目历史。

SQLite 源维护在三个地理位置分散的服务器上:

https://www.sqlite.org/src(达拉斯)
https://www2.sqlite.org/src(纽瓦克)
https://www3.sqlite.org/src(旧金山)

该文档保存在这些相同服务器上的单独源存储库中:

https://www.sqlite.org/docsrc(达拉斯)
https://www2.sqlite.org/docsrc(纽瓦克)
https://www3.sqlite.org/docsrc(旧金山)

要下载特定的历史版本,首先通过访问其中一个服务器上的时间线页面找到所需的特定版本(例如:https ://www.sqlite.org/src/timeline )。如果您知道要下载的版本的大致日期,则可以向“时间线”URL 添加“c=YYYY-MM-DD”等查询参数,以查看以该日期为中心的时间线。例如,要查看 2013 年 8 月 26 日左右发生的所有签到,请访问 https://www.sqlite.org/src/timeline?c=2013-08-26如果您正在寻找正式版本,请访问 年表页面,单击您要查找的版本左侧的日期,这将立即带您到与该版本对应的登记处。

找到特定版本后,单击该版本的超链接以查看“签入信息页面”。然后单击“Tarball”链接或“ZIP archive”链接下载完整的源代码树。

4.克隆完整的发展史

要克隆 SQLite 的整个历史,请首先访问 https://www.fossil-scm.org/download.html页面并获取 Fossil 版本控制程序的预编译二进制文件。或者在同一页面上获取源代码并自行编译。

自 2017 年 3 月 12 日起,您必须使用 Fossil 2.0 或更高版本才能使以下说明生效。SQLite 存储库在该日期开始使用使用 SHA3 哈希而不是 SHA1 哈希命名的工件,并且需要 Fossil 2.0 或更高版本才能理解新的 SHA3 哈希。要了解您正在运行的 Fossil 版本,请键入“fossil -v”。

Fossil 是一个完全独立的程序,因此只需将“fossil”或“fossil.exe”可执行文件放在 $PATH 或 %PATH% 中的某个位置即可安装它。安装 Fossil 后,执行以下操作:

fossil clone https://www.sqlite.org/src sqlite.fossil

上面的命令会将 SQLite 的完整开发历史复制到您计算机上的“sqlite.fossil”文件中。制作此副本大约需要一分钟,并使用大约 32 兆字节的传输。制作副本后,通过键入以下内容“打开”存储库:

fossil open sqlite.fossil

第二个命令会将 SQLite 源代码树中的最新签入“签出”到您的当前目录中。随后,您可以通过键入以下内容轻松切换到不同的版本:

fossil update VERSION

其中 VERSION 可以是分支名称(如“trunk”或“session”)以获取特定分支的最新签入,或者 VERSION 可以是特定签入的 SHA1 哈希或 SHA1 哈希的前缀,或 VERSION 可以是诸如“version-3.8.8”之类的标签。每次运行“fossil update”时,它都会自动连接到位于 https://www.sqlite.org/src 的原始存储库,以获取自上次更新以来其他人可能已进行的新签入。