widelands

Widelands

Widelands adalah permainan strategi real-time open source gratis dengan kampanye SinglePlayer dan mode multipemain. Gim ini terinspirasi oleh Settlers II ™ (© Bluebyte) tetapi memiliki variasi dan kedalaman yang jauh lebih banyak.

Lisensi

Gpl v2+. Beberapa aset dirilis di bawah berbagai lisensi Creative Commons - lihat masing -masing folder.

Unduh

Tentang cara mengunduh widelands, lihat https://www.widelands.org/wiki/download/

Menyusun

Kami mendukung kompilasi Widelands untuk Linux, Windows di bawah MSYS2 dan MSVC, dan MacOS dengan GCC> = 8 atau Clang/LLVM> = 7, meskipun mungkin bekerja dengan kompiler lain juga. Kami memiliki dokumentasi lebih rinci yang tersedia di: https://www.widelands.org/wiki/buildingwidelands/

Dependensi

Anda perlu menginstal dependensi berikut:

• LIBSDL> = 2.0
• LIBSDL_IMAGE
• LIBSDL_MIXER> = 2.0
• LIBSDL_TTF> = 2.0
• gettext
• libiconv (pada cermin yang sama dengan gettext)
• Zlib
• libpng
• Asio
• Python> = 1.5.2
• libglew atau glbinding

Menyusun dengan skrip kenyamanan kami

Anda kemudian dapat mengkompilasi dengan menjalankan skrip kenyamanan kami.

Memerintah	Tujuan
./compile.sh	Build Debug Lengkap
./compile.sh -r -w	Rilis Build
./compile.sh -e -w	Bangun rilis dengan simbol debugging
./compile.sh -h	Daftar opsi yang tersedia

Saat menyusun telah selesai, Anda dapat menghubungi Widelands dengan

 ./widelands

Menyusun dengan cmake

Anda juga dapat menghubungi CMake secara manual:

 mkdir build
cd build
cmake ..
make

Saat menyusun telah selesai, Anda dapat menghubungi Widelands dengan

 cd ..
mv build/src/widelands .
./widelands

Kami memiliki berbagai opsi cmake yang tersedia. Misalnya, untuk membuat rilis build, hubungi

 cmake -DCMAKE_BUILD_TYPE=Release ..

Untuk menggunakan sistem build ninja, hubungi

 mkdir build
cd build
cmake -G Ninja ..
ninja

Bergantung pada instalasi ninja, baris terakhir juga bisa menjadi ninja-build .

Opsi CMake

Perhatikan bahwa opsi CMake diawali dengan -D . Ini adalah opsi yang tersedia:

Nama	Nilai	Bawaan	Fungsi
CMAKE_BUILD_TYPE	Debug / Release / RelWithDebInfo	Debug	Buat rilis atau debug build
OPTION_ASAN	ON / OFF	ON untuk membangun debug / OFF untuk pembangunan rilis	Gunakan Alamatsanitizer. Mematikan ini hanya berfungsi sekali. Anda harus menghapus direktori build jika Anda ingin mematikannya lagi di build nanti.
OPTION_BUILD_CODECHECK	ON / OFF	ON	Bangun Codecheck. Hanya tersedia di Debug Builds.
OPTION_BUILD_WEBSITE_TOOLS	ON / OFF	ON	Bangun alat terkait situs web
OPTION_BUILD_TESTS	ON / OFF	ON	Bangun tes unit
CMAKE_INSTALL_PREFIX	Direktori	Lihat Dokumentasi CMake	Tentukan direktori target untuk target "instal", misalnya -DCMAKE_INSTALL_PREFIX=~/widelands-install .
WL_INSTALL_BINDIR	Direktori	${CMAKE_INSTALL_PREFIX}/games	Tentukan tujuan file yang dapat dieksekusi (jika menginstal)
WL_VERSION	String versi	Autodeteksi dari Git/BZR, atau diatur dengan menambahkan file VERSION	Tentukan versi Widelands
USE_XDG	ON / OFF	ON	Ikuti spesifikasi berbasis XDG. Hanya tersedia di Linux.
OPTION_USE_GLBINDING	ON / OFF	OFF	Gunakan glbinding bukan glew
OPTION_GLEW_STATIC	ON / OFF	OFF	Gunakan Perpustakaan Glew Statis
OPTION_FORCE_EMBEDDED_MINIZIP	ON / OFF	OFF	Sumber Minizip Tertanam Bekas (Lewati Pemeriksaan untuk Perpustakaan Minizip Terpasang)
NEEDS_EXTERNAL_FILESYSTEM	ON / OFF	Autodeteksi dari versi kompiler	Apakah std::filesystem perlu dikaitkan dengan perpustakaan tambahan

