Ceedling
v0.31.1
26. Oktober 2024 ? Ceedling 1.0.0 wird sehr bald ausgeliefert. Vorabversionen sind ab sofort verfügbar. Eine Neueinführung in Ceedling und Links zu einer Vielzahl ergänzender Ressourcen finden Sie in der brandneuen README-Datei. In den Versionshinweisen finden Sie einen Überblick über alle Neuerungen seit 0.31.1 sowie Links zu einem detaillierten Änderungsprotokoll und einer Liste der wichtigsten Änderungen.
Ceedling ist ein Build-System für C-Projekte, das so etwas wie eine Erweiterung des Rake-Build-Systems (make-ish) von Ruby ist. Ceedling macht auch TDD (Test-Driven Development) in C zum Kinderspiel, indem es CMock, Unity und CException integriert – drei weitere großartige Open-Source-Projekte, ohne die Sie nicht leben können, wenn Sie Großartiges in der C-Sprache schaffen. Ceedling ist auch mit einem praktischen Plugin-Mechanismus erweiterbar.
Dokumentation und Lizenzinformationen finden Sie im Repo unter docs/
Stellen Sie zunächst sicher, dass Ruby auf Ihrem System installiert ist (falls noch nicht geschehen). Dann an einer Eingabeaufforderung:
> 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
Wenn der Bundler nicht auf Ihrem System installiert ist oder Probleme auftreten, müssen Sie ihn möglicherweise installieren:
> sudo gem install bundler
Wenn beim Ausführen von Bundler Probleme auftreten und Meldungen wie diese angezeigt werden can't find gem bundler (>= 0.a) with executable bundle (Gem::GemNotFoundException) , müssen Sie möglicherweise eine andere Version von Bundler installieren. Bitte verweisen Sie hierzu auf die Version im Gemfile.lock. Ein Beispiel basierend auf dem aktuellen Gemfile.lock lautet wie folgt:
> sudo gem install bundler -v 1.16.2
Das Erstellen eines Projekts mit Ceedling ist einfach. Teilen Sie ceedling einfach den Namen des Projekts mit, und es wird ein Unterverzeichnis mit diesem Namen erstellt und mit einer Standardverzeichnisstruktur und -konfiguration gefüllt.
ceedling new YourNewProjectName
Sie können Dateien zu Ihren src- und test-Verzeichnissen hinzufügen und diese werden sofort Teil Ihres Test-Builds. Benötigen Sie eine andere Struktur? Sie können sofort damit beginnen, die project.yml Datei an Ihren neuen Pfad oder Ihre neuen Tool-Anforderungen anzupassen.
Sie können jederzeit auf die neueste Version von Ceedling aktualisieren und erhalten automatisch Zugriff auf die mitgelieferten Unity- und CMock-Pakete.
gem update ceedling
Fangen Sie gerade erst mit Ceedling an? Vielleicht möchten Sie, dass Ihr Projekt mit einigen seiner praktischen Dokumentationen installiert wird? Kein Problem! Sie können dies tun, wenn Sie ein neues Projekt erstellen.
ceedling new --docs MyAwesomeProject
Auch Ceedling kann sein ganzes Potenzial in das Projekt einbringen. Dadurch ist eine Nutzung möglich, ohne dass man sich um externe Abhängigkeiten kümmern muss. Sie müssen sich keine Sorgen machen, dass sich Ceedling für dieses spezielle Projekt ändert, nur weil Sie Ihre Gems aktualisiert haben. Sie müssen sich keine Sorgen machen, dass Änderungen in Unity oder CMock Ihren Build in Zukunft beschädigen könnten. Wenn Sie Ceedling auf diese Weise verwenden möchten, teilen Sie ihm beim Erstellen Ihres Projekts mit, dass Sie eine lokale Kopie wünschen:
ceedling new --local YourNewProjectName
Dadurch werden Unity, CMock und Ceedling vollständig in einem neuen Ordner mit dem Namen vendor in Ihrem Projekt YourNewProjectName installiert. Es wird weiterhin die einfache Verzeichnisstruktur mit den Ordnern src und test für Sie erstellt.
PUNKTZAHL!
Wenn Sie später ein Upgrade einer lokal installierten Version von Ceedling erzwingen möchten, damit diese mit Ihrem neuesten Juwel übereinstimmt, ist das ganz einfach! Geben Sie einfach den folgenden Befehl ein:
ceedling upgrade --local YourNewProjectName
Genau wie der new Befehl wird er aus dem übergeordneten Verzeichnis Ihres Projekts aufgerufen.
Haben Sie Angst, dass in diesem Fall alle Ihre lokalen Änderungen verloren gehen? Sie können Ceedling daran hindern, Ihre Projektdatei zu aktualisieren, indem Sie no_configs ausgeben.
ceedling upgrade --local --no_configs TheProject
Benutzt du Git? Möglicherweise möchten Sie, dass Ceedling automatisch eine gitignore Datei für Sie erstellt, indem Sie --gitignore zu Ihrem new Aufruf hinzufügen.
Viel Spaß beim Testen!
