widelands
1.2.1
Widelands-это бесплатная стратегическая игра в реальном времени с открытым исходным кодом с однопользовательскими кампаниями и многопользовательским режимом. Игра была вдохновлена Settlelers II ™ (© BlueByte), но имеет значительно больше разнообразия и глубины.
GPL V2+. Некоторые активы выпускаются по различным лицензиям Creative Commons - см. Соответствующие папки.
О том, как скачать Widelands, см. Https://www.widelands.org/wiki/download/
Мы поддерживаем компиляцию Widelands для Linux, Windows под MSYS2 и MSVC и macOS с GCC> = 8 или Clang/LLVM> = 7, хотя это может работать и с другими компиляторами. У нас есть более подробная документация, доступная по адресу: https://www.widelands.org/wiki/buildingwidelands/
Вам нужно будет установить следующие зависимости:
Затем вы можете скомпилировать, запустив наш сценарий удобства.
| Командование | Цель |
|---|---|
./compile.sh | Полная сборка отладки |
./compile.sh -r -w | Выпустить сборку |
./compile.sh -e -w | Выпустить сборку с символами отладки |
./compile.sh -h | Перечислите доступные параметры |
При завершении компиляции вы можете вызвать Wirelands с
./widelands
Вы также можете позвонить в Cmake вручную:
mkdir build
cd build
cmake ..
make
При завершении компиляции вы можете вызвать Wirelands с
cd ..
mv build/src/widelands .
./widelands
У нас есть различные варианты Cmake. Например, чтобы создать сборку выпуска, вызовите
cmake -DCMAKE_BUILD_TYPE=Release ..
Для использования системы сборки ниндзя, вызовите
mkdir build
cd build
cmake -G Ninja ..
ninja
В зависимости от установки ниндзя, последняя строка также может быть ninja-build .
Обратите внимание, что параметры Cmake префикс с -D . Это доступные варианты:
| Имя | Ценности | По умолчанию | Функция |
|---|---|---|---|
CMAKE_BUILD_TYPE | Debug / Release / RelWithDebInfo | Debug | Создайте сборку релиза или отладки |
OPTION_ASAN | ON / OFF | ON отладочных сборки / OFF для выпуска сборки | Используйте адресанитизатор. Выключение этого работает только один раз. Вам придется очистить каталог build , если вы хотите снова выключить его в более поздней сборке. |
OPTION_BUILD_CODECHECK | ON / OFF | ON | Создайте Codecheck. Доступно только в сборниках отладки. |
OPTION_BUILD_WEBSITE_TOOLS | ON / OFF | ON | Создайте инструменты, связанные с веб-сайтом |
OPTION_BUILD_TESTS | ON / OFF | ON | Построить модульные тесты |
CMAKE_INSTALL_PREFIX | Каталог | Смотрите документацию Cmake | Определите целевой каталог для цели «Установить», например, -DCMAKE_INSTALL_PREFIX=~/widelands-install . |
WL_INSTALL_BINDIR | Каталог | ${CMAKE_INSTALL_PREFIX}/games | Определите пункт назначения файлов исполняемых файлов (при установке) |
WL_VERSION | Версия строки | Автоспорт из GIT/BZR или установлен путем добавления файла VERSION | Определите версию Widelands |
USE_XDG | ON / OFF | ON | Следуйте спецификации на основе XDG. Доступен только на Linux. |
OPTION_USE_GLBINDING | ON / OFF | OFF | Используйте GLBINDING вместо GLEW |
OPTION_GLEW_STATIC | ON / OFF | OFF | Используйте статическую библиотеку Glew |
OPTION_FORCE_EMBEDDED_MINIZIP | ON / OFF | OFF | Используемые встроенные источники Minizip (проверка пропуска на установленную библиотеку Minizip) |
NEEDS_EXTERNAL_FILESYSTEM | ON / OFF | Автоспоражение от версии компилятора | Должна ли std::filesystem быть связана с дополнительной библиотекой |
Вы можете добавить цели в команду make или ninja , например, make codecheck только запустить код. Это доступные цели:
| Имя | Функция |
|---|---|
ALL или нет цели | Скомпилируйте все, вплоть до исполняемого файла с настройками из вызова cmake |
codecheck | Запустите Codechecks |
doc | Генерировать документацию доксигена. В настоящее время только с отладкой типа сборки, но это легко изменить при необходимости. |
install | Установите в Target Dir, это /usr/local по умолчанию (вам нужны корневые привилегии!) Если вы его не измените (см. Параметры Cmake выше) |
У нас есть несколько инструкций о том, как использовать GIT, чтобы помочь вам, если вы новичок в GIT: https://www.widelands.org/wiki/gitprimer/
Главный филиал и все проблемы и запросы на привлечение отражаются двунаправленно между нашими средами разработчиков на Codeberg и Github от Bunnybot. Bunnybot также форматирует код (C ++, Lua и Python) во всех зеркальных ветвях.
Мы следим за Google StyleGuide.
Для сценариев сценариев см. Https://www.widelands.org/documentation/lua_index/
Для получения искусства, см. Https://www.widelands.org/wiki/graphicsdevelopment/
Для получения переводов, см. Https://www.widelands.org/wiki/translatingwidelands/
Для помощи в тестировании см. Https://www.widelands.org/wiki/testingbranches/
Для помощи в управлении выпусками см. Https://www.widelands.org/wiki/triagingbugs/
| Каталог | Содержимое |
|---|---|
| Cmake | Построить систему и правила Codecheck |
| данные | Файлы данных игры. Изображения, звуки, музыка, сценарии, карты, кампании, племена, ... |
| Дебюн | Упаковка для дистрибутива Linux на основе Debian |
| док | Документация SPHINX |
| попечитель | Переводные файлы |
| SRC | Исходный код C ++ |
| тест | Карты сценариев для нашего регрессионного набора тестов |
| утилит | Разнообразные утилиты: переводы по строительству, форматирование кода, упаковка Mac & Windows, ... |
Все толчки для мастера будут построены на Appveyor. Ветвки запроса на вытягивание развернуты для MS-Windows с использованием действия GitHub. Чтобы получить сборки MS-Windows, если вы не хотите открывать запрос на вытяжение, временно добавьте имя вашего филиала в раздел branches в appveyor.yml . Это не сработает, если филиал находится в вилке, хотя.
Все филиалы запроса на вытягивание, а также Master дополнительно развернуты для MacOS, а испытательный контроль проверяет их под различными компиляторами. Чтобы получить результаты MacOS или результаты тестов, временно добавьте имя вашей ветви в раздел branches в .github/workflows/build.yaml . Это работает и для филиалов в вилках.
