Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Ein-Klick-Auslieferung

Was ist Ein-Klick-Auslieferung?

Die Ein-Klick-Auslieferung ist eine Funktion, die verfügbar ist, sobald eine Plattform ordnungsgemäß konfiguriert und ein unterstütztes Gerät mit dem Computer verbunden ist. Da auf vielen Ebenen etwas schiefgehen kann (die Plattform ist möglicherweise nicht richtig konfiguriert, das SDK ist möglicherweise nicht richtig installiert, das Gerät ist möglicherweise nicht richtig konfiguriert usw.), ist es gut, den Benutzer über die Existenz dieser Funktion zu informieren.

Nach dem Hinzufügen eines Android-Exportprofils, das als ausführbar markiert ist, kann Godot erkennen, wenn ein USB-Gerät an den Computer angeschlossen ist, und dem Benutzer anbieten, das Projekt automatisch zu exportieren, zu installieren und auf dem Gerät (im Debug-Modus) auszuführen. Diese Funktion wird Ein-Klick-Auslieferung genannt.

Bemerkung

Die Ein-Klick-Auslieferung ist nur verfügbar, wenn eine Exportvorlage hinzugefügt wurde, die im Export-Dialogfeld als Ausführbar gekennzeichnet ist. Es können mehrere Exportprofile als lauffähig markiert werden, allerdings darf pro Plattform nur ein einziges Profil als lauffähig markiert werden. Wird dagegen ein zweites Profil auf einer bestimmten Plattform ebenfalls als ausführbar markiert, wird das andere Profil nicht mehr als ausführbar markiert.

Unterstützte Plattformen

  • Android: Exportiert das Projekt mit aktiviertem Debugging und startet es auf dem verbundenen Gerät.

    • Befolgen Sie unbedingt die in Exportieren für Android beschriebenen Schritte. Andernfalls wird der Button zur Ein-Klick-Auslieferung nicht angezeigt.

    • Falls mehr als ein Gerät angeschlossen ist, fragt Godot auf welches Gerät das Projekt exportiert werden soll.

  • HTML5: Startet einen lokalen Webserver und startet das exportierte Projekt, indem der Default-Browser geöffnet wird.

Die Unterstützung für weitere Plattformen wie iOS ist geplant.

Verwendung der Ein-Klick-Auslieferung

  • Aktivieren Sie bei der Auslieferung auf Android den Entwicklermodus auf Ihrem mobilen Gerät und aktivieren Sie dann das USB-Debugging in den Einstellungen des Geräts.

  • Nachdem Sie USB-Debugging aktiviert haben verbinden Sie das Gerät an Ihren PC mit einem USB-Kabel.

    • Fortgeschrittene Nutzer sollten in der Lage sein, kabelloses ADB zu verwenden.

  • Vergewissern Sie sich, dass für die Target-Plattform (Android oder HTML5) ein Exportprofil mit der Markierung Ausführbar vorhanden ist.

  • Wenn alles korrekt und fehlerfrei konfiguriert ist, erscheinen plattformspezifische Icons in der oberen rechten Ecke des Editors.

  • Klicken Sie auf den Button, um mit einem Klick auf die gewünschte Plattform zu exportieren.

../../_images/remote_debug.webp

Fehlersuche

Android

Wenn Sie das Gerät nicht in der Geräteliste sehen können, wenn Sie den Befehl adb devices in einem Terminal ausführen, wird es auch nicht von Godot angezeigt. So lösen Sie dieses Problem:

  • Prüfen Sie, ob USB-Debugging auf dem Gerät aktiviert und autorisiert ist. Versuchen Sie, Ihr Gerät zu entsperren und die Autorisierungsaufforderung zu akzeptieren, wenn Sie eine sehen. Wenn Sie diese Aufforderung nicht sehen können, sollten Sie adb devices auf Ihrem PC ausführen, damit die Autorisierungsaufforderung auf dem Gerät erscheint.

  • Versuchen Sie, in den Entwicklereinstellungen des Geräts die Debugging-Autorisierung zu entziehen , und führen Sie die Schritte erneut aus.

  • Versuchen Sie, USB-Debugging anstelle von drahtlosem Debugging zu verwenden oder andersherum. Manchmal funktioniert eine der beiden Methoden besser als die andere.

  • Unter Linux fehlen Ihnen möglicherweise die erforderlichen udev rules, damit Ihr Gerät erkannt wird.