GitHub Actions: Test project exporting on CI

This allows finding issues in headless project export early on,
including when exporting for a dedicated server.

We also use this opportunity to check whether the audiovisual output
between the project being run from its files and the exported PCK
matches (it should always be a perfect match, assuming the same GPU
is used for both runs). This can be used to catch audiovisual
discrepancies, which could indicate a bug in the export process.

Author: Calinou

.github/actions/godot-project-export/action.yml

@@ -0,0 +1,60 @@
+name: Export Godot project
+description: Export a test Godot project.
+
+inputs:
+  bin:
+    description: The path to the Godot executable
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - name: Build test GDExtension
+      shell: sh
+      run: |
+        git clone --depth=1 https://github.com/godotengine/godot-cpp.git misc/test_project/addons/test_extension/src/godot-cpp
+        scons target=template_debug
+        scons target=template_release
+
+    - name: Import resources and export project
+      shell: sh
+      run: |
+
+        echo "Exporting project for Linux (PCK)"
+        xvfb-run ${{ inputs.bin }} --headless --path misc/test_project/ --export-pack "Linux" /tmp/test_project.pck 2>&1 | tee log.txt || true
+        misc/scripts/check_ci_log.py log.txt
+
+        echo "Exporting project for Linux (ZIP)"
+        xvfb-run ${{ inputs.bin }} --headless --path misc/test_project/ --export-pack "Linux" /tmp/test_project.zip 2>&1 | tee log.txt || true
+        misc/scripts/check_ci_log.py log.txt
+
+        echo "Exporting project for Linux as dedicated server (PCK)"
+        xvfb-run ${{ inputs.bin }} --headless --path misc/test_project/ --export-pack "Linux Server" /tmp/test_project_server.pck 2>&1 | tee log.txt || true
+        misc/scripts/check_ci_log.py log.txt
+
+    - name: Run project files from folder
+      shell: sh
+      run: |
+        xvfb-run ${{ inputs.bin }} --path misc/test_project/ --audio-driver Dummy --write-movie /tmp/test_project_folder.png --quit
+        # FIXME: Not checked currently, as leaked resources on exit cause CI failures.
+        # misc/scripts/check_ci_log.py log.txt
+
+        xvfb-run ${{ inputs.bin }} --path misc/test_project/ --headless --quit
+
+    - name: Run exported project PCK/ZIP
+      shell: sh
+      run: |
+        xvfb-run ${{ inputs.bin }} --main-pack /tmp/test_project.pck --audio-driver Dummy --write-movie /tmp/test_project_pck.png --quit
+        # FIXME: Not checked currently, as leaked resources on exit cause CI failures.
+        # misc/scripts/check_ci_log.py log.txt
+
+        xvfb-run ${{ inputs.bin }} --main-pack /tmp/test_project.zip --audio-driver Dummy --write-movie /tmp/test_project_zip.png --quit
+
+        # Headless mode is implied for dedicated server PCKs.
+        xvfb-run ${{ inputs.bin }} --main-pack /tmp/test_project_server.pck --quit
+
+        echo "Checking whether video output from project folder and exported project match..."
+        md5sum /tmp/test_project*.png | md5sum --check
+
+        echo "Checking whether audio output from project folder and exported project match..."
+        md5sum /tmp/test_project*.wav | md5sum --check

.github/workflows/linux_builds.yml

@@ -32,6 +32,7 @@ jobs:
             build-mono: true
             doc-test: true
             proj-conv: true
+            proj-export: true
             api-compat: true
             artifact: true
             # Validate godot-cpp compatibility on one arbitrary editor build.
@@ -112,7 +113,7 @@ jobs:
           submodules: recursive
 
       - name: Linux dependencies for tests
-        if: matrix.proj-test
+        if: matrix.proj-test || matrix.proj-export
         run: |
           sudo rm -f /etc/apt/sources.list.d/microsoft-prod.list
           sudo apt-get install mesa-vulkan-drivers
@@ -250,6 +251,13 @@ jobs:
         with:
           bin: ${{ matrix.bin }}
 
+      # Test project export
+      - name: Test project export
+        uses: ./.github/actions/godot-project-export
+        if: matrix.proj-export
+        with:
+          bin: ${{ matrix.bin }}
+
       # Test the project converter
       - name: Test project converter
         uses: ./.github/actions/godot-converter-test

misc/test_project/.gitignore

@@ -0,0 +1,5 @@
+*.dblite
+
+# Ignore the submodule so we don't add it to version control.
+# We clone it on CI when needed instead.
+addons/test_extension/src/godot-cpp

misc/test_project/SConstruct

@@ -0,0 +1,6 @@
+#!/usr/bin/env python
+
+# ruff: noqa: F821
+
+# This file is for building as a Godot GDExtension.
+SConscript("addons/test_extension/SConstruct")

