Übersicht
Um eine robuste Erweiterung für Discourse zu erstellen, ist es ratsam, Continuous Integration (CI) in Ihr Plugin oder Ihre Theme-Komponente zu integrieren. Dies hilft, Fehler frühzeitig zu erkennen und die Wahrscheinlichkeit von Fehlern in Ihrem Code zu verringern.
Das Einrichten eines CI-Workflows mit GitHub Actions zur Automatisierung von Builds und Tests ist ein Ansatz, den das Discourse-Team für alle unsere Komponenten verwendet, und wir empfehlen Ihnen, dasselbe zu tun.
Einrichtung
Um automatisierte Workflows für GitHub Actions zur Erkennung hinzuzufügen, müssen Sie einen Ordner namens .github/workflows im Stammverzeichnis Ihres Repositorys erstellen.
Innerhalb des workflows-Ordners können Sie eine Reihe von Automatisierungen definieren, die GitHub Actions ausführen muss. Dies können beispielsweise .yml-Dateien für Linting und Tests sein.
Wir haben Vorlagen-Workflows für Plugins und Theme-Komponenten erstellt, die Sie verwenden können. Diese verbinden sich mit unseren “wiederverwendbaren Workflow”-Definitionen hier.
Im Skeleton-Repository der Vorlage können Sie auf GitHub auf die Schaltfläche Use this template klicken, um ein Plugin/eine Theme-Komponenten-Repository basierend auf der Vorlage zu erstellen.
Alternativ können Sie, wenn Sie bereits ein Projekt haben, zu dem Sie die Workflows hinzufügen möchten, einfach den entsprechenden Workflow in den Ordner .github/workflows/ Ihres Repositorys kopieren:
Plugins: discourse-plugin.yml
Themes und Theme-Komponenten: discourse-theme.yml
Diese Vorlagen sind an eine bestimmte Hauptversion unserer wiederverwendbaren Workflows gebunden. Kleine Verbesserungen, die wir an den Workflows vornehmen, werden automatisch in Ihrem Theme/Plugin wirksam. Bei Breaking Changes (z. B. Einführung eines neuen Linters) werden wir die Hauptversion der wiederverwendbaren Workflows erhöhen, und Sie müssen Ihren Workflow aktualisieren, um auf die neue Version zu verweisen.
Voilà! Sie sind bereit! Erstellen Sie einfach einen Commit oder einen Pull Request (PR) für Ihr Repository, und GitHub Actions erkennt die Workflows automatisch und beginnt mit der Ausführung der Jobs.
GitHub Actions zeigt eine Aufschlüsselung jedes Tests an und gibt nach der Ausführung entweder ein 
oder ein 
an, je nachdem, ob der Test bestanden oder fehlgeschlagen ist.
Wenn ein Test fehlgeschlagen ist, erhalten Sie durch Klicken auf die Details einige Informationen darüber, was fehlgeschlagen ist, was Ihnen Hinweise darauf geben kann, was mit Ihrem Code nicht stimmt und was behoben werden muss.
Eigene Tests hinzufügen
Damit Plugin- und Komponenten-Tests effektiv funktionieren, ist es wichtig, dass Sie Tests für Ihr Plugin oder Ihre Theme-Komponente schreiben.
Einzelheiten zum Schreiben von Frontend-Tests mit EmberJS finden Sie unter:
- Write acceptance tests and component tests for Ember code in Discourse
- Introduction - Testing - Ember Guides
Weitere Details zum Schreiben von RSpec-Tests mit Rails finden Sie unter:
Beispiele
Zu Ihrer Information haben wir einige Beispiele für Plugins und Theme-Komponenten ausgewählt, die robuste Tests integriert haben:
| Plugin / Komponente | Client-seitige Tests | Serverseitige Tests |
|---|---|---|
| Assign |  Ordner anzeigen |
Ordner anzeigen |
| Calendar | Ordner anzeigen |
Ordner anzeigen |
| Reactions | Ordner anzeigen |
Ordner anzeigen |
| Right Sidebar Blocks | Ordner anzeigen |
|
| Tag Icons | Ordner anzeigen |
|
| Table Builder | Ordner anzeigen |
Dieses Dokument wird versioniert - schlagen Sie Änderungen auf GitHub vor.