Up to date

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

單鍵部署

什麼是一鍵式部署？

這個功能會在有正確配置平台且將支援的裝置連接到電腦上後彈出。由於很多地方都有可能出問題 (平台可能未正確設定、可能沒正確安裝 SDK、裝置可能為正確設定…等)，所以讓使用者知道有單鍵部署這功能存在也不錯。

有些平台 (在本文撰寫時，只有 Android) 可以在 USB 裝置連接到電腦上時自動偵測，並提供使用者在該裝置上自動匯出、安裝與 (以除錯模式) 執行專案的功能，用業界的流行語來說，就是「單鍵部署」。

備註

在匯出對話方塊中新增匯出範本並標記為**可執行**後便可使用一鍵部署。你可以同時將多個匯出預設項標記為可執行，但同一平臺被標記為可執行的只能有一個。如果你把該平臺的第二個預設項標記為可執行，其它預設項的標記會被取消。

支援所有平台。

  • Android: 將在匯出專案時啟用除錯，並在連接的裝置上運作。

    • 另外，在建置自定匯出樣板前，依然必須依照 為 Android 匯出 中所提到的步驟進行。

    • 如果你連接的裝置超過一台，Godot會詢問你想匯出專案到哪台裝置。

  • HTML5: 將啟動本地網頁伺服器，並打開預設網頁瀏覽器運作匯出的專案。

針對包含iOS在內的更多平臺的支援在計畫之中。

單鍵部署

  • 如果是部署到Android，請在你的移動裝置上打開開發者模式，然後在裝置設定中啟用USB除錯。

  • 打開USB除錯後，將裝置通過USB線連接到PC。

    • 如果你是高級使用者，也可以使用無線ADB。

  • 確認目標平臺（Android 或者 HTML5）有一個被標記為 可執行 的匯出預設項。

  • 如果這些都配置正確並且沒有報告有錯，編輯器右上角會出現平臺對應的圖示。

  • 點擊該按鈕一鍵匯出到所需的平臺。

../../_images/remote_debug.webp

疑難排解

Android

如果你在命令列中運作 adb devices 時無法在裝置列表中看到該裝置，那麼 Godot 就也無法看到。要解決這個問題：

  • 請檢查是否啟用了 USB 並在該裝置上授權。請嘗試解鎖你的裝置，如果有任何授權的彈框的話請接受。如果你沒有看到這樣的彈框，在 PC 上執行 adb devices 應該就會在該裝置上彈出授權提示。

  • 請嘗試在該裝置的開發者設定中`撤銷除錯授權 <https://stackoverflow.com/questions/23081263/adb-android-device-unauthorized>`__，然後再重試這些步驟。

  • 請嘗試使用 USB 除錯而不是無線除錯，反之亦然。有時候換種方法就能更好地工作。

  • 在 Linux 上，你可能缺少所需的 udev 規則，導致你的裝置無法被識別。