From c5ba364dc0fa421a0793f7e746498c3032995b4c Mon Sep 17 00:00:00 2001 From: Marko Lindqvist Date: Sat, 29 Oct 2022 04:47:44 +0300 Subject: [PATCH 07/30] Add README.crosser See hrm #734372 Signed-off-by: Marko Lindqvist --- doc/Makefile.am | 1 + doc/README.crosser | 55 ++++++++++++++++++++++++++++++++++++++++++++++ meson.build | 1 + 3 files changed, 57 insertions(+) create mode 100644 doc/README.crosser diff --git a/doc/Makefile.am b/doc/Makefile.am index 80b579ddfa..cbdecb10d6 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -16,6 +16,7 @@ docs = \ README.AI \ README.AI_modules \ README.attributes \ + README.crosser \ README.delta \ README.effects \ README.fcdb \ diff --git a/doc/README.crosser b/doc/README.crosser new file mode 100644 index 0000000000..e59bdf3aff --- /dev/null +++ b/doc/README.crosser @@ -0,0 +1,55 @@ + + Notes about Crosser-based Windows Installers +============================================= + +Crosser is an environment used to cross-compile freeciv +Installers for Windows targets on a linux build host. +Crosser home page is at https://www.cazfi.net/crosser/ +Crosser development happens on Debian and Ubuntu LTS +versions - be prepared to adjusting things yourself +if you try to use some distribution not a Debian derivative. + + + Crosser version +================ + +Scripts to create installers require specific crosser version +(MAJOR.MINOR, or "CROSSER_FEATURE_LEVEL") to know what exact files +they need to package with freeciv. +See CROSSER_FEATURE_LEVEL on top of winbuild.sh under +windows/installer_cross/ to see what is the crosser version +currently supported and required. + + + Setting up crosser build environment +===================================== + +Download win64stack-full-.7z from +https://sourceforge.net/projects/crosser/ + +Unpack downloaded package under /usr/crosser/ +(likely you need to create that directory - or to create +it as a symbolic link to another location) +so that after unpacking you will have, e.g. +/usr/crosser/win64stack-full-2.5/ + +Install MinGW cross-compiler, also for C++. +On Debian derivatives those packages are +- mingw-w64 +- g++-mingw-w64 + +TODO: Find out what other native side requirements + crosser build has and list them. + + + Building Windows Installers with crosser +========================================= + +If everything is set up correctly, easiest way +to do the build is to run +> ./build_all_installer.sh +on windows/installer_cross/. +Currently these scripts need to be run their own +directory, and they produce their output there +(wihin freeciv tree). If everything success, final +installers are generated to Output/ diff --git a/meson.build b/meson.build index 2913695f2a..55f8cfa1fa 100644 --- a/meson.build +++ b/meson.build @@ -3391,6 +3391,7 @@ install_data( 'doc/README.AI', 'doc/README.AI_modules', 'doc/README.attributes', + 'doc/README.crosser', 'doc/README.delta', 'doc/README.effects', 'doc/README.fcdb', -- 2.35.1