Ceedling
v0.31.1
2024 年 10 月 26 日？ Ceedling 1.0.0很快就會發布。預發行版本現已推出。請參閱全新的自述文件，以了解 Ceedling 的重新介紹以及各種補充資源的連結。請參閱發行說明，以了解 0.31.1 以來所有新增內容的概述以及詳細變更日誌和重大變更清單的連結。
Ceedling 是一個 C 專案的建置系統，它是 Ruby 的 Rake（make-ish）建置系統的擴展。 Ceedling 也透過整合 CMock、Unity 和 CException，讓 C 語言中的 TDD（測試驅動開發）變得輕而易舉——如果您要使用 C 語言創造出色的內容，那麼這三個專案是您離不開的。 Ceedling 也可以透過方便的插件機制進行擴充。
文件和許可證資訊存在於 docs/ 的儲存庫中
首先確保您的系統上已安裝 Ruby（如果尚未安裝）。然後，從命令提示字元：
> gem install ceedling
> git clone --recursive https://github.com/throwtheswitch/ceedling.git
> cd ceedling
> bundle install # Ensures you have all RubyGems needed
> git submodule update --init --recursive # Updates all submodules
> bundle exec rake # Run all Ceedling library tests
如果您的系統上未安裝捆綁程式或遇到問題，您可能必須安裝它：
> sudo gem install bundler
如果您在執行捆綁器時遇到問題並收到類似can't find gem bundler (>= 0.a) with executable bundle (Gem::GemNotFoundException)訊息，您可能需要安裝不同版本的捆綁器。為此，請參考 Gemfile.lock 中的版本。基於目前Gemfile.lock的範例如下：
> sudo gem install bundler -v 1.16.2
使用 Ceedling 建立專案非常簡單。只需告訴 ceedling 專案的名稱，它將建立一個名為該名稱的子目錄，並用預設的目錄結構和配置填充它。
ceedling new YourNewProjectName
您可以將檔案新增至 src 和 test 目錄中，它們將立即成為測試建置的一部分。需要不同的結構嗎？您可以根據新路徑或工具要求立即開始調整project.yml檔案。
您可以隨時升級到最新版本的 Ceedling，自動獲得對其附帶的打包 Unity 和 CMock 的存取權限。
gem update ceedling
您剛開始使用 Ceedling 嗎？也許您希望您的專案安裝時附帶一些方便的文件？沒問題！您可以在建立新專案時執行此操作。
ceedling new --docs MyAwesomeProject
Ceedling 也可以將其全部精力投入到該專案中。這使得它的使用無需擔心外部依賴。您不必擔心 Ceedling 會因為更新了 gem 而對該特定項目進行更改...無需擔心 Unity 或 CMock 中的更改會破壞您未來的構建。如果您想以這種方式使用 Ceedling，請在建立專案時告訴它您需要本地副本：
ceedling new --local YourNewProjectName
這會將所有 Unity、CMock 和 Ceedling 安裝到專案YourNewProjectName內名為vendor新資料夾中。它仍然會為您建立帶有src和test資料夾的簡單目錄結構。
分數！
如果您想強製本地安裝的 Ceedling 版本升級以稍後匹配您最新的 gem，這很簡單！只需發出以下命令：
ceedling upgrade --local YourNewProjectName
就像new命令一樣，它是從專案的父目錄呼叫的。
發生這種情況時，您是否擔心會丟失所有本地變更？您可以透過發出no_configs來阻止 Ceedling 更新專案檔。
ceedling upgrade --local --no_configs TheProject
你在使用 Git 嗎？您可能希望透過在new呼叫中新增--gitignore來自動讓 Ceedling 建立一個gitignore檔案。
測試愉快！
