83561d639d
mono was the bottleneck restricting our ability to use a newer C# version. mono 6.12 is currently available. Although poorly documented on their website, this supports C# 9. https://www.mono-project.com/docs/about-mono/versioning/#mono-source-versioning indicates mono 6.12 uses Roslyn 3.9.0. https://github.com/dotnet/roslyn/blob/main/docs/wiki/NuGet-packages.md#versioning indicates Roslyn 3.9.0 supports C# 9. This unlocks C# 8 and C# 9 features previously unavailable to us. - https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-version-history#c-version-80 - https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-version-history#c-version-9 A newer version of StyleCop is required to avoid rules tripping up on the new syntax. Currently only prerelease versions are available but their use is encouraged https://github.com/DotNetAnalyzers/StyleCopAnalyzers/issues/3420#issuecomment-994899135 Fix style rule violations on existing rules where the newer language version makes some existing casts redundant or allows use of the null coalescing assignment operator.
211 lines
7.0 KiB
Makefile
211 lines
7.0 KiB
Makefile
############################# INSTRUCTIONS #############################
|
|
#
|
|
# to compile, run:
|
|
# make
|
|
#
|
|
# to compile using Mono (version 6.12 or greater) instead of .NET 6, run:
|
|
# make RUNTIME=mono
|
|
#
|
|
# to compile using system libraries for native dependencies, run:
|
|
# make [RUNTIME=net6] TARGETPLATFORM=unix-generic
|
|
#
|
|
# to check the official mods for erroneous yaml files, run:
|
|
# make [RUNTIME=net6] test
|
|
#
|
|
# to check the engine and official mod dlls for code style violations, run:
|
|
# make [RUNTIME=net6] check
|
|
#
|
|
# to compile and install Red Alert, Tiberian Dawn, and Dune 2000, run:
|
|
# make [RUNTIME=net6] [prefix=/foo] [bindir=/bar/bin] install
|
|
#
|
|
# to compile and install Red Alert, Tiberian Dawn, and Dune 2000
|
|
# using system libraries for native dependencies, run:
|
|
# make [prefix=/foo] [bindir=/bar/bin] TARGETPLATFORM=unix-generic install
|
|
#
|
|
# to install FreeDesktop startup scripts, desktop files, icons, and MIME metadata
|
|
# make install-linux-shortcuts
|
|
#
|
|
# to install FreeDesktop AppStream metadata
|
|
# make install-linux-appdata
|
|
#
|
|
# to install the Unix man page
|
|
# make install-man
|
|
#
|
|
# for help, run:
|
|
# make help
|
|
#
|
|
|
|
######################### UTILITIES/SETTINGS ###########################
|
|
#
|
|
# Install locations for local installs and downstream packaging
|
|
prefix ?= /usr/local
|
|
datarootdir ?= $(prefix)/share
|
|
datadir ?= $(datarootdir)
|
|
mandir ?= $(datarootdir)/man/
|
|
bindir ?= $(prefix)/bin
|
|
libdir ?= $(prefix)/lib
|
|
gameinstalldir ?= $(libdir)/openra
|
|
|
|
# Toolchain
|
|
CWD = $(shell pwd)
|
|
MSBUILD = msbuild -verbosity:m -nologo
|
|
DOTNET = dotnet
|
|
MONO = mono
|
|
RM = rm
|
|
RM_R = $(RM) -r
|
|
RM_F = $(RM) -f
|
|
RM_RF = $(RM) -rf
|
|
|
|
RUNTIME ?= net6
|
|
CONFIGURATION ?= Release
|
|
DOTNET_RID = $(shell ${DOTNET} --info | grep RID: | cut -w -f3)
|
|
ARCH_X64 = $(shell echo ${DOTNET_RID} | grep x64)
|
|
|
|
# Only for use in target version:
|
|
VERSION := $(shell git name-rev --name-only --tags --no-undefined HEAD 2>/dev/null || (c=$$(git rev-parse --short HEAD 2>/dev/null) && echo git-$$c))
|
|
|
|
# Detect target platform for dependencies if not given by the user
|
|
ifndef TARGETPLATFORM
|
|
UNAME_S := $(shell uname -s)
|
|
UNAME_M := $(shell uname -m)
|
|
ifeq ($(UNAME_S),Darwin)
|
|
ifeq ($(ARCH_X64),)
|
|
TARGETPLATFORM = osx-arm64
|
|
else
|
|
TARGETPLATFORM = osx-x64
|
|
endif
|
|
else
|
|
ifeq ($(UNAME_M),x86_64)
|
|
TARGETPLATFORM = linux-x64
|
|
else
|
|
ifeq ($(UNAME_M),aarch64)
|
|
TARGETPLATFORM = linux-arm64
|
|
else
|
|
TARGETPLATFORM = unix-generic
|
|
endif
|
|
endif
|
|
endif
|
|
endif
|
|
|
|
##################### DEVELOPMENT BUILDS AND TESTS #####################
|
|
#
|
|
all:
|
|
@echo "Compiling in ${CONFIGURATION} mode..."
|
|
ifeq ($(RUNTIME), mono)
|
|
@command -v $(firstword $(MSBUILD)) >/dev/null || (echo "OpenRA requires the '$(MSBUILD)' tool provided by Mono >= 6.12."; exit 1)
|
|
@$(MSBUILD) -t:Build -restore -p:Configuration=${CONFIGURATION} -p:TargetPlatform=$(TARGETPLATFORM)
|
|
else
|
|
@$(DOTNET) build -c ${CONFIGURATION} -nologo -p:TargetPlatform=$(TARGETPLATFORM)
|
|
endif
|
|
ifeq ($(TARGETPLATFORM), unix-generic)
|
|
@./configure-system-libraries.sh
|
|
endif
|
|
@./fetch-geoip.sh
|
|
|
|
# dotnet clean and msbuild -t:Clean leave files that cause problems when switching between mono/dotnet
|
|
# Deleting the intermediate / output directories ensures the build directory is actually clean
|
|
clean:
|
|
@-$(RM_RF) ./bin ./*/obj
|
|
@-$(RM_F) IP2LOCATION-LITE-DB1.IPV6.BIN.ZIP
|
|
|
|
check:
|
|
@echo
|
|
@echo "Compiling in Debug mode..."
|
|
ifeq ($(RUNTIME), mono)
|
|
@$(MSBUILD) -t:clean\;build -restore -p:Configuration=Debug -warnaserror -p:TargetPlatform=$(TARGETPLATFORM)
|
|
else
|
|
@$(DOTNET) clean -c Debug --nologo --verbosity minimal
|
|
@$(DOTNET) build -c Debug -nologo -warnaserror -p:TargetPlatform=$(TARGETPLATFORM)
|
|
endif
|
|
ifeq ($(TARGETPLATFORM), unix-generic)
|
|
@./configure-system-libraries.sh
|
|
endif
|
|
@echo
|
|
@echo "Checking for explicit interface violations..."
|
|
@./utility.sh all --check-explicit-interfaces
|
|
@echo
|
|
@echo "Checking for incorrect conditional trait interface overrides..."
|
|
@./utility.sh all --check-conditional-trait-interface-overrides
|
|
|
|
check-scripts:
|
|
@echo
|
|
@echo "Checking for Lua syntax errors..."
|
|
@find lua/ mods/*/{maps,scripts}/ -iname "*.lua" -print0 | xargs -0n1 luac -p
|
|
|
|
test: all
|
|
@echo
|
|
@echo "Testing Tiberian Sun mod MiniYAML..."
|
|
@./utility.sh ts --check-yaml
|
|
@echo
|
|
@echo "Testing Dune 2000 mod MiniYAML..."
|
|
@./utility.sh d2k --check-yaml
|
|
@echo
|
|
@echo "Testing Tiberian Dawn mod MiniYAML..."
|
|
@./utility.sh cnc --check-yaml
|
|
@echo
|
|
@echo "Testing Red Alert mod MiniYAML..."
|
|
@./utility.sh ra --check-yaml
|
|
|
|
############# LOCAL INSTALLATION AND DOWNSTREAM PACKAGING ##############
|
|
#
|
|
version: VERSION mods/ra/mod.yaml mods/cnc/mod.yaml mods/d2k/mod.yaml mods/ts/mod.yaml mods/modcontent/mod.yaml mods/all/mod.yaml
|
|
ifeq ($(VERSION),)
|
|
$(error Unable to determine new version (requires git or override of variable VERSION))
|
|
endif
|
|
@sh -c '. ./packaging/functions.sh; set_engine_version "$(VERSION)" .'
|
|
@sh -c '. ./packaging/functions.sh; set_mod_version "$(VERSION)" mods/ra/mod.yaml mods/cnc/mod.yaml mods/d2k/mod.yaml mods/ts/mod.yaml mods/modcontent/mod.yaml mods/all/mod.yaml'
|
|
|
|
install:
|
|
@sh -c '. ./packaging/functions.sh; install_assemblies $(CWD) $(DESTDIR)$(gameinstalldir) $(TARGETPLATFORM) $(RUNTIME) True True True'
|
|
@sh -c '. ./packaging/functions.sh; install_data $(CWD) $(DESTDIR)$(gameinstalldir) cnc d2k ra'
|
|
|
|
install-linux-shortcuts:
|
|
@sh -c '. ./packaging/functions.sh; install_linux_shortcuts $(CWD) "$(DESTDIR)" "$(gameinstalldir)" "$(bindir)" "$(datadir)" "$(shell head -n1 VERSION)" cnc d2k ra'
|
|
|
|
install-linux-appdata:
|
|
@sh -c '. ./packaging/functions.sh; install_linux_appdata $(CWD) "$(DESTDIR)" "$(datadir)" cnc d2k ra'
|
|
|
|
install-man: all
|
|
@mkdir -p $(DESTDIR)$(mandir)/man6/
|
|
@./utility.sh all --man-page > $(DESTDIR)$(mandir)/man6/openra.6
|
|
|
|
help:
|
|
@echo 'to compile, run:'
|
|
@echo ' make'
|
|
@echo
|
|
@echo 'to compile using Mono (version 6.12 or greater) instead of .NET 6, run:'
|
|
@echo ' make RUNTIME=mono'
|
|
@echo
|
|
@echo 'to compile using system libraries for native dependencies, run:'
|
|
@echo ' make [RUNTIME=net6] TARGETPLATFORM=unix-generic'
|
|
@echo
|
|
@echo 'to check the official mods for erroneous yaml files, run:'
|
|
@echo ' make [RUNTIME=net6] test'
|
|
@echo
|
|
@echo 'to check the engine and official mod dlls for code style violations, run:'
|
|
@echo ' make [RUNTIME=net6] check'
|
|
@echo
|
|
@echo 'to compile and install Red Alert, Tiberian Dawn, and Dune 2000 run:'
|
|
@echo ' make [RUNTIME=net6] [prefix=/foo] [TARGETPLATFORM=unix-generic] install'
|
|
@echo
|
|
@echo 'to compile and install Red Alert, Tiberian Dawn, and Dune 2000'
|
|
@echo 'using system libraries for native dependencies, run:'
|
|
@echo ' make [RUNTIME=net6] [prefix=/foo] [bindir=/bar/bin] TARGETPLATFORM=unix-generic install'
|
|
@echo
|
|
@echo 'to install FreeDesktop startup scripts, desktop files, icons, and MIME metadata'
|
|
@echo ' make install-linux-shortcuts'
|
|
@echo
|
|
@echo 'to install FreeDesktop AppStream metadata'
|
|
@echo ' make install-linux-appdata'
|
|
@echo
|
|
@echo 'to install a Unix man page'
|
|
@echo ' make install-man'
|
|
|
|
########################### MAKEFILE SETTINGS ##########################
|
|
#
|
|
.DEFAULT_GOAL := all
|
|
|
|
.SUFFIXES:
|
|
|
|
.PHONY: all clean check check-scripts test version install install-linux-shortcuts install-linux-appdata install-man help
|