Export game Godot ke iOS tanpa punya Mac

Kata dokumentasi, dan apa yang kami lihat

Halaman iOS Godot 4.7 bilang Anda harus export dari Mac yang sudah terpasang Xcode. Dalam test kami, editor di Windows dan Linux tetap menulis proyek Xcode. Keduanya mencetak peringatan ini dan berhenti di situ:

WARNING: Xcode Build: .ipa can only be built on macOS. Leaving Xcode project without building the package.
WARNING: Project export for preset "iOS" completed with warnings.

Kami menyalin setiap proyek ke Mac dan build untuk perangkat. Ketiga build berhasil. Anggap ini jalan pintas yang sudah diuji, bukan fitur resmi. Game test kami tidak punya plugin dan tidak punya kode C#. Source code Godot bilang proyek C# harus export untuk iOS dari macOS.

Langkah 1: export templates

Exporter butuh export templates untuk versi Godot Anda yang persis. Di editor, buka Editor, lalu Manage Export Templates, dan unduh. File 4.7.2 berukuran sekitar 1.3 GB. Di server tanpa layar, ekstrak file .tpz sendiri. Ini folder yang kami pakai:

# macOS
~/Library/Application Support/Godot/export_templates/4.7.2.stable
# Linux
~/.local/share/godot/export_templates/4.7.2.stable
# Windows (Git Bash)
$APPDATA/Godot/export_templates/4.7.2.stable

Langkah 2: preset export iOS

Buka Project, lalu Export, klik Add dan pilih iOS. Dua field wajib diisi. App Store Team ID adalah kode 10 karakter dari akun Apple Developer Anda, bukan nama Anda. Bundle Identifier adalah ID aplikasi Anda, seperti com.example.mygame. Godot menyimpan preset di export_presets.cfg. Ini bagian dari preset kami yang penting:

# export_presets.cfg
[preset.0]
name="iOS"
platform="iOS"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="export/GodotDemo.ipa"

[preset.0.options]
application/app_store_team_id="ABCDE12XYZ"
application/bundle_identifier="com.example.godotdemo"
application/export_project_only=true

# project.godot, two settings the export needed
[application]
config/icon="res://icon.svg"

[rendering]
textures/vram_compression/import_etc2_astc=true

Export Project Only menyuruh Godot menulis proyek Xcode lalu berhenti. Tanpa opsi itu, Godot di Mac menjalankan xcodebuild sendiri untuk membuat archive dan .ipa. Itu butuh signing sungguhan, jadi mulailah dengan proyeknya saja.

Langkah 3: export dari command line

Nama preset ditulis dalam tanda kutip. Path output relatif terhadap folder yang berisi project.godot.

godot --headless --path demo --export-release "iOS" export/GodotDemo.ipa

Export memakan waktu sekitar 9 detik di Linux dan 21 di Windows. Hasilnya GodotDemo.xcodeproj, folder GodotDemo, file .pck berisi data game Anda, dan engine sebagai GodotDemo.xcframework.

Dua error masing-masing menghabiskan satu run kami:

• Tanpa ikon proyek, export gagal dengan Invalid icon (icons/settings_58x58). Atur ikon di Project Settings.
• Tanpa import tekstur ETC2/ASTC, export gagal dengan pesan "configuration errors" yang kosong. Aktifkan Import ETC2 ASTC di Rendering, Textures, VRAM Compression.

Langkah 4: build di Mac

Push folder hasil export ke git, atau salin dengan scp. Di Mac, perintah ini build untuk perangkat dengan signing dimatikan:

xcodebuild -project GodotDemo.xcodeproj -scheme GodotDemo \
  -configuration Release -sdk iphoneos \
  -destination 'generic/platform=iOS' \
  -derivedDataPath build build CODE_SIGNING_ALLOWED=NO

Build selesai dalam waktu kurang dari 25 detik dan menghasilkan aplikasi 82 MB. Untuk rilis, buka GodotDemo.xcodeproj di Xcode. Pilih tim Anda di Signing and Capabilities, lalu pilih Product, lalu Archive. Panduan publish kami membahas upload-nya.

Kendala di Simulator

Build simulator biasa gagal saat link. Template resmi menyertakan library engine simulator hanya untuk Intel (x86_64). Di Mac Apple silicon, Xcode mencari arm64 dan berhenti dengan error ini:

Undefined symbols for architecture arm64:
  "_main", referenced from:

Build untuk x86_64 berhasil. Aplikasinya lalu jalan di simulator iPhone 17 Pro lewat Rosetta dan menampilkan scene abu-abu kosong kami. Dokumentasi Godot menambahkan bahwa simulator hanya mendukung renderer Compatibility.

xcodebuild -project GodotDemo.xcodeproj -scheme GodotDemo \
  -configuration Release -sdk iphonesimulator \
  -destination 'generic/platform=iOS Simulator' ARCHS=x86_64 ONLY_ACTIVE_ARCH=NO \
  -derivedDataPath build build CODE_SIGNING_ALLOWED=NO

Untuk kecepatan dan input sentuh yang sebenarnya, uji di ponsel dengan TestFlight. Mac remote tidak bisa melihat iPhone yang dicolokkan ke PC Anda.

Mac untuk langkah Xcode

Pass harian MacRun adalah Mac mini M6 khusus seharga $15, atau $59 untuk seminggu. Xcode 27.1 terpasang, dan Xcode 26.6 untuk proyek lama. Godot belum terpasang. Anda punya hak admin dan Homebrew, jadi Anda memasang versi yang cocok dengan editor Anda. Anda bekerja lewat SSH atau berbagi layar dari Windows. Mac dihapus di akhir masa sewa, jadi push pekerjaan Anda lebih dulu. Untuk tips layar, lihat Xcode dari Windows.

Siapa yang sebaiknya tidak menyewa Mac untuk ini

Jika Anda hanya butuh cek build tanpa signing, jalankan perintah di atas di runner macOS GitHub Actions. Lima job kami berhasil di sana tanpa Mac milik kami sendiri. Codemagic memberi individu 500 menit macOS M2 gratis per bulan, menurut halaman harganya pada 19 Oktober 2026. Jika Anda merilis setiap minggu selama bertahun-tahun, Mac bekas mungkin lebih murah daripada menyewa. Sewalah saat Anda butuh Xcode terbuka: error signing, Simulator, atau archive untuk diunggah.