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. Verwenden Sie unter Linux daher x64-Runner mit einer glibc-basierten Distribution wie Ubuntu oder Debian. Musl-basierte Distributionen wie Alpine und Linux arm64 fallen aus diesem Build heraus.
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 und spiegelt damit immer den aktuellen Stand des Codes.
.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, 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: Mit einer gültigen Subscription erhalten Sie Zugriff auf die Binaries. Siehe Plan-Übersicht für Details und Trial für den 7-Tage-Vollzugriff ohne Kreditkarte.