Up to date
This page is up to date for Godot 4.2
.
If you still find outdated information, please open an issue.
Xcode¶
Xcode 是僅可用於 macOS 的免費 IDE。可以從 Mac App Store 中下載。
匯入專案¶
從 Xcode 的主畫面中通過 Other > External Build System 樣板來建立新專案。
現在為您的專案選擇名稱,並在建置工具中設定 scons 執行檔的路徑(要尋找路徑,您可以在終端機中鍵入「where scons」)。
從 Targets 段落中開啟建構目標,並選擇 Info 分頁。
填寫下列設定:
參數
有關完整的參數列表,請參考 建置系統簡介 。
Directory
Godot 根目錄的完整路徑
選擇 File > New > Target... 來新增一個用於對專案進行索引的 Command Line Tool 目標。
選擇 OS X > Application > Command Line Tool 。
備註
請為該建置目標命名,這樣才能分辨出該建置目標不是要用來編譯的 (如 GodotXcodeIndex
)。
開啟該建置目標的 Build Settings 分頁,並找到 Header Search Paths 。
將 Header Search Paths 設為 Godot 根目錄的絕對路徑。也需要包含子資料夾。要包含子資料夾,請在路徑的結尾新增兩個星號 (
**
) ,如/Users/me/repos/godot-source/**
。將 Godot 原始碼拖放到專案檔案瀏覽器中來將這些檔案新增至專案中。
接下來,選擇 Added folders 選項中的 Create groups ,然後請檢查 Add to targets 中應該 只 包含命令行索引建置目標。
Xcode 接著會開始索引檔案。會需要花一點時間。
Xcode 索引完成後,就可以使用跳至定義 (Jump-to-Definition) 功能、自動補全、以及完整的語法醒目提示功能。
對專案進行除錯¶
若要啟用除錯功能,則需要編輯外部建置目標的建置並執行 Scheme。
開啟外部建置目標的 Scheme 編輯器。
移至 Build > Post Actions 部分。
新增一個新的腳本執行動作
在 Provide build settings from 中選擇專案。這樣一來便可以在腳本中參照到專案資料夾。
建立用來提供 Xcode 可識別之二進位檔名稱的腳本,如:
ln -f ${PROJECT_DIR}/godot/bin/godot.macos.tools.64 ${PROJECT_DIR}/godot/bin/godot
建置外部建置目標。
再次開啟 Scheme 編輯器,然後選擇 Run 。
將 Executable 設為連結到 post-build 操作腳本的檔案。
勾選 Debug executable 。
可以在 Arguments 分頁中新增兩個參數:用於開啟編輯器而非專案管理員的
-e
旗標,以及用於告訴編輯器要開啟哪個特定專案的--path
參數 (必須提供專案根目錄的 絕對 路徑,而非project.godot
檔案)。
要檢查是否一切正常,請在 platform/osx/godot_main_osx.mm
中新增一個斷點,並執行專案。
若遇到任何問題,請在 任何一個 Godot 的社群頻道 中尋求幫助。