Godot'u yükleyin ve Android için projeleri yapılandırın

Bu kılavuzda aşağıdaki adımlar ele alınacaktır:

  • Bir Godot sürümü ve sürümü seçme
  • Godot'u indirme ve yükleme
  • Android uygulaması geliştirmek için Godot'u yapılandırma
  • Sisteminizi C# geliştirme ve dışa aktarma işlemleri için yapılandırma (yalnızca Godot'un Mono sürümü).

Sürüm seçin

Mümkün olduğunda Godot'un en son kararlı sürümünü kullanın. Android geliştirme için 3.3 veya daha sonraki bir sürümü kullanın.

Godot'u indirin ve çalıştırın

Tercih ettiğiniz ortama uygun oyun motorunu indirmek için Godot indirme sayfasını ziyaret edin.

Godot, indirme sayfasında standart ve Mono olmak üzere iki sürüm sunuyor. Her ikisi de Android için geliştirme amacıyla kullanılabilir. C# geliştirmesi için Mono sürümü gereklidir.

Godot, bağımsız bir uygulama olarak dağıtılır. Bunun için yükleme işlemi gerekmez. İndirilen arşivi çıkardıktan sonra olduğu gibi çalıştırabilirsiniz.

Android desteğini yapılandırın

Android Studio SDK ayarlarını yapılandırma

  1. Henüz yapmadıysanız Android Studio'nun en yeni kararlı sürümünü indirip yükleyin.
  2. Android Studio'yu başlatın.
  3. Android Studio'ya hoş geldiniz penceresinde Yapılandır açılır menüsünü açıp SDK Yöneticisi'ni seçin.
  4. Pencerenin üst kısmında, bilgisayarınızdaki Android SDK Konumu'nu not edin. Bu konumu Godot düzenleyicisinde belirtmeniz gerekir.
  5. SDK Platformları sekmesinde Android 11.0 R için liste girişini bulun. İşaretlenmemişse öğeyi kontrol edin.
  6. SDK Araçları sekmesinde NDK (Yan yana), Android SDK Komut Satırı Araçları ve CMake'ın liste öğelerini bulun. İşaretli olup olmadıklarını kontrol edin.
  7. Liste öğelerinden birinin durumu Güncelleme Mevcut olarak ayarlanmışsa, en son sürüme güncelleme yapmak için bu öğelerin onay kutusunu etkinleştirin.
  8. Tamam düğmesini tıklayın. İndirme işlemini onaylayın ve yüklemeyi tamamlamak için lisans sözleşmelerini kabul edin.

Hata ayıklama anahtar deposu oluşturma

Android uygulamalarının bir cihazda çalışabilmesi için dijital olarak imzalanması gerekir. Yerel testlerde uygulamaları imzalamak için hata ayıklama anahtar deposu dosyası kullanılabilir. Android Studio, otomatik olarak varsayılan bir hata ayıklama anahtar deposu oluşturur. Daha önce Android Studio ile hata ayıklama yapılandırması kullanarak uygulama derlediyseniz debug.keystore dosyası aşağıdaki dizinde bulunmalıdır:

  • Microsoft Windows: C:\Users\$username\.android\debug.keystore
  • Linux/macOS: ~\.android\debug.keystore

debug.keystore dosyası yoksa aşağıdaki adımları uygulayarak bir tane oluşturun:

  1. Android Studio'yu başlatın.
  2. Android Studio'ya Hoş Geldiniz penceresinde, Android Kod Örneği İçe Aktar seçeneğini belirleyin.
  3. Listeden Ndk -> Hello GL2 örneğini seçin ve İleri düğmesini tıklayın.
  4. Proje için bir konum seçin ve Sonlandır düğmesini tıklayın.
  5. Projenin yüklenmesini ve Gradle ile senkronize edilmesini bekleyin, ardından Android Studio menü çubuğundan Derleme -> Proje Yap'ı seçin.
  6. Derlemenin tamamlanmasını bekleyin, ardından uygun dizinde bir debug.keystore dosyasının oluşturulduğunu doğrulayın.

Android SDK'yı ayarlayın ve Godot düzenleyicisinde anahtar deposu konumu hata ayıklaması yapın

  1. Godot düzenleyiciyi başlatın.
  2. Bir proje oluşturun veya açın.
  3. Düzenleyici menü çubuğundan Düzenleyici -> Düzenleyici Ayarları... öğesini seçin.
  4. Düzenleyici Ayarları penceresinde, sol panelden Dışa Aktar -> Android öğesini seçin.
  5. Sağ panelde, Android SDK Yolu metin kutusuna gidin ve Android SDK yolunu girin.
  6. Anahtar Deposu Hata Ayıklama metin kutusuna debug.keystore dosyasının yolunu girin.
Godot düzenleyici ayarlarındaki Android SDK yolu ayarı
Şekil 1. Düzenleyici Ayarları'ndaki Android Sdk Yolu alanı

Mono'yu kurun

MSBuild'i yükleme

Godot'un Mono sürümü, C# kullanan projeler oluşturmak ve dışa aktarmak için MSBuild'i gerektirir. MSBuild'i yüklemek için:

Linux ve macOS

Microsoft Windows

C# düzenleyicisi yapılandır

Godot'un C# kodunu düzenleme desteği çok sınırlı. C# dosyaları için harici bir düzenleyici kullanmanızı öneririz. Godot, aşağıdaki C# düzenleyicilerini destekler:

  • Microsoft Visual Studio/Mac için Visual Studio
  • Microsoft Visual Studio Kodu
  • JetBrains Yolcusu
  • Tek Geliştirme

Harici bir C# düzenleyiciyi yapılandırmak için Godot düzenleyicisinde bir proje açın ve aşağıdaki adımları uygulayın:

  1. Düzenleyici menü çubuğundan Düzenleyici -> Düzenleyici Ayarları... öğesini seçin.
  2. Düzenleyici Ayarları penceresinde, sol panelden Mono -> Düzenleyici öğesini seçin.
  3. Harici Düzenleyici açılır menüsünden istediğiniz düzenleyiciyi seçin.
Godot düzenleyici ayarlarındaki harici düzenleyici ayarı
Şekil 2: Düzenleyici Ayarları'ndaki Harici Düzenleyici alanı

Godot için C# düzenleyici eklentileri