misc/test_project/addons/test_extension/.gitignore

@@ -0,0 +1,23 @@
+# GDExtension generated files
+*.gen.*
+.sconsign*.dblite
+bin/
+compile_commands.json
+src/gen/
+
+# Compiled files
+*.bc
+*.creator
+*.creator.user
+*.dblite
+*.exp
+*.files
+*.idb
+*.includes
+*.lib
+*.o
+*.os
+*.pdb
+*.pyc
+*.so
+*.obj

misc/test_project/addons/test_extension/SConstruct

@@ -0,0 +1,56 @@
+#!/usr/bin/env python
+
+# ruff: noqa: F821
+
+# This file is for building as a Godot GDExtension.
+
+env = SConscript("src/godot-cpp/SConstruct")
+
+# Add source files.
+env.Append(CPPPATH=["src/"])
+sources = Glob("src/*.cpp")
+
+env.Append(CPPDEFINES=["GDEXTENSION"])
+
+bin_path = "bin/"
+extension_name = "test_extension"
+debug_or_release = "release" if env["target"] == "template_release" else "debug"
+
+if "arch_suffix" not in env:
+    env["arch_suffix"] = env["arch"]
+
+if env["target"] in ["editor", "template_debug"]:
+    # GDExtension has editor classes available in debug templates, which allows editor code to compile.
+    # If you don't want to compile editor stuff in templates, move these 2 lines to a separate "if" block.
+    env.Append(CPPPATH=["src/editor/"])
+    sources += Glob("src/editor/*.cpp")
+    # Add documentation XML files as a generated cpp file. Only works in Godot 4.3+.
+    doc_data = env.GodotCPPDocData("src/gen/doc_data.gen.cpp", source=Glob("doc_classes/*.xml"))
+    sources.append(doc_data)
+
+# Create the library target (e.g. libtest_extension.linux.debug.x86_64.so).
+if env["platform"] == "macos":
+    library = env.SharedLibrary(
+        "{0}/lib{1}.{2}.{3}.framework/{1}.{2}.{3}".format(
+            bin_path,
+            extension_name,
+            env["platform"],
+            debug_or_release,
+        ),
+        source=sources,
+    )
+else:
+    library = env.SharedLibrary(
+        "{}/{}{}.{}.{}.{}{}".format(
+            bin_path,
+            env.subst("$SHLIBPREFIX"),
+            extension_name,
+            env["platform"],
+            debug_or_release,
+            env["arch_suffix"],
+            env["SHLIBSUFFIX"],
+        ),
+        source=sources,
+    )
+
+Default(library)

misc/test_project/addons/test_extension/doc_classes/ExampleNode.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<class name="ExampleNode" inherits="Node" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
+	<brief_description>
+		GDExtension example node.
+	</brief_description>
+	<description>
+		An example node that demonstrates how to create a node in [GDExtension], which can be compiled and loaded by [GDExtensionManager]. This example node can also be compiled as an engine module, if that option was selected in the editor when creating the GDExtension.
+	</description>
+	<tutorials>
+		<link title="GDExtension overview">$DOCS_URL/tutorials/scripting/gdextension/what_is_gdextension.html</link>
+		<link title="GDExtension example in C++">$DOCS_URL/tutorials/scripting/gdextension/gdextension_cpp_example.html</link>
+	</tutorials>
+	<methods>
+		<method name="print_hello" qualifiers="const">
+			<return type="void" />
+			<description>
+				Prints either [code]"Hello, World! From GDExtension."[/code] if compiled as GDExtension or [code]"Hello, World! From a module."[/code] if compiled as a module, determined by the [code]#if[/code] directives in the C++ code.
+			</description>
+		</method>
+		<method name="return_hello" qualifiers="const">
+			<return type="String" />
+			<description>
+				Returns either [code]"Hello, World! From GDExtension."[/code] if compiled as GDExtension or [code]"Hello, World! From a module."[/code] if compiled as a module, determined by the [code]#if[/code] directives in the C++ code. If neither a module or extension, the code does not compile.
+			</description>
+		</method>
+	</methods>
+</class>

misc/test_project/addons/test_extension/icons/ExampleNode.svg

@@ -0,0 +1,43 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://c2vqvdr1f7bi"
+path="res://.godot/imported/ExampleNode.svg-ef666cf6c5f1fff2a869dcc1fef33b50.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/test_extension/icons/ExampleNode.svg"
+dest_files=["res://.godot/imported/ExampleNode.svg-ef666cf6c5f1fff2a869dcc1fef33b50.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/uastc_level=0
+compress/rdo_quality_loss=0.0
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/channel_remap/red=0
+process/channel_remap/green=1
+process/channel_remap/blue=2
+process/channel_remap/alpha=3
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=4.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false

misc/test_project/addons/test_extension/icons/ExampleNode.svg.import

@@ -0,0 +1 @@
+