Zainstaluj Godot i skonfiguruj projekty na Androidzie

Tematy w tym przewodniku:

  • wybór wersji i wydania Godota,
  • Pobieranie i instalowanie Godota.
  • Konfigurowanie aplikacji Godot na potrzeby programowania na Androida.
  • Konfigurowanie systemu pod kątem programowania i eksportowania C# (tylko wersja mono)

Wybierz wersję

W miarę możliwości używaj najnowszej stabilnej wersji Godot. Do programowania aplikacji na Androida użyj wersji 3.3 lub nowszej.

Pobierz i uruchom Godot

Otwórz stronę pobierania Godot, aby pobrać silnik gry dostosowany do preferowanego środowiska.

Na stronie pobierania Godot dostępne są 2 wersje: standardowa i Mono. Można ich używać do tworzenia aplikacji na Androida. Wersja mono jest wymagana do programowania w języku C#.

Godot jest rozpowszechniany jako samodzielna aplikacja. Nie wymaga żadnej instalacji. Po wyodrębnieniu pobranych plików możesz je uruchomić w niezmienionej postaci.

Skonfiguruj obsługę Androida

Konfigurowanie ustawień pakietu Android Studio SDK

  1. Pobierz i zainstaluj najnowszą stabilną wersję Androida Studio, jeśli jeszcze jej nie masz.
  2. Uruchom Android Studio.
  3. W oknie Witamy w Android Studio otwórz menu Skonfiguruj i wybierz Menedżer pakietów SDK.
  4. Zanotuj lokalizację pakietu Android SDK na komputerze u góry okna. Musisz podać tę lokalizację w edytorze Godot.
  5. Na karcie Platformy SDK znajdź pozycję Android 11.0 R. Zaznacz element, jeśli nie jest odznaczony.
  6. Na karcie Narzędzia pakietu SDK znajdź elementy listy dla NDK (w układzie porównawczym), narzędzi wiersza poleceń pakietu Android SDK i CMake. Sprawdź je, jeśli nie są zaznaczone.
  7. Jeśli stan elementów listy to Dostępna aktualizacja, zaznacz ich pole wyboru, aby zaktualizować je do najnowszej wersji.
  8. Kliknij przycisk OK. Aby ukończyć instalację, potwierdź pobranie i zaakceptuj umowy licencyjne.

Tworzenie magazynu kluczy debugowania

Aplikacje na Androida muszą być podpisane cyfrowo, aby mogły działać na urządzeniu. W przypadku testów lokalnych do podpisywania aplikacji można używać pliku magazynu kluczy debugowania. Android Studio automatycznie utworzy domyślny magazyn kluczy debugowania. Jeśli masz już aplikacje utworzone z użyciem konfiguracji debugowania w Android Studio, plik debug.keystore powinien znajdować się w tym katalogu:

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

Jeśli plik debug.keystore nie istnieje, utwórz go, wykonując te czynności:

  1. Uruchom Android Studio.
  2. W oknie Witamy w Android Studio wybierz opcję Import an Android Code Sample (Importuj przykładowy kod na Androida).
  3. Wybierz z listy przykładowy Ndk -> Hello GL2 i kliknij przycisk Dalej.
  4. Wybierz lokalizację projektu i kliknij przycisk Zakończ.
  5. Poczekaj na wczytanie projektu i zsynchronizowanie go z Gradle, a potem na pasku menu Android Studio wybierz Kompilacja -> Utwórz projekt.
  6. Poczekaj na zakończenie kompilacji, a potem sprawdź, czy w odpowiednim katalogu utworzono plik debug.keystore.

Ustaw pakiet Android SDK i debuguj lokalizację magazynu kluczy w edytorze Godot

  1. Uruchom edytor Godot.
  2. Utwórz lub otwórz projekt.
  3. Na pasku menu Edytor kliknij kolejno Edytor -> Ustawienia edytora....
  4. W oknie Ustawienia edytora wybierz w panelu po lewej stronie element Eksportuj -> Android.
  5. W panelu po prawej stronie w polu tekstowym Android SDK Path (Ścieżka do pakietu Android SDK) wpisz ścieżkę do pakietu Android SDK.
  6. W polu tekstowym magazyn kluczy debugowania wpisz ścieżkę do pliku debug.keystore.
Ustawienie ścieżki pakietu Android SDK w ustawieniach edytora Godot
Rysunek 1. W polu Android SDK Path (Ścieżka do pakietu Android SDK) w Ustawieniach edytora

Skonfiguruj mono

Zainstaluj MSBuild

Wersja Godota w wersji mono wymaga MSBuild do tworzenia i eksportowania projektów, które używają C#. Aby zainstalować MSBuild:

Linux i macOS

Microsoft Windows

Konfigurowanie edytora C#

Godot obsługuje edycję kodu w języku C# w ograniczonym zakresie. Zdecydowanie zalecamy używanie zewnętrznego edytora plików C#. Godot obsługuje te edytory C#:

  • Microsoft Visual Studio/Visual Studio na Maca
  • Kod Microsoft Visual Studio
  • JetBrains Rider
  • Programowanie mono

Aby skonfigurować zewnętrzny edytor C#, otwórz projekt w edytorze Godot i wykonaj te czynności:

  1. Na pasku menu edytora kliknij Edytor -> Ustawienia edytora....
  2. W oknie Ustawienia edytora wybierz w panelu po lewej stronie element Mono -> Edytor.
  3. Wybierz odpowiedni edytor z menu Zewnętrzny edytor.
Ustawienie zewnętrznego edytora w ustawieniach edytora Godot
Rys. 2. Pole Edytor zewnętrzny w Ustawieniach edytora

Wtyczki edytora C# dla Godota