Target Make/Ninja

Anda dapat menambahkan target ke perintah make atau ninja , misalnya make codecheck untuk hanya menjalankan kode cek kode. Ini adalah target yang tersedia:

Nama	Fungsi
ALL atau tidak ada target	Kompilasi semuanya, hingga dapat dieksekusi dengan pengaturan dari panggilan cmake
codecheck	Jalankan CodeChecks
doc	Menghasilkan dokumentasi doxygen. Saat ini hanya dengan Debug Tipe Build, tetapi ini mudah diubah jika perlu.
install	Instal ke Dir Target, ini adalah /usr/local per default (Anda memerlukan hak istimewa root!) Kecuali jika Anda mengubahnya (lihat opsi CMake di atas)

Berkontribusi

Kami memiliki beberapa instruksi tentang cara menggunakan git untuk membantu Anda jika Anda baru mengenal git: https://www.widelands.org/wiki/gitprimer/

Kode

Cabang Master dan semua masalah dan permintaan tarik dicerminkan secara dua kali lipat antara lingkungan pengembang kami di Codeberg dan Github oleh Bunnybot. Bunnybot juga memformat kode (C ++, LUA, dan Python) di semua cabang cermin.

Kami mengikuti Google StyleGuide.

Skenario

Untuk skenario skrip, lihat https://www.widelands.org/documentation/lua_index/

Seni

Untuk seni yang berkontribusi, lihat https://www.widelands.org/wiki/graphicsdevelopment/

Terjemahan

Untuk berkontribusi terjemahan, lihat https://www.widelands.org/wiki/translatingwidelands/

Pengujian

Untuk membantu pengujian, lihat https://www.widelands.org/wiki/testingbranches/

Masalah triase

Untuk membantu manajemen masalah, lihat https://www.widelands.org/wiki/triagingbugs/

Struktur Direktori

Direktori	Isi
cmake	Bangun aturan sistem dan codeCheck
data	File Data Game. Gambar, suara, musik, skrip, peta, kampanye, suku, ...
Debian	Pengemasan untuk Distribusi Linux yang berbasis di Debian
dokter	Dokumentasi Sphinx
PO	File terjemahan
SRC	Kode Sumber C ++
tes	Peta skrip untuk suite tes regresi kami
utils	Beragam utilitas: membangun terjemahan, pemformatan kode, kemasan mac & windows, ...

Mendapatkan MacOS dan MS-Windows Build dan TestSuite berjalan

Semua dorongan ke master akan dibangun di atas appveyor. Cabang permintaan tarik digunakan untuk MS-Windows menggunakan aksi GitHub. Untuk mendapatkan build MS-Windows jika Anda tidak ingin membuka permintaan tarik, untuk sementara menambahkan nama cabang Anda ke bagian branches di appveyor.yml . Ini tidak akan berhasil jika cabang berada di garpu.

Semua cabang permintaan tarik serta master juga digunakan untuk macOS, dan testsuite memeriksanya di bawah berbagai kompiler. Untuk mendapatkan MacOS build atau hasil testSuite, sementara tambahkan nama cabang Anda ke bagian branches di .github/workflows/build.yaml . Ini juga berfungsi untuk cabang di garpu.