From 380b7a30b698273d0891870ee06ae83a9356c0ce Mon Sep 17 00:00:00 2001 From: Marko Lindqvist Date: Sat, 29 Oct 2022 04:51:56 +0300 Subject: [PATCH 13/29] Add README.crosser See hrm #734372 Signed-off-by: Marko Lindqvist --- doc/Makefile.am | 1 + doc/README.crosser | 55 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+) create mode 100644 doc/README.crosser diff --git a/doc/Makefile.am b/doc/Makefile.am index b4e302a072..1c99b1615d 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -15,6 +15,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/ -- 2.35.1