detect.py 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  1. import os
  2. import sys
  3. from methods import detect_darwin_sdk_path
  4. from typing import TYPE_CHECKING
  5. if TYPE_CHECKING:
  6. from SCons import Environment
  7. def get_name():
  8. return "iOS"
  9. def can_build():
  10. if sys.platform == "darwin" or ("OSXCROSS_IOS" in os.environ):
  11. return True
  12. return False
  13. def get_opts():
  14. from SCons.Variables import BoolVariable
  15. return [
  16. (
  17. "IOS_TOOLCHAIN_PATH",
  18. "Path to iOS toolchain",
  19. "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain",
  20. ),
  21. ("IOS_SDK_PATH", "Path to the iOS SDK", ""),
  22. BoolVariable("ios_simulator", "Build for iOS Simulator", False),
  23. ("ios_triple", "Triple for ios toolchain", ""),
  24. ]
  25. def get_doc_classes():
  26. return [
  27. "EditorExportPlatformIOS",
  28. ]
  29. def get_doc_path():
  30. return "doc_classes"
  31. def get_flags():
  32. return [
  33. ("arch", "arm64"), # Default for convenience.
  34. ("target", "template_debug"),
  35. ("use_volk", False),
  36. ("disable_exceptions", True), # Reduces size.
  37. ]
  38. def configure(env: "Environment"):
  39. # Validate arch.
  40. supported_arches = ["x86_64", "arm64"]
  41. if env["arch"] not in supported_arches:
  42. print(
  43. 'Unsupported CPU architecture "%s" for iOS. Supported architectures are: %s.'
  44. % (env["arch"], ", ".join(supported_arches))
  45. )
  46. sys.exit()
  47. ## LTO
  48. if env["lto"] == "auto": # Disable by default as it makes linking in Xcode very slow.
  49. env["lto"] = "none"
  50. if env["lto"] != "none":
  51. if env["lto"] == "thin":
  52. env.Append(CCFLAGS=["-flto=thin"])
  53. env.Append(LINKFLAGS=["-flto=thin"])
  54. else:
  55. env.Append(CCFLAGS=["-flto"])
  56. env.Append(LINKFLAGS=["-flto"])
  57. ## Compiler configuration
  58. # Save this in environment for use by other modules
  59. if "OSXCROSS_IOS" in os.environ:
  60. env["osxcross"] = True
  61. env["ENV"]["PATH"] = env["IOS_TOOLCHAIN_PATH"] + "/Developer/usr/bin/:" + env["ENV"]["PATH"]
  62. compiler_path = "$IOS_TOOLCHAIN_PATH/usr/bin/${ios_triple}"
  63. ccache_path = os.environ.get("CCACHE")
  64. if ccache_path is None:
  65. env["CC"] = compiler_path + "clang"
  66. env["CXX"] = compiler_path + "clang++"
  67. env["S_compiler"] = compiler_path + "clang"
  68. else:
  69. # there aren't any ccache wrappers available for iOS,
  70. # to enable caching we need to prepend the path to the ccache binary
  71. env["CC"] = ccache_path + " " + compiler_path + "clang"
  72. env["CXX"] = ccache_path + " " + compiler_path + "clang++"
  73. env["S_compiler"] = ccache_path + " " + compiler_path + "clang"
  74. env["AR"] = compiler_path + "ar"
  75. env["RANLIB"] = compiler_path + "ranlib"
  76. ## Compile flags
  77. if env["ios_simulator"]:
  78. detect_darwin_sdk_path("iossimulator", env)
  79. env.Append(ASFLAGS=["-mios-simulator-version-min=12.0"])
  80. env.Append(CCFLAGS=["-mios-simulator-version-min=12.0"])
  81. env.extra_suffix = ".simulator" + env.extra_suffix
  82. else:
  83. detect_darwin_sdk_path("ios", env)
  84. env.Append(ASFLAGS=["-miphoneos-version-min=12.0"])
  85. env.Append(CCFLAGS=["-miphoneos-version-min=12.0"])
  86. if env["arch"] == "x86_64":
  87. if not env["ios_simulator"]:
  88. print("ERROR: Building for iOS with 'arch=x86_64' requires 'ios_simulator=yes'.")
  89. sys.exit(255)
  90. env["ENV"]["MACOSX_DEPLOYMENT_TARGET"] = "10.9"
  91. env.Append(
  92. CCFLAGS=(
  93. "-fobjc-arc -arch x86_64"
  94. " -fobjc-abi-version=2 -fobjc-legacy-dispatch -fmessage-length=0 -fpascal-strings -fblocks"
  95. " -fasm-blocks -isysroot $IOS_SDK_PATH"
  96. ).split()
  97. )
  98. env.Append(ASFLAGS=["-arch", "x86_64"])
  99. elif env["arch"] == "arm64":
  100. env.Append(
  101. CCFLAGS=(
  102. "-fobjc-arc -arch arm64 -fmessage-length=0 -fno-strict-aliasing"
  103. " -fdiagnostics-print-source-range-info -fdiagnostics-show-category=id -fdiagnostics-parseable-fixits"
  104. " -fpascal-strings -fblocks -fvisibility=hidden -MMD -MT dependencies"
  105. " -isysroot $IOS_SDK_PATH".split()
  106. )
  107. )
  108. env.Append(ASFLAGS=["-arch", "arm64"])
  109. env.Append(CPPDEFINES=["NEED_LONG_INT"])
  110. # Temp fix for ABS/MAX/MIN macros in iOS SDK blocking compilation
  111. env.Append(CCFLAGS=["-Wno-ambiguous-macro"])
  112. env.Prepend(
  113. CPPPATH=[
  114. "$IOS_SDK_PATH/usr/include",
  115. "$IOS_SDK_PATH/System/Library/Frameworks/AudioUnit.framework/Headers",
  116. ]
  117. )
  118. env.Prepend(CPPPATH=["#platform/ios"])
  119. env.Append(CPPDEFINES=["IOS_ENABLED", "UNIX_ENABLED", "COREAUDIO_ENABLED"])
  120. if env["vulkan"]:
  121. env.Append(CPPDEFINES=["VULKAN_ENABLED"])
  122. if env["opengl3"]:
  123. env.Append(CPPDEFINES=["GLES3_ENABLED", "GLES_SILENCE_DEPRECATION"])
  124. env.Prepend(
  125. CPPPATH=[
  126. "$IOS_SDK_PATH/System/Library/Frameworks/OpenGLES.framework/Headers",
  127. ]
  128. )