Die Standalone-CLI-Binaries sind self-contained und bringen die Runtime mit,
brauchen also kein global installiertes .NET auf CI-Runnern oder Linux/macOS-Rechnern.
Regeln werden nicht mitgeliefert; sie kommen aus den Profilen in Ihrer
.codecharter/config.yml, aufgelöst gegen das Portal.
Der Windows-Installer ist framework-dependent und nutzt das auf der Maschine
installierte .NET; wird keins gefunden, bietet er die Installation von .NET 9
per winget an, sofern winget verfügbar ist, andernfalls zeigt er die offizielle
.NET-Downloadseite. Der Installer ist nur für x64 verfügbar und installiert
standardmäßig pro Benutzer, Administratorrechte sind also nicht erforderlich.
Unterstützte Betriebssysteme
| Plattform | Status | Binary |
|---|---|---|
| Windows 10/11 x64 | unterstützt | cli-win-x64 |
| Windows Server 2019+ | unterstützt | cli-win-x64 |
| Ubuntu 22.04+ x64 | unterstützt | cli-linux-x64 |
| Debian 12+ x64 | unterstützt | cli-linux-x64 |
| macOS 13+ x64 | unterstützt | cli-osx-x64 |
| macOS 13+ arm64 | unterstützt | cli-osx-arm64 |
Für Linux wird ausschließlich ein glibc-basiertes x64-Build ausgeliefert. Musl-basierte Distributionen wie Alpine werden nicht unterstützt. Auch Linux arm64 wird nicht unterstützt: Es wird kein arm64-Binary für Linux veröffentlicht, verwenden Sie unter Linux daher x64-Runner.
Hardware
| Größe der Solution | Empfohlen |
|---|---|
| bis 50.000 Lines of Code | 4 GB RAM |
| 50.000 bis 200.000 LoC | 8 GB RAM |
| über 200.000 LoC | 16 GB RAM |
Die Analysedauer skaliert mit der Codegröße. Jeder CLI-Lauf lädt und analysiert die Solution von Grund auf neu; einen Analyse-Cache zwischen den Läufen gibt es nicht.
.NET-Voraussetzungen
- Die CLI als Standalone-Binary braucht kein global installiertes .NET-Runtime, sie ist self-contained.
- Wenn Sie CodeCharter auf Ihrer Solution ausführen, muss diese Solution kompilierbar sein. Die für die Solution nötigen .NET-SDKs müssen also auf dem Rechner installiert sein.
- Das deckt typisch .NET Framework 4.6.1+, alle .NET-Core-Varianten und .NET 5/6/7/8/9 ab.
VS Code Extension
- VS Code ab Version 1.85
- Die CodeCharter-CLI muss im PATH liegen, oder Sie setzen
codecharter.serverPathin den VS Code Settings explizit.
CI-Runner
- GitHub Action: lädt die self-contained CLI aus dem CodeCharter-Portal und führt sie nativ auf dem Runner aus, ohne Docker. Unterstützt werden Linux-x64-, Windows-x64- und macOS-Runner (x64 und arm64), GitHub-hosted wie self-hosted. Der Runner braucht die für Ihre Solution nötigen .NET-SDKs.
- Self-hosted Runner: alle oben aufgeführten Plattformen
- Docker: jedes Linux-x64-Image mit modernem glibc, das zusätzlich die für Ihre Solution nötigen .NET-SDKs enthält, denn die Solution muss im Container kompilierbar sein.
Netzwerk
Während der Analyse braucht CodeCharter keinen Netzwerkzugriff. Source-Code verlässt Ihre Umgebung nicht.
CI-Runner, die die GitHub Action verwenden, brauchen Zugriff auf das
CodeCharter-Portal (codecharter.tools): Die Action lädt die
CLI bei jedem Lauf von dort (das Binary wird zwischen den Runs gecached),
und die CLI holt ihre kurzlebige Lizenz mit Ihrem API-Key vom Portal.
Wenn Sie in einer abgeschotteten Umgebung bauen, lässt sich die Action
nicht verwenden: Laden Sie das Binary einmal, spiegeln Sie es in Ihren
internen Artefakt-Speicher und führen Sie die CLI direkt aus.
Zur Laufzeit muss eine gültige codecharter.license-Datei vorhanden sein;
sie validiert offline bis zu ihrem Ablauf. Per API-Key bezogene
CI-Lizenzen sind kurzlebig (standardmäßig 24 Stunden) und brauchen für
die Erneuerung Portalzugriff. Spiegeln Sie in abgeschotteten Umgebungen
daher die Lizenzdatei zusammen mit dem Binary.
Lizenz
CodeCharter ist kommerziell. Ohne gültige Subscription erhalten Sie keinen Zugriff auf die Binaries. Siehe Plan-Übersicht für Details und Trial für den 7-Tage-Vollzugriff ohne Kreditkarte.