使用 CMake 快速入門建立 CMake Hello World 專案
在本文中,您將學習如何從頭開始使用 VS Code 中的 CMake Tools 擴充功能建立 CMake Hello World 專案。
如果您現有的 CMake 專案在根目錄中已經有 CMakeLists.txt
檔案,但沒有 CMake 預設集,您可以跳到「建立 CMakePresets.json
檔案」以使用 CMake 預設集設定您的專案。
否則,為新專案建立一個資料夾。從終端機視窗中,建立一個名為 HelloWorld
的空資料夾,導航到該資料夾中,並輸入以下命令以在該資料夾中開啟 VS Code
mkdir helloworld
cd helloworld
code .
code .
命令會在目前的工作資料夾中開啟 VS Code,該資料夾會成為您的「工作區」。
建立 CMakeLists.txt 檔案
CMake Tools 擴充功能可以為您建立基本 CMake 專案的檔案。
-
開啟命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 並執行CMake: 快速入門命令
-
輸入專案名稱,然後選取 C++ 作為專案語言。
此資訊將會寫入到
CMakeLists.txt
和一些初始原始碼檔案。注意: 如果您在此資料夾中有其他原始碼檔案想要新增為
CmakeLists.txt
的目標,現在會提供新增這些檔案的選項。但在此教學中,我們將僅使用 Hello World 檔案。 -
選取 CTest 作為額外選項以新增測試支援。您也可以選取 CPack 以取得 CPack 支援。
-
接下來,選取「可執行檔」作為專案類型,以建立包含基本
main()
函式的基本原始碼檔案 (main.cpp
)。注意: 如果您想要建立基本原始碼和標頭檔,則應選取「程式庫」作為替代方案。但在此教學中,「可執行檔」即可。如果您收到提示要為資料夾設定 IntelliSense,請選取「允許」。
這會成功建立 CMakeLists.txt
檔案,該檔案會告知 CMake 工具如何建置您的專案。
建立 CMakePresets.json 檔案
接下來,繼續使用 CMake 快速入門來建立 CMakePresets.json
檔案。
-
選取「新增預設集」和「從編譯器建立」。
擴充功能會自動掃描您電腦上的套件組,並建立系統上找到的編譯器清單。
-
選取您想要使用的編譯器。
例如,根據您安裝的編譯器,您可能會看到類似這樣的內容
-
輸入此新預設集的名稱。
預設集的名稱將會寫入到
CMakePresets.json
。
完成這些步驟後,您現在應該會有一個完整的 Hello World CMake 專案,其中包含下列檔案:main.cpp
、CMakeLists.txt
和 CMakePresets.json
。