widelands
1.2.1
Widelands是一個免費的開源實時策略遊戲，具有單人遊戲和多人遊戲模式。該遊戲的靈感來自Settlers II™（©Bluebyte），但其多樣性和深度明顯增加。
GPL V2+。一些資產在各種創意共享許可下發布 - 請參閱各自的文件夾。
關於如何下載Widelands，請參見https://www.widelands.org/wiki/download/
我們支持為Linux，MSYS2和MSVC下的Windows以及具有GCC> = 8或Clang/llvm> = 7的MacOS編譯Widelands，儘管它也可能與其他編譯器一起使用。我們有更多詳細的文檔可用：https：//www.widelands.org/wiki/buildingwidelands/
您需要安裝以下依賴項：
然後，您可以通過運行我們的便利腳本來編譯。
| 命令 | 目的 |
|---|---|
./compile.sh | 完整的調試構建 |
./compile.sh -r -w | 釋放構建 |
./compile.sh -e -w | 帶有調試符號的發布構建 |
./compile.sh -h | 列表可用選項 |
編譯完成後，您可以致電Widelands
./widelands
您也可以手動致電Cmake：
mkdir build
cd build
cmake ..
make
編譯完成後，您可以致電Widelands
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以進行發布 | 使用adverseSanitizer。關閉此功能只能使用一次。如果您想在以後的構建中再次關閉該目錄，則必須清除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而不是gle |
OPTION_GLEW_STATIC | ON / OFF | OFF | 使用靜態glew庫 |
OPTION_FORCE_EMBEDDED_MINIZIP | ON / OFF | OFF | 用過的嵌入式縮影來源（Skip檢查已安裝的縮影庫） |
NEEDS_EXTERNAL_FILESYSTEM | ON / OFF | 從編譯器版本自動進行自動檢測 | std::filesystem是否需要鏈接到額外的庫 |
您可以將目標添加到make或ninja命令中，例如make codecheck僅運行代碼檢查套件。這些是可用的目標：
| 姓名 | 功能 |
|---|---|
ALL目標 | 編譯所有內容，直到可以使用cmake調用的設置可執行 |
codecheck | 運行codechecks |
doc | 生成doxygen文檔。目前僅使用Build Type調試，但這在必要時很容易更改。 |
install | 安裝到目標dir，這是/usr/local默認值（您需要root特權！），除非您更改它（請參閱上面的CMAKE選項） |
如果您是新手Git：https：//www.widelands.org/wiki/gitprimer/，我們有一些有關如何使用git幫助您的說明
主分支以及所有問題和拉的請求在Codeberg和Bunnybot的Github上的開發人員環境之間進行雙向反映。 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規則 |
| 數據 | 遊戲的數據文件。圖像，聲音，音樂，腳本，地圖，廣告系列，部落，... |
| Debian | 基於Debian Linux發行的包裝 |
| Doc | 獅身人面像文檔 |
| po | 翻譯文件 |
| src | C ++源代碼 |
| 測試 | 我們的回歸測試套件的腳本圖 |
| UTILS | 不同的實用程序：建築翻譯，代碼格式，包裝Mac和Windows，... |
所有推向碩士都將建立在Appveyor上。使用GitHub操作將拉請求分支部署用於MS-Windows。要獲取MS-Windows構建，如果您不希望打開拉請請求，請臨時將分支的名稱添加到appveyor.yml的branches部分。如果分支在叉中，這將行不通。
所有拉的請求分支和主人都將用於MACOS，並在各種編譯器下檢查測試套件。為了獲得MacOS構建或測試套件結果，請在.github/workflows/build.yaml中暫時將分支的名稱添加到branches部分。這也適用於叉子的分支機構。
