執行編輯器

在 2023 年，我們新增了一個 Android 編輯器移植版本，可以用於在 Android 裝置上建立、開發和匯出 2D 與 3D 專案。

該應用程式可從 Godot 下載頁面 或從 Google Play 商店 下載。

備註

Android 編輯器目前處於搶先體驗階段，我們將持續改進使用者體驗。請參閱下方的 Xbox One 的限制 。

Android 裝置支援

Android 編輯器需要運作在 Android 5 Lollipop 或更高版本的裝置上，並且至少支援 OpenGL 3。 這些裝置包括（並非詳盡無遺）：

• Android 平板、折疊機、大屏手機

• Android 上網本

• 支援 Android 應用的 Chromebook

執行時期權限

• 所有檔案存取權限 : 讓編輯器能夠建立、匯入及讀取裝置上任何檔案位置的專案檔案。沒有這個權限，編輯器仍然可以運作，但對裝置的檔案和目錄存取權限受到限制。

• REQUEST_INSTALL_PACKAGES : 啟用編輯器能夠安裝匯出的專案 APK。

• RECORD_AUDIO: 在啟用 audio/driver/enable_input 專案設定時請求。

技巧與訣竅

輸入

• 為了獲得最佳體驗和高生產力，建議連接藍牙鍵盤與滑鼠來與 Android 編輯器互動。 Android 編輯器支援所有 常用的快捷鍵與按鍵對應。

• 使用鍵盤與滑鼠互動時，您可以使用 interface/touchscreen/increase_scrollbar_touch_area 編輯器設定來減少捲軸的大小。

• 對於 2D 專案，積木式程式設計外掛程式 可以提供積木式的視覺替代方案，讓您在缺乏連接的硬體鍵盤時也能編寫腳本。

多工處理

• 在較小的裝置上，啟用並使用子母畫面 (PiP) 模式，可以輕鬆地在 編輯器 和 遊玩視窗 之間切換。

  • PiP 可以透過 run/window_placement/play_window_pip_mode 編輯器設定來啟用。

  • run/window_placement/android_window 編輯器設定可用來指定 遊玩 視窗是否應總是啟動於 PiP 模式。

  • 注意： 在 PiP 模式下，遊玩 視窗沒有輸入存取權。

專案同步

• 可透過下載 Android Git 客戶端來同步專案。我們推薦 Termux 終端機，這是一款 Android 終端機模擬器，能提供 Git 及 SSH 等常用終端工具的存取。

  • 注意： 若要在 Termux 終端機使用 Git，必須為終端機授予 寫入 權限。可在終端機內 執行以下指令：termux-setup-storage

外掛程式

• GDExtension 外掛程式如預期般運作，但需要外掛程式開發者提供原生 Android 二進位檔。

Xbox One 的限制

以下是 Android 編輯器的已知局限性和問題：

• 不支援 gradle 建置。

• 不支援 Android 外掛程式，因為它們需要 Gradle 建置支援。支援 GDExtensions 外掛程式。

• |eol| 已停止支援。

• 尚未支援 MIDI 輸出。

• Vulkan Forward+ 著色器雖然可用，但是由於存在嚴重的效能問題，所以不推薦使用。

• 使用者介面未針對 Android 手機進行最佳化。

• Android Go 裝置 缺少裝置讀寫存取所需的 所有檔案存取 權限。作為一個暫行解決方法，當使用 Android Go 裝置時，建議僅在 Android 的 文件 或 下載 目錄中建立新專案。

• 當 不保留活動 在 開發人員選項 中啟用時，編輯器無法正常恢復。

• 使用三星鍵盤時存在一個`錯誤 <https://github.com/godotengine/godot/issues/70751>`__，導致編寫腳本時會插入隨機輸入。建議改用`Google 鍵盤 (Gboard) <https://play.google.com/store/apps/details?id=com.google.android.inputmethod.latin>`__。

也參考

請瀏覽 GitHub 上的 HTML5 問題列表 以瞭解您有興趣的功能目前是否有問題。若列表上沒有，可以開啟 Issue 來與大家交流。