1. Введение

Большинство программистов собирает SQLite, используя объединение. Объединение это код на С, но это не "исходный код". Объединение произведено из исходного кода.

Этот документ описывает, как получить канонический исходный код для SQLite, исходные файлы, из которых строится объединение. Посмотрите здесь для получения дополнительной информации о том, что сделать с каноническим исходным кодом, как только это получено.

2. Прямая загрузка

Образы официальных выпусков исходного кода SQLite могут часто получаться непосредственно со страницы загрузки сайта SQLite. Даже если определенная желаемая версия не перечисляется на странице загрузки, соглашения о присвоении имен довольно четкие и таким образом, программисты могут часто предполагать название исторического выпуска и загружать его.

3. Получение кода непосредственно от системы управления версиями

Для любой исторической версии SQLite исходное дерево может быть получено из системы управления версиями Fossil , загрузкой tarball или архива ZIP для определенной версии или клонировав всю историю проекта.

Источники SQLite сохраняются на трех географически рассеянных серверах:

https://www.sqlite.org/src (Dallas)
https://www2.sqlite.org/src (Newark)
https://www3.sqlite.org/src (San Francisco)

Документация сохраняется в отдельных исходных хранилищах на тех же самых серверах:

https://www.sqlite.org/docsrc (Dallas)
https://www2.sqlite.org/docsrc (Newark)
https://www3.sqlite.org/docsrc (San Francisco)

Чтобы загрузить определенную историческую версию, сначала определите местонахождение определенной версии, желаемой, посетив страницу временной шкалы на одном из этих серверов (например: https://www.sqlite.org/src/timeline). Если вы знаете приблизительную дату версии, которую вы хотите загрузить, можно добавить параметр запроса как "c=YYYY-MM-DD" к "timeline" URL, чтобы видеть временную шкалу около той даты. Например, чтобы видеть все регистрации, которые произошли примерно 26 августа 2013, посетите https://www.sqlite.org/src/timeline?c=2013-08-26. Если вы ищете официальный выпуск, посетите страницу хронологии, щелкните на дату налево от выпуска, который вы ищете, и это немедленно приведет вас к регистрации, соответствующей выпуску.

Как только вы определяете местонахождение определенной версии, нажимаете на гиперссылку для той версии, чтобы видеть "Check-in Information Page". Тогда нажмите на "Tarball" или на "ZIP archive", чтобы загрузить полное исходное дерево.

4. Подтверждение, что код не изменяется

Файл "manifest" в корневом каталоге исходного дерева содержит хэш SHA3-256 или SHA1 для каждого исходного файла в хранилище. Название версии всего исходного дерева просто хэш SHA3-256 файла "manifest", возможно с последней строкойтого файла, опущенной, если последняя строка начинается с "# Remove this line". Файл "manifest.uuid" должен содержать хэш SHA3-256 файла "manifest". Если все вышеупомянутые сравнения хэшей правильны, то можно быть уверенным, что исходное дерево подлинное и настоящее. Детали о формате файлов манифеста доступны на сайте Fossil.

Процесс проверки подлинности исходного кода автоматизирован make-файлом:

make verify-source

Или в windows:

nmake /f Makefile.msc verify-source

Использование make-файла, чтобы проверить исходную целостность хорошо для обнаружения случайных изменений исходного дерева, но злонамеренные изменения могли быть скрыты, также изменив make-файлы.

5. Клонирование полной истории развития

Чтобы клонировать всю историю SQLite, сначала пойдите на страницу https://www.fossil-scm.org/download.html и скачайте предварительно собранный двоичный образ для программы управления версиями Fossil. Или получите исходный код на той же самой странице и соберите его сами.

С 2017-03-12 необходимо использовать версию Fossil version 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

Эта вторая команда сделает "checkout" последней регистрации от исходного дерева SQLite в ваш текущий каталог. Впоследствии можно легко переключиться на иную версию:

fossil update VERSION

Здесь VERSION может быть названием отделения (как "trunk" или "session"), чтобы получить последнюю регистрацию на определенной ветке, VERSION может быть хэшем SHA1 или префиксом хэша SHA1 для определенной регистрации. Также VERSION может быть признаком, таким как "version-3.8.8". Каждый раз вы выполняете "fossil update", оно автоматически обратится к оригинальному хранилищу на https://www.sqlite.org/src, чтобы получить новые регистрации, которые, возможно, были сделаны, начиная с вашего предыдущего обновления.