cd4e46ee65
Configured for a max line length of 120 characters. psf/black is very opinionated and purposely doesn't leave much room for configuration. The output is mostly OK so that should be fine for us, but some things worth noting: - Manually wrapped strings will be reflowed, so by using a line length of 120 for the sake of preserving readability for our long command calls, it also means that some manually wrapped strings are back on the same line and should be manually merged again. - Code generators using string concatenation extensively look awful, since black puts each operand on a single line. We need to refactor these generators to use more pythonic string formatting, for which many options are available (`%`, `format` or f-strings). - CI checks and a pre-commit hook will be added to ensure that future buildsystem changes are well-formatted.
335 lines
12 KiB
Python
335 lines
12 KiB
Python
import os
|
|
import sys
|
|
import platform
|
|
from distutils.version import LooseVersion
|
|
|
|
|
|
def is_active():
|
|
return True
|
|
|
|
|
|
def get_name():
|
|
return "Android"
|
|
|
|
|
|
def can_build():
|
|
return "ANDROID_NDK_ROOT" in os.environ
|
|
|
|
|
|
def get_platform(platform):
|
|
return int(platform.split("-")[1])
|
|
|
|
|
|
def get_opts():
|
|
from SCons.Variables import BoolVariable, EnumVariable
|
|
|
|
return [
|
|
("ANDROID_NDK_ROOT", "Path to the Android NDK", os.environ.get("ANDROID_NDK_ROOT", 0)),
|
|
("ndk_platform", 'Target platform (android-<api>, e.g. "android-18")', "android-18"),
|
|
EnumVariable("android_arch", "Target architecture", "armv7", ("armv7", "arm64v8", "x86", "x86_64")),
|
|
BoolVariable("android_neon", "Enable NEON support (armv7 only)", True),
|
|
]
|
|
|
|
|
|
def get_flags():
|
|
return [
|
|
("tools", False),
|
|
]
|
|
|
|
|
|
def create(env):
|
|
tools = env["TOOLS"]
|
|
if "mingw" in tools:
|
|
tools.remove("mingw")
|
|
if "applelink" in tools:
|
|
tools.remove("applelink")
|
|
env.Tool("gcc")
|
|
return env.Clone(tools=tools)
|
|
|
|
|
|
def configure(env):
|
|
# Workaround for MinGW. See:
|
|
# http://www.scons.org/wiki/LongCmdLinesOnWin32
|
|
if os.name == "nt":
|
|
|
|
import subprocess
|
|
|
|
def mySubProcess(cmdline, env):
|
|
# print("SPAWNED : " + cmdline)
|
|
startupinfo = subprocess.STARTUPINFO()
|
|
startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
|
|
proc = subprocess.Popen(
|
|
cmdline,
|
|
stdin=subprocess.PIPE,
|
|
stdout=subprocess.PIPE,
|
|
stderr=subprocess.PIPE,
|
|
startupinfo=startupinfo,
|
|
shell=False,
|
|
env=env,
|
|
)
|
|
data, err = proc.communicate()
|
|
rv = proc.wait()
|
|
if rv:
|
|
print("=====")
|
|
print(err)
|
|
print("=====")
|
|
return rv
|
|
|
|
def mySpawn(sh, escape, cmd, args, env):
|
|
|
|
newargs = " ".join(args[1:])
|
|
cmdline = cmd + " " + newargs
|
|
|
|
rv = 0
|
|
if len(cmdline) > 32000 and cmd.endswith("ar"):
|
|
cmdline = cmd + " " + args[1] + " " + args[2] + " "
|
|
for i in range(3, len(args)):
|
|
rv = mySubProcess(cmdline + args[i], env)
|
|
if rv:
|
|
break
|
|
else:
|
|
rv = mySubProcess(cmdline, env)
|
|
|
|
return rv
|
|
|
|
env["SPAWN"] = mySpawn
|
|
|
|
# Architecture
|
|
|
|
if env["android_arch"] not in ["armv7", "arm64v8", "x86", "x86_64"]:
|
|
env["android_arch"] = "armv7"
|
|
|
|
neon_text = ""
|
|
if env["android_arch"] == "armv7" and env["android_neon"]:
|
|
neon_text = " (with NEON)"
|
|
print("Building for Android (" + env["android_arch"] + ")" + neon_text)
|
|
|
|
can_vectorize = True
|
|
if env["android_arch"] == "x86":
|
|
env["ARCH"] = "arch-x86"
|
|
env.extra_suffix = ".x86" + env.extra_suffix
|
|
target_subpath = "x86-4.9"
|
|
abi_subpath = "i686-linux-android"
|
|
arch_subpath = "x86"
|
|
env["x86_libtheora_opt_gcc"] = True
|
|
if env["android_arch"] == "x86_64":
|
|
if get_platform(env["ndk_platform"]) < 21:
|
|
print(
|
|
"WARNING: android_arch=x86_64 is not supported by ndk_platform lower than android-21; setting ndk_platform=android-21"
|
|
)
|
|
env["ndk_platform"] = "android-21"
|
|
env["ARCH"] = "arch-x86_64"
|
|
env.extra_suffix = ".x86_64" + env.extra_suffix
|
|
target_subpath = "x86_64-4.9"
|
|
abi_subpath = "x86_64-linux-android"
|
|
arch_subpath = "x86_64"
|
|
env["x86_libtheora_opt_gcc"] = True
|
|
elif env["android_arch"] == "armv7":
|
|
env["ARCH"] = "arch-arm"
|
|
target_subpath = "arm-linux-androideabi-4.9"
|
|
abi_subpath = "arm-linux-androideabi"
|
|
arch_subpath = "armeabi-v7a"
|
|
if env["android_neon"]:
|
|
env.extra_suffix = ".armv7.neon" + env.extra_suffix
|
|
else:
|
|
env.extra_suffix = ".armv7" + env.extra_suffix
|
|
elif env["android_arch"] == "arm64v8":
|
|
if get_platform(env["ndk_platform"]) < 21:
|
|
print(
|
|
"WARNING: android_arch=arm64v8 is not supported by ndk_platform lower than android-21; setting ndk_platform=android-21"
|
|
)
|
|
env["ndk_platform"] = "android-21"
|
|
env["ARCH"] = "arch-arm64"
|
|
target_subpath = "aarch64-linux-android-4.9"
|
|
abi_subpath = "aarch64-linux-android"
|
|
arch_subpath = "arm64-v8a"
|
|
env.extra_suffix = ".armv8" + env.extra_suffix
|
|
|
|
# Build type
|
|
|
|
if env["target"].startswith("release"):
|
|
if env["optimize"] == "speed": # optimize for speed (default)
|
|
env.Append(LINKFLAGS=["-O2"])
|
|
env.Append(CCFLAGS=["-O2", "-fomit-frame-pointer"])
|
|
env.Append(CPPDEFINES=["NDEBUG"])
|
|
else: # optimize for size
|
|
env.Append(CCFLAGS=["-Os"])
|
|
env.Append(CPPDEFINES=["NDEBUG"])
|
|
env.Append(LINKFLAGS=["-Os"])
|
|
|
|
if can_vectorize:
|
|
env.Append(CCFLAGS=["-ftree-vectorize"])
|
|
if env["target"] == "release_debug":
|
|
env.Append(CPPDEFINES=["DEBUG_ENABLED"])
|
|
elif env["target"] == "debug":
|
|
env.Append(LINKFLAGS=["-O0"])
|
|
env.Append(CCFLAGS=["-O0", "-g", "-fno-limit-debug-info"])
|
|
env.Append(CPPDEFINES=["_DEBUG", "DEBUG_ENABLED", "DEBUG_MEMORY_ENABLED"])
|
|
env.Append(CPPFLAGS=["-UNDEBUG"])
|
|
|
|
# Compiler configuration
|
|
|
|
env["SHLIBSUFFIX"] = ".so"
|
|
|
|
if env["PLATFORM"] == "win32":
|
|
env.Tool("gcc")
|
|
env.use_windows_spawn_fix()
|
|
|
|
if sys.platform.startswith("linux"):
|
|
host_subpath = "linux-x86_64"
|
|
elif sys.platform.startswith("darwin"):
|
|
host_subpath = "darwin-x86_64"
|
|
elif sys.platform.startswith("win"):
|
|
if platform.machine().endswith("64"):
|
|
host_subpath = "windows-x86_64"
|
|
else:
|
|
host_subpath = "windows"
|
|
|
|
compiler_path = env["ANDROID_NDK_ROOT"] + "/toolchains/llvm/prebuilt/" + host_subpath + "/bin"
|
|
gcc_toolchain_path = env["ANDROID_NDK_ROOT"] + "/toolchains/" + target_subpath + "/prebuilt/" + host_subpath
|
|
tools_path = gcc_toolchain_path + "/" + abi_subpath + "/bin"
|
|
|
|
# For Clang to find NDK tools in preference of those system-wide
|
|
env.PrependENVPath("PATH", tools_path)
|
|
|
|
ccache_path = os.environ.get("CCACHE")
|
|
if ccache_path is None:
|
|
env["CC"] = compiler_path + "/clang"
|
|
env["CXX"] = compiler_path + "/clang++"
|
|
else:
|
|
# there aren't any ccache wrappers available for Android,
|
|
# to enable caching we need to prepend the path to the ccache binary
|
|
env["CC"] = ccache_path + " " + compiler_path + "/clang"
|
|
env["CXX"] = ccache_path + " " + compiler_path + "/clang++"
|
|
env["AR"] = tools_path + "/ar"
|
|
env["RANLIB"] = tools_path + "/ranlib"
|
|
env["AS"] = tools_path + "/as"
|
|
|
|
common_opts = ["-fno-integrated-as", "-gcc-toolchain", gcc_toolchain_path]
|
|
|
|
# Compile flags
|
|
|
|
env.Append(CPPFLAGS=["-isystem", env["ANDROID_NDK_ROOT"] + "/sources/cxx-stl/llvm-libc++/include"])
|
|
env.Append(CPPFLAGS=["-isystem", env["ANDROID_NDK_ROOT"] + "/sources/cxx-stl/llvm-libc++abi/include"])
|
|
|
|
# Disable exceptions and rtti on non-tools (template) builds
|
|
if env["tools"]:
|
|
env.Append(CXXFLAGS=["-frtti"])
|
|
else:
|
|
env.Append(CXXFLAGS=["-fno-rtti", "-fno-exceptions"])
|
|
# Don't use dynamic_cast, necessary with no-rtti.
|
|
env.Append(CPPDEFINES=["NO_SAFE_CAST"])
|
|
|
|
lib_sysroot = env["ANDROID_NDK_ROOT"] + "/platforms/" + env["ndk_platform"] + "/" + env["ARCH"]
|
|
|
|
# Using NDK unified headers (NDK r15+)
|
|
sysroot = env["ANDROID_NDK_ROOT"] + "/sysroot"
|
|
env.Append(CPPFLAGS=["--sysroot=" + sysroot])
|
|
env.Append(CPPFLAGS=["-isystem", sysroot + "/usr/include/" + abi_subpath])
|
|
env.Append(CPPFLAGS=["-isystem", env["ANDROID_NDK_ROOT"] + "/sources/android/support/include"])
|
|
# For unified headers this define has to be set manually
|
|
env.Append(CPPDEFINES=[("__ANDROID_API__", str(get_platform(env["ndk_platform"])))])
|
|
|
|
env.Append(
|
|
CCFLAGS="-fpic -ffunction-sections -funwind-tables -fstack-protector-strong -fvisibility=hidden -fno-strict-aliasing".split()
|
|
)
|
|
env.Append(CPPDEFINES=["NO_STATVFS", "GLES_ENABLED"])
|
|
|
|
env["neon_enabled"] = False
|
|
if env["android_arch"] == "x86":
|
|
target_opts = ["-target", "i686-none-linux-android"]
|
|
# The NDK adds this if targeting API < 21, so we can drop it when Godot targets it at least
|
|
env.Append(CCFLAGS=["-mstackrealign"])
|
|
|
|
elif env["android_arch"] == "x86_64":
|
|
target_opts = ["-target", "x86_64-none-linux-android"]
|
|
|
|
elif env["android_arch"] == "armv7":
|
|
target_opts = ["-target", "armv7-none-linux-androideabi"]
|
|
env.Append(CCFLAGS="-march=armv7-a -mfloat-abi=softfp".split())
|
|
env.Append(CPPDEFINES=["__ARM_ARCH_7__", "__ARM_ARCH_7A__"])
|
|
if env["android_neon"]:
|
|
env["neon_enabled"] = True
|
|
env.Append(CCFLAGS=["-mfpu=neon"])
|
|
env.Append(CPPDEFINES=["__ARM_NEON__"])
|
|
else:
|
|
env.Append(CCFLAGS=["-mfpu=vfpv3-d16"])
|
|
|
|
elif env["android_arch"] == "arm64v8":
|
|
target_opts = ["-target", "aarch64-none-linux-android"]
|
|
env.Append(CCFLAGS=["-mfix-cortex-a53-835769"])
|
|
env.Append(CPPDEFINES=["__ARM_ARCH_8A__"])
|
|
|
|
env.Append(CCFLAGS=target_opts)
|
|
env.Append(CCFLAGS=common_opts)
|
|
|
|
# Link flags
|
|
|
|
ndk_version = get_ndk_version(env["ANDROID_NDK_ROOT"])
|
|
if ndk_version != None and LooseVersion(ndk_version) >= LooseVersion("17.1.4828580"):
|
|
env.Append(LINKFLAGS=["-Wl,--exclude-libs,libgcc.a", "-Wl,--exclude-libs,libatomic.a", "-nostdlib++"])
|
|
else:
|
|
env.Append(
|
|
LINKFLAGS=[
|
|
env["ANDROID_NDK_ROOT"] + "/sources/cxx-stl/llvm-libc++/libs/" + arch_subpath + "/libandroid_support.a"
|
|
]
|
|
)
|
|
env.Append(LINKFLAGS=["-shared", "--sysroot=" + lib_sysroot, "-Wl,--warn-shared-textrel"])
|
|
env.Append(LIBPATH=[env["ANDROID_NDK_ROOT"] + "/sources/cxx-stl/llvm-libc++/libs/" + arch_subpath + "/"])
|
|
env.Append(
|
|
LINKFLAGS=[env["ANDROID_NDK_ROOT"] + "/sources/cxx-stl/llvm-libc++/libs/" + arch_subpath + "/libc++_shared.so"]
|
|
)
|
|
|
|
if env["android_arch"] == "armv7":
|
|
env.Append(LINKFLAGS="-Wl,--fix-cortex-a8".split())
|
|
env.Append(LINKFLAGS="-Wl,--no-undefined -Wl,-z,noexecstack -Wl,-z,relro -Wl,-z,now".split())
|
|
env.Append(LINKFLAGS="-Wl,-soname,libgodot_android.so -Wl,--gc-sections".split())
|
|
|
|
env.Append(LINKFLAGS=target_opts)
|
|
env.Append(LINKFLAGS=common_opts)
|
|
|
|
env.Append(
|
|
LIBPATH=[
|
|
env["ANDROID_NDK_ROOT"]
|
|
+ "/toolchains/"
|
|
+ target_subpath
|
|
+ "/prebuilt/"
|
|
+ host_subpath
|
|
+ "/lib/gcc/"
|
|
+ abi_subpath
|
|
+ "/4.9.x"
|
|
]
|
|
)
|
|
env.Append(
|
|
LIBPATH=[
|
|
env["ANDROID_NDK_ROOT"]
|
|
+ "/toolchains/"
|
|
+ target_subpath
|
|
+ "/prebuilt/"
|
|
+ host_subpath
|
|
+ "/"
|
|
+ abi_subpath
|
|
+ "/lib"
|
|
]
|
|
)
|
|
|
|
env.Prepend(CPPPATH=["#platform/android"])
|
|
env.Append(CPPDEFINES=["ANDROID_ENABLED", "UNIX_ENABLED", "NO_FCNTL"])
|
|
env.Append(LIBS=["OpenSLES", "EGL", "GLESv3", "GLESv2", "android", "log", "z", "dl"])
|
|
|
|
|
|
# Return NDK version string in source.properties (adapted from the Chromium project).
|
|
def get_ndk_version(path):
|
|
if path is None:
|
|
return None
|
|
prop_file_path = os.path.join(path, "source.properties")
|
|
try:
|
|
with open(prop_file_path) as prop_file:
|
|
for line in prop_file:
|
|
key_value = list(map(lambda x: x.strip(), line.split("=")))
|
|
if key_value[0] == "Pkg.Revision":
|
|
return key_value[1]
|
|
except:
|
|
print("Could not read source prop file '%s'" % prop_file_path)
|
|
return None
|