Как загрузить исходный код SQLite

1. Введение

Большинство программистов компилируют 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). Если вы знаете примерную дату версии, которую хотите загрузить, вы можете добавить параметр запроса, например, «c=ГГГГ-ММ-ДД», в URL «timeline», чтобы увидеть временную шкалу, сосредоточенную на этой дате. Например, чтобы увидеть все внесения, которые произошли около 26 августа 2013 года, посетите https://www.sqlite.org/src/timeline?c=2013-08-26. Если вы ищете официальный релиз, посетите страницу хронологии, щелкните по дате слева от искомого релиза, и это переведёт вас непосредственно к записи, соответствующей релизу.

После того, как вы найдёте конкретную версию, нажмите на гиперссылку для этой версии, чтобы увидеть «Страницу информации о внесении изменений». Затем нажмите на ссылку «Tarball» или «ZIP архив», чтобы загрузить всё дерево исходного кода.

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. Или получите исходный код на той же странице и скомпилируйте его самостоятельно.

По состоянию на 12 марта 2017 года для работы следующих инструкций необходимо использовать Fossil версии 2.0 или выше. Репозиторий SQLite начал использовать артефакты с именами, использующими хэши SHA3 вместо хэшей SHA1 в эту дату, и для понимания новых хэшей SHA3 требуется Fossil 2.0 или более поздней версии. Чтобы узнать, какая версия 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, чтобы получить новые записи, которые могут быть внесены другими пользователями с момента вашего предыдущего обновления.

Эта страница была изменена в последний раз 03 августа 2023 г. 14:10:55 UTC