Сборка из исходного кода

Для сборки SuperTuxKart из исходного кода вам понадобятся как код, так и ресурсы (см. https://supertuxkart.net/Source_control для получения дополнительной информации):

git clone https://github.com/supertuxkart/stk-code stk-code
svn co https://svn.code.sf.net/p/supertuxkart/code/stk-assets stk-assets

Сборка SuperTuxKart в Linux

Зависимости

Чтобы собрать SuperTuxKart из исходников, вам необходимо установить следующие пакеты:

• OpenAL (рекомендуется: openal-soft-devel)
• Ogg (libogg-dev)
• Vorbis (libvorbis-dev)
• Freetype (libfreetype6-dev)
• Harfbuzz (libharfbuzz-dev)
• libcurl (libcurl-devel)
• libbluetooth (bluez-devel)
• openssl (openssl-dev)
• libpng (libpng-devel)
• zlib (zlib-devel)
• jpeg (libjpeg-turbo-devel)
• SDL2 (libsdl2-devel).

Команда Fedora:

sudo dnf install @development-tools angelscript-devel \
bluez-libs-devel cmake desktop-file-utils SDL2-devel \
freealut-devel freetype-devel \
gcc-c++ git-core libcurl-devel libjpeg-turbo-devel \
libpng-devel libsquish-devel libtool libvorbis-devel \
openal-soft-devel openssl-devel libcurl-devel harfbuzz-devel \
libogg-devel openssl-devel pkgconf \
wiiuse-devel zlib-devel

Команда Mageia 6:

su -c 'urpmi gcc-c++ cmake openssl-devel libcurl-devel freetype-devel harfbuzz-devel \
libjpeg-turbo-devel libogg-devel openal-soft-devel SDL2-devel \
libpng-devel libvorbis-devel nettle-devel zlib-devel git subversion \
libbluez-devel libfreetype6-devel'

Команда openSUSE:

sudo zypper install gcc-c++ cmake openssl-devel libcurl-devel libSDL2-devel \
freetype-devel harfbuzz-devel libogg-devel openal-soft-devel libpng-devel \
libvorbis-devel pkgconf zlib-devel enet-devel \
libjpeg-devel bluez-devel freetype2-devel

Команда Debian-based Distributions:

sudo apt-get install build-essential cmake libbluetooth-dev libsdl2-dev \
libcurl4-openssl-dev libenet-dev libfreetype6-dev libharfbuzz-dev \
libjpeg-dev libogg-dev libopenal-dev libpng-dev \
libssl-dev libvorbis-dev libmbedtls-dev pkg-config zlib1g-dev

Команда Solus:

sudo eopkg it cmake openal-soft-devel libogg-devel libvorbis-devel freetype2-devel \
harfbuzz-devel curl-devel bluez-devel openssl-devel libpng-devel zlib-devel \
libjpeg-turbo-devel sdl2-devel enet-devel libjpeg-turbo-devel bluez-devel curl-devel

Встроенный рекордер

Чтобы создать встроенный рекордер для STK, вы должны установить libopenglrecorder из вашего дистрибутива или скомпилировать его самостоятельно по ссылке https://github.com/Benau/libopenglrecorder. Инструкция по компиляции приведена там же. Если вам не нужна эта функция, передайте -DBUILD_RECORDER=off в cmake.

Shaderc для поддержки Vulkan

Вам нужно скомпилировать Shaderc (https://github.com/google/shaderc) для поддержки vulkan в SuperTuxKart, если вы не создаёте для Windows или macOS. Если вам не нужна эта функция, передайте -DNO_SHADERC=on в cmake.

Компиляция

Чтобы скомпилировать SuperTuxKart, выполните следующие команды внутри каталога stk-code:

# перейдите в каталог stk-code
cd stk-code

# создайте и войдите в каталог cmake_build
mkdir cmake_build
cd cmake_build

# запустите cmake для создания make-файла
cmake ..

# скомпилируйте
make -j$(nproc)

Затем STK можно запустить из каталога сборки с помощью bin/supertuxkart

Обновление сборки

Чтобы перекомпилировать последний код без повторной загрузки всего исходного кода, сначала выполните команду svn up внутри каталога 'stk-assets', затем выполните следующие команды в каталоге 'stk-code':

git pull
cd cmake_build
cmake ..
make -j$(nproc)

Оптимизация скорости сборки

"-j$(nproc)" — это пример, для более быстрой сборки используйте "-jx" вместо этого, где "x" — количество потоков процессора, минус один.

Дополнительные опции

Чтобы создать отладочную версию STK, запустите:

cmake .. -DCMAKE_BUILD_TYPE=Debug

Вы можете установить свою сборку в масштабе всей системы:

sudo make install

По умолчанию местом установки является /usr/local, т. е. файлы данных будут записаны в /usr/local/share/games/supertuxkart, исполняемый файл будет скопирован в /usr/local/bin. Изменение места установки по умолчанию

Измените место установки по умолчанию, указав CMAKE_INSTALL_PREFIX при запуске cmake, например:

cmake .. -DCMAKE_INSTALL_PREFIX=/opt/stk

Сборка SuperTuxKart в Windows

Чтобы собрать SuperTuxKart на Windows, следуйте этим инструкциям:

1. Загрузите и установите Visual Studio отсюда: Visual Studio — загрузка. Прекрасно подойдёт бесплатная версия Visual Studio Community. Не забудьте выбрать «Разработка для настольных компьютеров на C++» в установщике.
2. Если вам нужна стабильная версия, загрузите исходный пакет SuperTuxKart с последней стабильной версии SuperTuxKart на GitHub и распакуйте его.
3. Если вам нужна версия для разработки, вам понадобится клиент Git и клиент SVN. Дополнительную информацию можно найти здесь: SuperTuxKart.net — управление исходным кодом. Откройте файловый браузер и найдите место, куда вы хотите поместить версию SuperTuxKart для разработки. Например, в C:\Users<Ваше имя пользователя>, так как клиенты Git и SVN будут иметь там права на запись, и вы должны создать свой собственный каталог, например, SuperTuxKart-dev. Войдите в этот каталог и создайте каталог внутри с именем stk-assets, войдите в него. Если вы установили TortoiseSVN, щёлкните правой кнопкой мыши, выберите TortoiseSVN → Оформить заказ... и вставьте соответствующий URL, найденный на SuperTuxKart.net — управление исходным кодом. Пока он скачивает игровые ресурсы, вернитесь к своему файловому браузеру и перейдите на один уровень вверх. Снова щёлкните правой кнопкой мыши где-нибудь в пустом месте и выберите «Git clone...» и вставьте соответствующую ссылку, найденную на SuperTuxKart.net — управление исходным кодом. Примечание: и stk-код, и stk-активы должны находиться в одном каталоге, иначе сборка, скорее всего, завершится ошибкой!
4. Если у вас есть стабильная версия, скачайте пакет зависимостей Windows из SuperTuxKart на GitHub — выпуски зависимостей, найдите там версию stk-кода и скачайте dependencies(arch).zip по мере необходимости и распакуйте архив в каталог stk-code.
5. Если у вас есть версия для разработки, перейдите в SuperTuxKart-dev в вашем файловом браузере, затем посетите SuperTuxKart on GitHub — предварительный выпуск последних зависимостей и распакуйте архив в каталог stk-code. Скачайте i686, если вы используете Win32 генератор MSVC, x86_64 для x64, armv7 для ARM и aarch64 для ARM64.
6. Скачайте CMake отсюда: CMake — страница загрузки, установите его; после установки CMake дважды щелкните значок CMake на рабочем столе и укажите его на каталог stk-code в поле «Где находится исходный код», а «Куда поместить двоичные файлы» — в новый каталог с именем build или bld внутри каталога stk-code.
7. Нажмите «Настроить»; CMake спросит вас, нормально ли создать вышеупомянутый каталог, нажмите «Да». Затем CMake спросит о вашей версии Visual Studio. Подтвердите свой выбор; пожалуйста, посмотрите на таблицу ниже, чтобы избежать путаницы между номерами версий и выпусками Visual Studio; CMake начнёт создавать необходимые файлы для сборки в каталоге. Если вы хотите сделать 64-битную сборку, выберите версию Visual Studio, которую вы установили с добавлением «Win64». Нажмите кнопку «Сгенерировать».
8. Перейдите в каталог сборки и откройте файл SuperTuxKart.sln; Visual Studio теперь загрузит решение.
9. В «Обозревателе решений» щёлкните правой кнопкой мыши проект supertuxkart и выберите «Установить как запускаемый проект».
10. Откройте меню «Построить» и выберите «Построить решение»; или нажмите стандартную комбинацию клавиш: CTRL + SHIFT + B, чтобы построить решение. Примечание: Чтобы избежать путаницы между выпусками и версиями, обратитесь к этой таблице: | Выпуск Visual Studio | Версия | | ------------------- | ------- | | Visual Studio 2019 | 16 | | Visual Studio 2017 | 15 | | Visual Studio 2015 | 14 | | Visual Studio 2013 | 13 |

Сборка SuperTuxKart в Windows (из PowerShell/командной строки)