39facb35a0
Implements https://github.com/godotengine/godot-proposals/issues/3371. New `target` presets ==================== The `tools` option is removed and `target` changes to use three new presets, which match the builds users are familiar with. These targets control the default optimization level and enable editor-specific and debugging code: - `editor`: Replaces `tools=yes target=release_debug`. * Defines: `TOOLS_ENABLED`, `DEBUG_ENABLED`, `-O2`/`/O2` - `template_debug`: Replaces `tools=no target=release_debug`. * Defines: `DEBUG_ENABLED`, `-O2`/`/O2` - `template_release`: Replaces `tools=no target=release`. * Defines: `-O3`/`/O2` New `dev_build` option ====================== The previous `target=debug` is now replaced by a separate `dev_build=yes` option, which can be used in combination with either of the three targets, and changes the following: - `dev_build`: Defines `DEV_ENABLED`, disables optimization (`-O0`/`/0d`), enables generating debug symbols, does not define `NDEBUG` so `assert()` works in thirdparty libraries, adds a `.dev` suffix to the binary name. Note: Unlike previously, `dev_build` defaults to off so that users who compile Godot from source get an optimized and small build by default. Engine contributors should now set `dev_build=yes` in their build scripts or IDE configuration manually. Changed binary names ==================== The name of generated binaries and object files are changed too, to follow this format: `godot.<platform>.<target>[.dev][.double].<arch>[.<extra_suffix>][.<ext>]` For example: - `godot.linuxbsd.editor.dev.arm64` - `godot.windows.template_release.double.x86_64.mono.exe` Be sure to update your links/scripts/IDE config accordingly. More flexible `optimize` and `debug_symbols` options ==================================================== The optimization level and whether to generate debug symbols can be further specified with the `optimize` and `debug_symbols` options. So the default values listed above for the various `target` and `dev_build` combinations are indicative and can be replaced when compiling, e.g.: `scons p=linuxbsd target=template_debug dev_build=yes optimize=debug` will make a "debug" export template with dev-only code enabled, `-Og` optimization level for GCC/Clang, and debug symbols. Perfect for debugging complex crashes at runtime in an exported project.
127 lines
4.3 KiB
Python
127 lines
4.3 KiB
Python
import os, json
|
|
|
|
from SCons.Util import WhereIs
|
|
|
|
|
|
def run_closure_compiler(target, source, env, for_signature):
|
|
closure_bin = os.path.join(os.path.dirname(WhereIs("emcc")), "node_modules", ".bin", "google-closure-compiler")
|
|
cmd = [WhereIs("node"), closure_bin]
|
|
cmd.extend(["--compilation_level", "ADVANCED_OPTIMIZATIONS"])
|
|
for f in env["JSEXTERNS"]:
|
|
cmd.extend(["--externs", f.get_abspath()])
|
|
for f in source:
|
|
cmd.extend(["--js", f.get_abspath()])
|
|
cmd.extend(["--js_output_file", target[0].get_abspath()])
|
|
return " ".join(cmd)
|
|
|
|
|
|
def get_build_version():
|
|
import version
|
|
|
|
name = "custom_build"
|
|
if os.getenv("BUILD_NAME") != None:
|
|
name = os.getenv("BUILD_NAME")
|
|
v = "%d.%d" % (version.major, version.minor)
|
|
if version.patch > 0:
|
|
v += ".%d" % version.patch
|
|
status = version.status
|
|
if os.getenv("GODOT_VERSION_STATUS") != None:
|
|
status = str(os.getenv("GODOT_VERSION_STATUS"))
|
|
v += ".%s.%s" % (status, name)
|
|
return v
|
|
|
|
|
|
def create_engine_file(env, target, source, externs):
|
|
if env["use_closure_compiler"]:
|
|
return env.BuildJS(target, source, JSEXTERNS=externs)
|
|
return env.Textfile(target, [env.File(s) for s in source])
|
|
|
|
|
|
def create_template_zip(env, js, wasm, worker, side):
|
|
binary_name = "godot.editor" if env.editor_build else "godot"
|
|
zip_dir = env.Dir("#bin/.web_zip")
|
|
in_files = [
|
|
js,
|
|
wasm,
|
|
worker,
|
|
"#platform/web/js/libs/audio.worklet.js",
|
|
]
|
|
out_files = [
|
|
zip_dir.File(binary_name + ".js"),
|
|
zip_dir.File(binary_name + ".wasm"),
|
|
zip_dir.File(binary_name + ".worker.js"),
|
|
zip_dir.File(binary_name + ".audio.worklet.js"),
|
|
]
|
|
# Dynamic linking (extensions) specific.
|
|
if env["dlink_enabled"]:
|
|
in_files.append(side) # Side wasm (contains the actual Godot code).
|
|
out_files.append(zip_dir.File(binary_name + ".side.wasm"))
|
|
|
|
service_worker = "#misc/dist/html/service-worker.js"
|
|
if env.editor_build:
|
|
# HTML
|
|
html = "#misc/dist/html/editor.html"
|
|
cache = [
|
|
"godot.editor.html",
|
|
"offline.html",
|
|
"godot.editor.js",
|
|
"godot.editor.worker.js",
|
|
"godot.editor.audio.worklet.js",
|
|
"logo.svg",
|
|
"favicon.png",
|
|
]
|
|
opt_cache = ["godot.editor.wasm"]
|
|
subst_dict = {
|
|
"@GODOT_VERSION@": get_build_version(),
|
|
"@GODOT_NAME@": "GodotEngine",
|
|
"@GODOT_CACHE@": json.dumps(cache),
|
|
"@GODOT_OPT_CACHE@": json.dumps(opt_cache),
|
|
"@GODOT_OFFLINE_PAGE@": "offline.html",
|
|
}
|
|
html = env.Substfile(target="#bin/godot${PROGSUFFIX}.html", source=html, SUBST_DICT=subst_dict)
|
|
in_files.append(html)
|
|
out_files.append(zip_dir.File(binary_name + ".html"))
|
|
# And logo/favicon
|
|
in_files.append("#misc/dist/html/logo.svg")
|
|
out_files.append(zip_dir.File("logo.svg"))
|
|
in_files.append("#icon.png")
|
|
out_files.append(zip_dir.File("favicon.png"))
|
|
# PWA
|
|
service_worker = env.Substfile(
|
|
target="#bin/godot${PROGSUFFIX}.service.worker.js", source=service_worker, SUBST_DICT=subst_dict
|
|
)
|
|
in_files.append(service_worker)
|
|
out_files.append(zip_dir.File("service.worker.js"))
|
|
in_files.append("#misc/dist/html/manifest.json")
|
|
out_files.append(zip_dir.File("manifest.json"))
|
|
in_files.append("#misc/dist/html/offline.html")
|
|
out_files.append(zip_dir.File("offline.html"))
|
|
else:
|
|
# HTML
|
|
in_files.append("#misc/dist/html/full-size.html")
|
|
out_files.append(zip_dir.File(binary_name + ".html"))
|
|
in_files.append(service_worker)
|
|
out_files.append(zip_dir.File(binary_name + ".service.worker.js"))
|
|
in_files.append("#misc/dist/html/offline-export.html")
|
|
out_files.append(zip_dir.File("godot.offline.html"))
|
|
|
|
zip_files = env.InstallAs(out_files, in_files)
|
|
env.Zip(
|
|
"#bin/godot",
|
|
zip_files,
|
|
ZIPROOT=zip_dir,
|
|
ZIPSUFFIX="${PROGSUFFIX}${ZIPSUFFIX}",
|
|
ZIPCOMSTR="Archiving $SOURCES as $TARGET",
|
|
)
|
|
|
|
|
|
def add_js_libraries(env, libraries):
|
|
env.Append(JS_LIBS=env.File(libraries))
|
|
|
|
|
|
def add_js_pre(env, js_pre):
|
|
env.Append(JS_PRE=env.File(js_pre))
|
|
|
|
|
|
def add_js_externs(env, externs):
|
|
env.Append(JS_EXTERNS=env.File(externs))
|