Infuseting
/
Skills
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Skills/godot-headless-workflow/references/exporting.md

4.7 KiB
Raw Blame History

CLI Export Pipeline (Android / iOS / Desktop)

Export from CI or an agent shell with zero editor interaction, once presets exist.

One-Time Setup Per Machine

  1. Export templates matching the engine version must be installed — per host:
    • Windows: %APPDATA%\Godot\export_templates\<version>\
    • Linux: ~/.local/share/godot/export_templates/<version>/
    • macOS: ~/Library/Application Support/Godot/export_templates/<version>/ Install via any editor's Manage Export Templates UI once, or copy manually.
  2. Android toolchain (per build host): JDK 17, Android SDK with build-tools/platform-tools, debug keystore. Typical ANDROID_HOME: %LOCALAPPDATA%\Android\Sdk (Windows), ~/Android/Sdk (Linux).
  3. iOS builds always finish on macOS/Xcode — see iOS section. Generating the Xcode project folder itself works fine from Windows or Linux.

Presets (export_presets.cfg)

Create presets once (editor UI is fine) or write entries by hand. Minimal skeletons:

[preset.0]
name="Windows Desktop"
platform="Windows Desktop"
export_path="builds/win/game.exe"

[preset.1]
name="Android"
platform="Android"
export_path="builds/android/game.aab"
gradle_build/use_gradle_build=true        # REQUIRED for native plugins (RevenueCat etc.)
package/unique_name="com.yourstudio.game"

[preset.2]
name="iOS"
platform="iOS"
export_path="builds/ios/game.xcodeproj"

After hand-editing presets, validate with a real export — typos fail at export time.

Commands

# Debug build (faster, includes debugger; use for device testing during dev)
godot --headless --path . --export-debug "Android" builds/android/debug.apk

# Release build (store submission)
godot --headless --path . --export-release "Windows Desktop" builds/win/game.exe
godot --headless --path . --export-release "Android" builds/android/game.aab    # AAB = Play Store
godot --headless --path . --export-release "Android" builds/android/game.apk    # APK = sideload/Galaxy Store
godot --headless --path . --export-release "iOS" builds/ios/                     # Xcode project folder

Exit code 0 + file exists = success. On failure read the FULL log — export errors cascade (missing template → missing SDK → signing failure).

Android Signing

Debug keystore is automatic. For release:

keytool -genkeypair -v -keystore release.keystore -alias game -keyalg RSA -validity 10000

export GODOT_ANDROID_KEYSTORE_PATH=/abs/path/release.keystore
export GODOT_ANDROID_KEYSTORE_USER=game
export GODOT_ANDROID_KEYSTORE_PASSWORD=secret
godot --headless --path . --export-release "Android" builds/android/game.aab

Guard the keystore like a password — losing it means losing app-signing continuity on Play. Keep one shared release keystore in sync between your Windows and Linux machines (password manager / secure transfer); signing with different keystores breaks update compatibility.

Gradle Build Notes

Native Android plugins (RevenueCat, ads, Firebase…) require Gradle Build enabled in the preset. First gradle build downloads dependencies (slow); subsequent builds cache. If gradle fails, check: JDK version (17), ANDROID_HOME, and that plugin versions are mutually compatible.

iOS Pipeline

The export produces an Xcode project folder (not an IPA):

godot --headless --path . --export-release "iOS" builds/ios/
# → builds/ios/ contains .xcodeproj — open on macOS, set team/signing, Product → Archive

No Mac? Options: GitHub Actions macos-* runner, Codemagic, or borrow a Mac for a single archive session. Set bundle identifier, version, and signing before archiving.

Store Submission Checklist (Shipaton-relevant)

  • Icon 1024×1024 PNG exported from the icon preset
  • Screenshot 1179×2556 px frameless (Devpost requirement) — capture from emulator/device, not editor viewport
  • version/code bumped every Play upload; iOS CFBundleVersion too
  • Privacy policy URL + data-safety forms (purchases ⇒ declare IAP)
  • IAP products created in store consoles BEFORE RevenueCat mirrors them
  • Internal testing track first: verify purchase + restore flow on real device
  • Submit days before deadline — review queues stretch unpredictably

Troubleshooting

Error Cause Fix
No export template found Version mismatch Install templates matching exact engine version
Gradle: SDK location not found Env Set ANDROID_HOME, accept licenses
Plugin listed but "not enabled" Preset toggle Enable plugin checkbox per preset (both platforms!)
AAB rejected: versionCode lower Increment Bump version/code in preset
iOS archive fails: signing Team/capabilities Set development team in exported Xcode project