Skip to content

Troubleshooting

Common Build Issues

Android

Problem: Gradle version mismatch 

# Solution: Use Gradle wrapper
cd common
./gradlew --version
./gradlew clean build

Problem: Dependency resolution failures 

# Solution: Clear Gradle cache
rm -rf ~/.gradle/caches/
./gradlew clean build --refresh-dependencies

iOS

Problem: SPM package resolution fails 

# Solution: Clear SPM cache and re-resolve
./script/build_ios.sh -pP

Problem: Header generation timeout 

# Solution: Increase timeout
./script/build_ios.sh -H -t 120

Problem: Xcode build fails 

# Solution: Clean derived data
rm -rf ios/build/DerivedData
./script/build_ios.sh -cb

Problem: Godot version mismatch when using a custom godot.dir 

# The GODOT_VERSION file in the configured directory must match
# the godotVersion property in common/config/config.properties.
# Solution: remove and re-download Godot into the configured directory
./script/build_ios.sh -gG

Problem: Build cannot find Godot headers after setting godot.dir 

# Verify the path is set correctly in common/local.properties:
#   godot.dir=/your/custom/path
# Then re-generate headers:
./script/build_ios.sh -H

Problem: "No such module" errors 

# Solution: Ensure packages are added and resolved
./script/build_ios.sh -pP

Getting Help