2014-02-10 02:10:30 +01:00
|
|
|
import os
|
|
|
|
import sys
|
2018-08-24 02:03:57 +02:00
|
|
|
from methods import detect_darwin_sdk_path
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-03-30 08:28:32 +02:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
def is_active():
|
2016-10-30 18:44:57 +01:00
|
|
|
return True
|
2014-05-01 14:53:37 +02:00
|
|
|
|
2016-10-30 19:05:14 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
def get_name():
|
2016-10-30 18:44:57 +01:00
|
|
|
return "iOS"
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2016-10-30 19:05:14 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
def can_build():
|
2020-03-30 08:28:32 +02:00
|
|
|
if sys.platform == "darwin" or ("OSXCROSS_IOS" in os.environ):
|
2016-10-30 18:44:57 +01:00
|
|
|
return True
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2016-10-30 18:44:57 +01:00
|
|
|
return False
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2016-10-30 19:05:14 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
def get_opts():
|
2017-09-25 06:37:17 +02:00
|
|
|
from SCons.Variables import BoolVariable
|
2020-03-30 08:28:32 +02:00
|
|
|
|
2016-10-30 18:44:57 +01:00
|
|
|
return [
|
2020-03-30 08:28:32 +02:00
|
|
|
(
|
2022-07-20 08:28:22 +02:00
|
|
|
"IOS_TOOLCHAIN_PATH",
|
|
|
|
"Path to iOS toolchain",
|
2020-03-30 08:28:32 +02:00
|
|
|
"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain",
|
|
|
|
),
|
2022-07-20 08:28:22 +02:00
|
|
|
("IOS_SDK_PATH", "Path to the iOS SDK", ""),
|
2021-01-18 08:52:43 +01:00
|
|
|
BoolVariable("ios_simulator", "Build for iOS Simulator", False),
|
2020-03-30 08:28:32 +02:00
|
|
|
BoolVariable("ios_exceptions", "Enable exceptions", False),
|
|
|
|
("ios_triple", "Triple for ios toolchain", ""),
|
2016-10-30 18:44:57 +01:00
|
|
|
]
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2016-10-30 19:05:14 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
def get_flags():
|
2016-10-30 18:44:57 +01:00
|
|
|
return [
|
2021-12-16 02:38:10 +01:00
|
|
|
("arch", "arm64"), # Default for convenience.
|
2020-03-30 08:28:32 +02:00
|
|
|
("tools", False),
|
2021-08-12 13:24:54 +02:00
|
|
|
("use_volk", False),
|
2016-10-30 18:44:57 +01:00
|
|
|
]
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
|
|
|
|
def configure(env):
|
2021-12-16 02:38:10 +01:00
|
|
|
# Validate arch.
|
|
|
|
supported_arches = ["x86_64", "arm64"]
|
|
|
|
if env["arch"] not in supported_arches:
|
|
|
|
print(
|
|
|
|
'Unsupported CPU architecture "%s" for iOS. Supported architectures are: %s.'
|
|
|
|
% (env["arch"], ", ".join(supported_arches))
|
|
|
|
)
|
|
|
|
sys.exit()
|
|
|
|
|
2017-06-30 19:21:38 +02:00
|
|
|
## Build type
|
2016-10-30 18:44:57 +01:00
|
|
|
|
2020-03-30 08:28:32 +02:00
|
|
|
if env["target"].startswith("release"):
|
2022-09-23 14:49:11 +02:00
|
|
|
env.Append(CPPDEFINES=[("NS_BLOCK_ASSERTIONS", 1)])
|
2020-03-30 08:28:32 +02:00
|
|
|
if env["optimize"] == "speed": # optimize for speed (default)
|
2022-04-18 21:04:24 +02:00
|
|
|
# `-O2` is more friendly to debuggers than `-O3`, leading to better crash backtraces
|
|
|
|
# when using `target=release_debug`.
|
|
|
|
opt = "-O3" if env["target"] == "release" else "-O2"
|
2022-09-23 13:55:00 +02:00
|
|
|
env.Append(CCFLAGS=[opt])
|
2022-04-18 21:04:24 +02:00
|
|
|
env.Append(LINKFLAGS=[opt])
|
2021-03-13 15:29:55 +01:00
|
|
|
elif env["optimize"] == "size": # optimize for size
|
2022-09-23 13:55:00 +02:00
|
|
|
env.Append(CCFLAGS=["-Os"])
|
2020-03-30 08:28:32 +02:00
|
|
|
env.Append(LINKFLAGS=["-Os"])
|
2016-10-30 18:44:57 +01:00
|
|
|
|
2020-03-30 08:28:32 +02:00
|
|
|
elif env["target"] == "debug":
|
2022-09-23 14:49:11 +02:00
|
|
|
env.Append(CCFLAGS=["-g", "-O0"])
|
2017-06-30 19:21:38 +02:00
|
|
|
|
2022-09-13 17:01:47 +02:00
|
|
|
## LTO
|
|
|
|
|
|
|
|
if env["lto"] == "auto": # Disable by default as it makes linking in Xcode very slow.
|
|
|
|
env["lto"] = "none"
|
|
|
|
|
2022-07-21 15:15:54 +02:00
|
|
|
if env["lto"] != "none":
|
|
|
|
if env["lto"] == "thin":
|
|
|
|
env.Append(CCFLAGS=["-flto=thin"])
|
|
|
|
env.Append(LINKFLAGS=["-flto=thin"])
|
|
|
|
else:
|
|
|
|
env.Append(CCFLAGS=["-flto"])
|
|
|
|
env.Append(LINKFLAGS=["-flto"])
|
2017-11-02 09:11:29 +01:00
|
|
|
|
2017-06-30 19:21:38 +02:00
|
|
|
## Compiler configuration
|
|
|
|
|
2018-12-22 12:31:43 +01:00
|
|
|
# Save this in environment for use by other modules
|
|
|
|
if "OSXCROSS_IOS" in os.environ:
|
|
|
|
env["osxcross"] = True
|
|
|
|
|
2022-07-20 08:28:22 +02:00
|
|
|
env["ENV"]["PATH"] = env["IOS_TOOLCHAIN_PATH"] + "/Developer/usr/bin/:" + env["ENV"]["PATH"]
|
2017-06-30 19:21:38 +02:00
|
|
|
|
2022-07-20 08:28:22 +02:00
|
|
|
compiler_path = "$IOS_TOOLCHAIN_PATH/usr/bin/${ios_triple}"
|
|
|
|
s_compiler_path = "$IOS_TOOLCHAIN_PATH/Developer/usr/bin/"
|
2017-11-10 01:07:28 +01:00
|
|
|
|
|
|
|
ccache_path = os.environ.get("CCACHE")
|
2018-10-27 01:18:15 +02:00
|
|
|
if ccache_path is None:
|
2020-03-30 08:28:32 +02:00
|
|
|
env["CC"] = compiler_path + "clang"
|
|
|
|
env["CXX"] = compiler_path + "clang++"
|
|
|
|
env["S_compiler"] = s_compiler_path + "gcc"
|
2017-11-10 01:07:28 +01:00
|
|
|
else:
|
|
|
|
# there aren't any ccache wrappers available for iOS,
|
|
|
|
# to enable caching we need to prepend the path to the ccache binary
|
2020-03-30 08:28:32 +02:00
|
|
|
env["CC"] = ccache_path + " " + compiler_path + "clang"
|
|
|
|
env["CXX"] = ccache_path + " " + compiler_path + "clang++"
|
|
|
|
env["S_compiler"] = ccache_path + " " + s_compiler_path + "gcc"
|
|
|
|
env["AR"] = compiler_path + "ar"
|
|
|
|
env["RANLIB"] = compiler_path + "ranlib"
|
2017-06-30 19:21:38 +02:00
|
|
|
|
|
|
|
## Compile flags
|
|
|
|
|
2021-01-18 08:52:43 +01:00
|
|
|
if env["ios_simulator"]:
|
2022-07-20 08:28:22 +02:00
|
|
|
detect_darwin_sdk_path("iossimulator", env)
|
2022-07-01 10:29:21 +02:00
|
|
|
env.Append(ASFLAGS=["-mios-simulator-version-min=13.0"])
|
2021-01-18 08:52:43 +01:00
|
|
|
env.Append(CCFLAGS=["-mios-simulator-version-min=13.0"])
|
|
|
|
env.extra_suffix = ".simulator" + env.extra_suffix
|
|
|
|
else:
|
2022-07-20 08:28:22 +02:00
|
|
|
detect_darwin_sdk_path("ios", env)
|
2022-07-01 10:29:21 +02:00
|
|
|
env.Append(ASFLAGS=["-miphoneos-version-min=11.0"])
|
2021-01-18 08:52:43 +01:00
|
|
|
env.Append(CCFLAGS=["-miphoneos-version-min=11.0"])
|
|
|
|
|
2021-12-10 17:11:37 +01:00
|
|
|
if env["arch"] == "x86_64":
|
2022-09-11 11:21:41 +02:00
|
|
|
if not env["ios_simulator"]:
|
|
|
|
print("ERROR: Building for iOS with 'arch=x86_64' requires 'ios_simulator=yes'.")
|
|
|
|
sys.exit(255)
|
|
|
|
|
2020-03-30 08:28:32 +02:00
|
|
|
env["ENV"]["MACOSX_DEPLOYMENT_TARGET"] = "10.9"
|
|
|
|
env.Append(
|
|
|
|
CCFLAGS=(
|
2021-12-10 17:11:37 +01:00
|
|
|
"-fobjc-arc -arch x86_64"
|
|
|
|
" -fobjc-abi-version=2 -fobjc-legacy-dispatch -fmessage-length=0 -fpascal-strings -fblocks"
|
2022-07-20 08:28:22 +02:00
|
|
|
" -fasm-blocks -isysroot $IOS_SDK_PATH"
|
2020-03-30 08:28:32 +02:00
|
|
|
).split()
|
|
|
|
)
|
2022-07-01 10:29:21 +02:00
|
|
|
env.Append(ASFLAGS=["-arch", "x86_64"])
|
2020-03-30 08:28:32 +02:00
|
|
|
elif env["arch"] == "arm64":
|
|
|
|
env.Append(
|
2020-07-26 19:38:10 +02:00
|
|
|
CCFLAGS=(
|
2020-10-01 21:18:39 +02:00
|
|
|
"-fobjc-arc -arch arm64 -fmessage-length=0 -fno-strict-aliasing"
|
2020-07-26 19:38:10 +02:00
|
|
|
" -fdiagnostics-print-source-range-info -fdiagnostics-show-category=id -fdiagnostics-parseable-fixits"
|
2021-01-18 08:52:43 +01:00
|
|
|
" -fpascal-strings -fblocks -fvisibility=hidden -MMD -MT dependencies"
|
2022-07-20 08:28:22 +02:00
|
|
|
" -isysroot $IOS_SDK_PATH".split()
|
2020-07-26 19:38:10 +02:00
|
|
|
)
|
2020-03-30 08:28:32 +02:00
|
|
|
)
|
2022-07-01 10:29:21 +02:00
|
|
|
env.Append(ASFLAGS=["-arch", "arm64"])
|
2020-03-30 08:28:32 +02:00
|
|
|
env.Append(CPPDEFINES=["NEED_LONG_INT"])
|
2016-10-30 18:44:57 +01:00
|
|
|
|
2019-05-20 16:47:32 +02:00
|
|
|
# Disable exceptions on non-tools (template) builds
|
2020-03-30 08:28:32 +02:00
|
|
|
if not env["tools"]:
|
|
|
|
if env["ios_exceptions"]:
|
|
|
|
env.Append(CCFLAGS=["-fexceptions"])
|
2019-05-20 16:47:32 +02:00
|
|
|
else:
|
2020-03-30 08:28:32 +02:00
|
|
|
env.Append(CCFLAGS=["-fno-exceptions"])
|
2017-06-30 19:21:38 +02:00
|
|
|
|
2022-07-20 08:28:22 +02:00
|
|
|
# Temp fix for ABS/MAX/MIN macros in iOS SDK blocking compilation
|
2020-07-15 20:59:57 +02:00
|
|
|
env.Append(CCFLAGS=["-Wno-ambiguous-macro"])
|
|
|
|
|
2020-03-30 08:28:32 +02:00
|
|
|
env.Prepend(
|
2020-08-21 17:40:43 +02:00
|
|
|
CPPPATH=[
|
2022-07-20 08:28:22 +02:00
|
|
|
"$IOS_SDK_PATH/usr/include",
|
|
|
|
"$IOS_SDK_PATH/System/Library/Frameworks/AudioUnit.framework/Headers",
|
2020-08-21 17:40:43 +02:00
|
|
|
]
|
2020-03-30 08:28:32 +02:00
|
|
|
)
|
2016-10-30 18:44:57 +01:00
|
|
|
|
2022-07-20 08:28:22 +02:00
|
|
|
env.Prepend(CPPPATH=["#platform/ios"])
|
|
|
|
env.Append(CPPDEFINES=["IOS_ENABLED", "UNIX_ENABLED", "COREAUDIO_ENABLED"])
|
2020-02-22 06:42:34 +01:00
|
|
|
|
2021-08-12 13:24:54 +02:00
|
|
|
if env["vulkan"]:
|
|
|
|
env.Append(CPPDEFINES=["VULKAN_ENABLED"])
|