Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Aggrega installieren

Aggrega braucht zwei Dinge: die installierte Binärdatei aggrega und, um mit einem KI-Assistenten zu schreiben, den Client Ihres Assistenten, verbunden mit dem MCP-Server, den die Binärdatei mitbringt. Zuerst kommen die Befehle; was jeder tut und die anderen Installationswege folgen danach.

Die Binärdatei installieren

Unter Linux und macOS in einem Terminal:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh

Unter Windows in PowerShell:

Terminal window
irm https://aggrega.ai/install.ps1 | iex

Mit Homebrew, unter macOS und Linux:

Terminal window
brew install aggrega-ai/tap/aggrega

Mit Scoop, unter Windows:

Terminal window
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket
scoop install aggrega

Mit winget, unter Windows:

Terminal window
winget install Cognitio.Aggrega

Prüfen Sie dann, ob es läuft:

Terminal window
aggrega version

Eine Versionszeichenkette bedeutet, dass die Binärdatei gefunden wird und ausführbar ist. Mehr braucht der MCP-Server nicht. Jeder Installationsweg im Detail beschreibt, was jeder Befehl tut, wo er die Binärdatei ablegt und wie Sie mit dem Windows-Installationsprogramm oder von Hand installieren.

Einen MCP-Client verbinden

Der Client Ihres KI-Assistenten startet den MCP-Server von Aggrega, indem er aggrega mcp ausführt, und Den MCP-Server verbinden nennt den Befehl oder den Eintrag, der ihn hinzufügt, Client für Client. In einem Assistenten, der Plugins installiert, fügt das Aggrega-Plugin den Server und den Aggrega-Skill in einem Schritt hinzu: siehe Das Plugin installieren.

Jeder Installationsweg im Detail

Aggrega wird als einzelne ausführbare Datei ausgeliefert. Ein Befehl installiert sie; die manuellen Schritte danach tun dasselbe von Hand. Beide legen sie in einen eigenen Ordner, jedes Mal denselben, und keiner benötigt Administratorrechte: ~/.local/bin/aggrega unter Linux und macOS und %LOCALAPPDATA%\Programs\aggrega\aggrega.exe unter Windows. Unter Windows installieren das Windows-Installationsprogramm und winget sie in denselben Ordner, ebenfalls ohne Administratorrechte, und führen sie unter Ihren installierten Apps auf: siehe Mit dem Windows-Installationsprogramm installieren und Mit winget installieren. Auch Homebrew unter macOS und Linux und Scoop unter Windows installieren sie, jeweils in eigene Ordner: siehe Mit einem Paketmanager installieren.

Mit einem Befehl installieren

Der Installationsbefehl ist curl -fsSL https://aggrega.ai/install.sh | sh unter Linux und macOS und irm https://aggrega.ai/install.ps1 | iex in PowerShell unter Windows, die ersten beiden Befehle von Die Binärdatei installieren. Diese beiden Adressen leiten auf die Installationsskripte weiter, die das neueste Release anhängt, sodass dieselben Befehle auch mit den eigenen Adressen des Release laufen:

Terminal window
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | sh
Terminal window
irm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iex

Was der Befehl tut:

  • Er wählt die Standard-Binärdatei für Ihren Rechner aus dem neuesten Release: Linux und macOS auf 64-Bit-x86 oder 64-Bit-ARM, Windows auf 64-Bit-x86. Jedes andere System und jeden anderen Prozessor lehnt er mit einer Meldung ab, die sagt, was er gefunden hat oder an wen Sie sich stattdessen wenden können. Auf einem Mac mit Apple Silicon wählt er die Apple-Silicon-Binärdatei, auch aus einer Shell heraus, die über Rosetta 2 läuft.
  • Er prüft die Binärdatei gegen die SHA256SUMS des Release, bevor er irgendetwas installiert. Ein Download, dessen SHA-256-Digest von dem in der Liste angegebenen abweicht, wird gelöscht, nichts wird installiert, und der Befehl bricht mit einer Meldung ab, die beide Digests nennt.
  • Er installiert die Binärdatei nur für Sie, als ~/.local/bin/aggrega unter Linux und macOS und als %LOCALAPPDATA%\Programs\aggrega\aggrega.exe unter Windows, legt den Ordner an, wenn er fehlt, und ersetzt eine frühere Kopie dort in einem Schritt, sodass ein erneutes Ausführen des Befehls die vorhandene aktualisiert. Er verwendet nie sudo. Unter Windows entfernt er außerdem die Markierung, die eine aus dem Internet heruntergeladene Datei tragen kann, wie es Unblock-File in den manuellen Schritten tut. Unter macOS lädt er mit curl herunter, daher trägt die installierte Binärdatei keine Quarantänemarkierung (siehe Die vorkompilierte Binärdatei für macOS).
  • Er macht den Befehl erreichbar. Unter Linux und macOS gibt er, wenn der Ordner nicht in Ihrem PATH liegt, einen Befehl aus, der den Ordner in die Datei einträgt, die Ihre Shell beim Start liest: ~/.zshrc für zsh, ~/.bashrc für bash (~/.bash_profile unter macOS), ~/.config/fish/config.fish für fish, mit einer fish_add_path-Zeile, und ~/.profile für jede andere Shell. Er führt diesen Befehl nicht selbst aus: Führen Sie ihn aus und öffnen Sie ein neues Terminal. Unter Windows fügt er den Ordner Ihrem Benutzer-PATH hinzu, wenn er dort nicht steht, und dem PATH des PowerShell-Fensters, in dem er läuft, sodass aggrega in diesem Fenster und in jedem danach geöffneten Terminal läuft, und er meldet, dass er den Ordner hinzugefügt hat.
  • Er prüft, dass die installierte Binärdatei läuft, und hält mit einer Meldung an, bevor irgendetwas anderes eingerichtet wird, wenn sie nicht läuft. Er fügt einen Hinweis hinzu, wenn in Ihrem PATH ein anderes aggrega vor dem installierten steht.
  • Er gibt die installierte Version aus, indem er die installierte Binärdatei über ihren vollständigen Pfad ausführt, sodass die Version angezeigt wird, noch bevor Ihr PATH den Ordner enthält.
  • Er endet mit den nächsten Schritten, unter Next:, je einer Zeile: dem Befehl, der den KI-Quickstart ausführt, wie Erste Schritte beschreibt; aggrega skills install --global, das den Aggrega-Skill zu den KI-Assistenten auf Ihrem Rechner hinzufügt, wie Den Assistenten-Skill bei der Installation hinzufügen beschreibt; und der Adresse dieser Seite, für die Shell-Vervollständigung und Einen MCP-Client verbinden oben. Wenn eine Option den Skill bereits installiert hat, entfällt die Zeile dafür.

Die Ausgabe ist kurz: die Version und das System, für das er installiert, eine Zeile, sobald der Download zu seiner Prüfsumme passt, und der Pfad, unter dem er installiert hat. Erste Schritte zeigt einen vollständigen Lauf. --verbose, wie die Optionen unten nach sh -s -- angegeben, gibt außerdem die Adresse der Prüfsummenliste, den Namen der Release-Datei und die Adresse aus, von der er sie herunterlädt; install.ps1 hat denselben Schalter als -Verbose, für einen Aufruf des Skripts mit Argumenten, die irm … | iex ihm nicht übergeben kann. Wenn der Befehl ablehnt oder ein Schritt fehlschlägt, meldet er dies in einer Zeile, bei install.sh auf der Standardfehlerausgabe und bei install.ps1 als Fehler oder Warnung, die PowerShell anzeigt:

aggrega install: error: <what went wrong> - <what to do>

install.sh, das Skript für Linux und macOS, benötigt curl oder wget, uname und sha256sum oder shasum. install.ps1, das für Windows, läuft in Windows PowerShell 5.1 und in PowerShell 7.

Zwei Einstellungen ändern, was er installiert, jeweils aus der Umgebung gelesen, in der das Skript läuft:

  • AGGREGA_VERSION nennt das zu installierende Release, etwa 0.8.7, geschrieben mit oder ohne führendes v. Ist sie nicht gesetzt, installiert der Befehl das neueste Release — das, das GitHub als neuestes markiert und das nie eine Vorabversion ist; eine Vorabversion wird also nur installiert, wenn sie hier genannt wird.
  • AGGREGA_INSTALL_DIR nennt den Ordner, in den statt des Standardordners installiert wird. Die Binärdatei heißt dort aggrega, unter Windows aggrega.exe, und der Befehl macht diesen Ordner wie oben erreichbar.

Unter Linux und macOS setzen Sie die Einstellung vor sh, nicht vor curl, damit das Skript sie erhält:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> sh

In PowerShell setzen Sie sie zuerst im Fenster; dort bleibt sie gesetzt, bis Sie sie mit Remove-Item Env:AGGREGA_VERSION entfernen:

Terminal window
$env:AGGREGA_VERSION = "<version>"
irm https://aggrega.ai/install.ps1 | iex

Shell-Vervollständigung bei der Installation einrichten

Mit --completion richtet install.sh auch die Shell-Vervollständigung ein, sodass die Tab-Taste Befehle und Flags von aggrega vervollständigt. Optionen stehen nach sh -s --, das sie an das Skript übergibt, das sh aus der Pipe liest:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion

irm … | iex übergibt einem Skript keine Option. Richten Sie in PowerShell die Vervollständigung nach Abschluss der Installation ein, mit dem Skript, das aggrega completion powershell schreibt, wie Shell-Vervollständigung beschreibt. install.ps1 akzeptiert ebenfalls -Completion, für einen Aufruf des Skripts mit Argumenten.

Er richtet die Vervollständigung nur für Sie ein, ohne Administratorrechte, für die Shell, die Ihre Einstellung SHELL nennt, oder in PowerShell für die PowerShell, in der er läuft. Er verwendet das Skript, das aggrega completion der installierten Binärdatei selbst schreibt, und nennt jede Datei, die er schreibt oder ändert:

  • bash: Er schreibt das Skript nach ~/.local/share/bash-completion/completions, in den Ordner, aus dem das Paket bash-completion Ihre eigenen Vervollständigungen liest. Die bash-Vervollständigung für aggrega braucht dieses Paket.
  • zsh: Er schreibt _aggrega nach ~/.local/share/zsh/site-functions und fügt ~/.zshrc drei Zeilen hinzu, die diesen Ordner in den Funktionspfad von zsh aufnehmen und sie laden, wobei compinit ausgeführt wird, wo nichts in der Datei es zuvor ausgeführt hat.
  • fish: Er schreibt aggrega.fish nach ~/.config/fish/completions, das fish von selbst liest.
  • PowerShell: Er schreibt das Skript als %LOCALAPPDATA%\aggrega\completion.ps1 und fügt Ihrem Profil für jeden Host der PowerShell, in der er läuft, $PROFILE.CurrentUserAllHosts, zwei Zeilen hinzu, die es laden. Windows PowerShell und PowerShell 7 haben getrennte Profile, führen Sie ihn also aus jeder aus, die Sie verwenden. Ein Profil läuft nur, wo die Ausführungsrichtlinie, die ein neues Fenster erhält, RemoteSigned, Unrestricted oder Bypass ist; unter jeder anderen, etwa Restricted, schreibt er nichts und sagt, welche Richtlinie er vorgefunden hat. Er ändert die Richtlinie nie.

XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR und ZDOTDIR verschieben diese Ordner und Dateien so, wie jede Shell sie liest. Ein neues Terminal oder Fenster lädt die Vervollständigung. Ein erneuter Aufruf des Befehls schreibt ein Skript nur dann neu, wenn das installierte aggrega ein anderes schreibt, und fügt die Zeilen nur einmal zu ~/.zshrc oder dem Profil hinzu; so fügen Sie die Vervollständigung auch einer bestehenden Installation hinzu, da der Befehl die Binärdatei dabei erneut installiert.

Den Assistenten-Skill bei der Installation hinzufügen

Mit --skills (-Skills in PowerShell) installiert der Installationsbefehl auch den Aggrega-Skill — die Anweisungen, die einem KI-Assistenten beibringen, Aggrega zu installieren und zu verwenden — in jedem Ihrer Projekte, für die KI-Assistenten auf Ihrem Rechner. Beide Optionen können zusammen angegeben werden:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skills

Führen Sie in PowerShell, wo irm … | iex keine Option übergibt, nach Abschluss der Installation aggrega skills install --global aus: Das ist der Befehl, den -Skills ausführt.

Er führt aggrega skills install --global der installierten Binärdatei selbst aus, das nach den Assistenten auf Ihrem Rechner sucht — jedem, dessen Konfigurationsordner in Ihrem Home-Verzeichnis liegt oder dessen Befehl in Ihrem PATH steht — und jeden gefundenen ausgibt sowie, wodurch er gefunden wurde. Dann:

  • In einem Terminal fragt er zuerst. Drücken Sie die Eingabetaste, um den Skill für die gefundenen Assistenten zu installieren, oder geben Sie die Kennungen anderer ein, um sie hinzuzufügen, getrennt durch Leerzeichen oder Kommas; aggrega skills list gibt die Kennungen aus. Unter curl … | sh liest das Skript sich selbst aus der Pipe, deshalb fragt es stattdessen über Ihr Terminal.
  • Ohne Terminal, über das er fragen kann, etwa in einem Skript, installiert er für die gefundenen Assistenten.
  • Um die Assistenten selbst zu wählen, geben Sie sie nach der Option an, getrennt durch Kommas: --skills claude-code,cursor oder --skills=claude-code,cursor, und in PowerShell -Skills claude-code,cursor. Er installiert dann für diese und sucht nach keinen anderen.

Er gibt jeden Skill-Ordner aus, den er schreibt, etwa ~/.claude/skills/aggrega für Claude Code, alle unterhalb Ihres Home-Verzeichnisses. Ein erneuter Aufruf des Befehls ersetzt die Kopien, die ein früherer Lauf geschrieben hat; so folgt der Skill der Binärdatei auf eine neuere Version. aggrega skills beschreibt den Befehl, den Ordner, den jeder Assistent liest, und wodurch jeder gefunden wird.

Wenn ein Schritt nicht ausgeführt werden kann

Wenn die Vervollständigung nicht eingerichtet werden kann — eine Shell, die er nicht einrichtet, etwa dash, ein Ordner, in den er nicht schreiben kann, oder eine PowerShell-Ausführungsrichtlinie, die kein Profil ausführt — oder der Skill nicht installiert werden kann — kein Assistent gefunden und keiner genannt, eine Kennung, die er nicht kennt, oder eine Datei in einem Skill-Ordner, die keine Installation geschrieben hat —, ist die Binärdatei trotzdem installiert und läuft. Der Befehl sagt, warum der Schritt fehlgeschlagen ist, gibt die nächsten Schritte aus und endet mit einem Status, der angibt, welcher Schritt fehlgeschlagen ist. Die Status sind:

StatusBedeutung
0aggrega ist installiert, und jeder Schritt, den eine Option angefordert hat, war erfolgreich
1nichts wurde installiert, oder das installierte aggrega lief nicht
2dem Befehl wurde eine Option übergeben, die er nicht annimmt, oder eine Liste, die keinen Assistenten nennt; er hat nichts getan
3aggrega ist installiert und läuft, aber das Einrichten der Shell-Vervollständigung ist fehlgeschlagen
4aggrega ist installiert und läuft, aber das Installieren des Skills ist fehlgeschlagen
5aggrega ist installiert und läuft, aber beides ist fehlgeschlagen

Das PowerShell-Skript schließt nie das Fenster, in dem es läuft, deshalb hinterlässt es den Status in $LASTEXITCODE, und jeder Status außer 0 endet mit einem Fehler, den powershell -Command und pwsh -Command als Exit-Status 1 melden.

Mit dem Windows-Installationsprogramm installieren

Jedes Release enthält ein Windows-Installationsprogramm, aggrega-<version>-windows-amd64-setup.exe, auf der Release-Seite unter https://github.com/aggrega-ai/aggrega-cli/releases. Laden Sie es herunter und führen Sie es aus. Es installiert die Standard-aggrega.exe nur für Sie, ohne Administratorrechte und ohne danach zu fragen, über einen kurzen Assistenten:

  • Eine Willkommensseite, dann die Lizenz, die Apache License 2.0 von Aggrega: Es wird nichts installiert, bis Sie I Agree drücken. Dann die Komponenten: Aggrega selbst, immer installiert, und Add to PATH, ausgewählt.
  • Der Installationsordner, %LOCALAPPDATA%\Programs\aggrega, sofern Sie keinen anderen wählen; es ist der Ordner, den der Installationsbefehl verwendet.
  • Der Fortschritt, dann eine Abschlussseite, die den Ordner nennt und angibt, ob diese Installation ihn Ihrem PATH hinzugefügt hat, mit den nächsten Schritten: den Aggrega-Skill mit aggrega skills install --global installieren und Ihren KI-Client verbinden, wie Einen MCP-Client verbinden beschreibt.

Was es tut:

  • Ist Add to PATH ausgewählt, fügt es den Installationsordner Ihrem Benutzer-PATH hinzu, sofern er dort nicht bereits steht. Ein nach der Installation geöffnetes Terminal findet aggrega; ein bereits geöffnetes behält den PATH, mit dem es gestartet wurde. Ist die Option abgewählt, wird Ihrem PATH nichts hinzugefügt, und ein Terminal führt aggrega.exe über ihren vollständigen Pfad aus; ein Eintrag, den eine frühere Installation hinzugefügt hat, bleibt unverändert.
  • Es führt Aggrega unter Ihren installierten Apps auf, mit Cognitio s.r.l. als Herausgeber, sodass es wie jede andere App über Settings → Apps deinstalliert wird. Das Deinstallationsprogramm bittet Sie um Bestätigung und entfernt dann die Dateien, die das Installationsprogramm in den Ordner gelegt hat, den PATH-Eintrag und den Eintrag in dieser Liste, und entfernt den Ordner, wenn nichts anderes darin übrig ist.
  • Erneut ausgeführt, installiert es über das Vorhandene, wobei es den Ordner anbietet, in den es zuletzt installiert hat, sodass das Installationsprogramm eines späteren Release die vorhandene Kopie aktualisiert und dabei einen einzigen Eintrag in Ihrem PATH behält.
  • Neben aggrega.exe enthält der Ordner uninstall.exe, LICENSE mit dem Lizenztext und EnVar.dll, die Komponente, mit der das Installations- und das Deinstallationsprogramm Ihren PATH bearbeiten.

Wenn aggrega.exe läuft — gestartet von einem Editor oder einem KI-Client —, kann das Installationsprogramm sie nicht ersetzen und bricht mit einer entsprechenden Meldung ab; schließen Sie, was sie gestartet hat, und führen Sie das Installationsprogramm erneut aus. Das Deinstallationsprogramm bricht auf dieselbe Weise ab, bevor es etwas entfernt hat.

Um ohne Fenster zu installieren, aus einem Skript oder einem Werkzeug heraus, das Software auf vielen Rechnern installiert, führen Sie das Installationsprogramm mit /S aus, in Großbuchstaben geschrieben; es installiert dann ohne Fenster und ohne Rückfrage in den Ordner, den eine frühere Installation verwendet hat, oder andernfalls in den Standardordner, mit Add to PATH, und meldet einen Fehlschlag über seinen Exit-Code, der nicht 0 ist. Das Deinstallationsprogramm akzeptiert denselben Schalter:

Terminal window
.\aggrega-<version>-windows-amd64-setup.exe /S
& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /S

Das Installationsprogramm ist wie die ausführbaren Dateien signiert, mit dem Herausgeber Cognitio S.r.l. und einem Zeitstempel: Die Prüfungen in Die vorkompilierte Binärdatei für Windows gelten dafür wie für aggrega.exe, ebenso das, was dort über die Abfragen gesagt wird, die Windows für eine heruntergeladene Datei anzeigen kann. SHA256SUMS führt seinen Digest wie den jeder anderen Datei des Release auf.

Wo das Installationsprogramm nicht passt, installieren der Installationsbefehl oben und die manuellen Schritte dieselbe aggrega.exe in denselben Ordner.

Mit einem Paketmanager installieren

Jedes Release aktualisiert außerdem eine Homebrew-Formel und ein Scoop-Manifest, sodass der Paketmanager, den Sie bereits verwenden, Aggrega installieren und aktuell halten kann. Jeder installiert dieselbe Standard-Binärdatei wie der Installationsbefehl, geprüft gegen den SHA-256-Digest, den die SHA256SUMS des Release für sie angeben.

Unter macOS und Linux installiert brew install aggrega-ai/tap/aggrega es mit Homebrew. Homebrew fügt beim ersten Mal den Tap aggrega-ai/tap hinzu und installiert die Binärdatei für Ihr System und Ihren Prozessor: macOS auf Apple Silicon oder Intel, Linux auf 64-Bit-x86 oder 64-Bit-ARM. Nach einem neuen Release aktualisiert brew upgrade sie zusammen mit jeder anderen installierten Formel.

Unter Windows fügen Sie mit Scoop einmal den Aggrega-Bucket hinzu, mit scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket, und installieren daraus mit scoop install aggrega. Scoop installiert die Windows-Binärdatei als aggrega.exe und macht sie über den Shim-Ordner, den es in Ihrem PATH hält, als aggrega erreichbar. Nach einem neuen Release aktualisiert scoop update die Buckets und scoop update aggrega die Binärdatei.

Homebrew und Scoop installieren jeweils in eigene Ordner statt nach ~/.local/bin oder %LOCALAPPDATA%\Programs\aggrega und aktualisieren nur die Kopie, die sie installiert haben. Verwenden Sie auf einem Rechner nur einen Installationsweg: Eine vom Installationsbefehl oder von Hand installierte Kopie und eine von Homebrew oder Scoop installierte sind zwei Kopien, und welcher Ordner in Ihrem PATH zuerst steht, entscheidet, welche ausgeführt wird.

Mit winget installieren

Unter Windows installiert winget install Cognitio.Aggrega es mit winget, dem Windows-Paket-Manager. winget lädt das Windows-Installationsprogramm des Release von dessen Release-Seite herunter, prüft es gegen den SHA-256-Digest, den das Manifest des Pakets angibt, und führt es unbeaufsichtigt aus. Das Ergebnis ist das des Installationsprogramms selbst: aggrega.exe in %LOCALAPPDATA%\Programs\aggrega oder in dem Ordner, den eine frühere Installation verwendet hat, dieser Ordner in Ihrem Benutzer-PATH und Aggrega in Ihrer Liste installierter Apps, alles ohne Administratorrechte. winget ändert nicht den PATH des Terminals, in dem es läuft, öffnen Sie also ein neues Terminal, bevor Sie aggrega version ausführen.

winget upgrade Cognitio.Aggrega installiert ein späteres Release darüber, und winget uninstall Cognitio.Aggrega führt sein Deinstallationsprogramm aus. winget, das Installationsprogramm und der Installationsbefehl installieren alle in denselben Ordner, sofern Sie im Installationsprogramm keinen anderen wählen, daher legt das zuletzt ausgeführte seine aggrega.exe dort ab.

Von Hand installieren

Jedes Release enthält vorkompilierte Binärdateien für Linux auf 64-Bit-x86 und auf 64-Bit-ARM, für Windows auf 64-Bit-x86 und für macOS auf Apple Silicon und auf Intel, auf der Release-Seite unter https://github.com/aggrega-ai/aggrega-cli/releases. Laden Sie die ausführbare Datei für Ihr Betriebssystem und Ihren Prozessor herunter — Die Datei auswählen weiter unten nennt jede — und prüfen Sie sie gegen die SHA256SUMS des Release, wie dort beschrieben. Markieren Sie sie dann als ausführbar und verschieben Sie sie nach ~/.local/bin/aggrega. Unter Linux, aus dem Verzeichnis, in dem der Download liegt, mit <version> ersetzt durch die heruntergeladene Version und amd64 durch arm64 auf 64-Bit-ARM:

Terminal window
chmod +x aggrega-<version>-linux-amd64
mkdir -p ~/.local/bin
mv aggrega-<version>-linux-amd64 ~/.local/bin/aggrega

Unter Windows siehe Die vorkompilierte Binärdatei für Windows weiter unten; unter macOS siehe Die vorkompilierte Binärdatei für macOS.

Wenn ~/.local/bin nicht in Ihrem PATH liegt, fügen Sie diese Zeile der Datei hinzu, die Ihre Shell beim Start liest — ~/.zshrc für zsh, ~/.bashrc für bash (~/.bash_profile unter macOS) —, und öffnen Sie ein neues Terminal:

Terminal window
export PATH="$HOME/.local/bin:$PATH"

Aus dem Quellcode: Bauen Sie mit einer installierten Go-Toolchain den Befehl aggrega aus dem Quellbaum und legen Sie die resultierende Binärdatei in denselben Ordner.

Bestätigen Sie die Installation mit aggrega version, wie am Ende von Die Binärdatei installieren.

Die Datei auswählen

Ein Release benennt jede ausführbare Datei aggrega-<version>-<system>-<processor>, unter Windows mit .exe:

SystemProzessorDatei
Linux64-Bit-x86 (uname -m gibt x86_64 aus)aggrega-<version>-linux-amd64
Linux64-Bit-ARM (uname -m gibt aarch64 aus)aggrega-<version>-linux-arm64
Windows64-Bit-x86aggrega-<version>-windows-amd64.exe
macOSApple Siliconaggrega-<version>-darwin-arm64
macOSIntelaggrega-<version>-darwin-amd64

Diese Datei ist die, die der Installationsbefehl installiert, und die, die von Hand heruntergeladen wird. Zwei Varianten davon liegen daneben; der Installationsbefehl installiert keine davon, und jede wird auf dieselbe Weise von Hand installiert:

  • aggrega-debug-<version>-… ist dasselbe Programm mit seinen Debug-Informationen, die ein Debugger oder Profiler liest. Es läuft und meldet seine Version genau wie die Standarddatei und ist größer.
  • aggrega-light-<version>-… ist ohne die eingebetteten Plugins gebaut: Es löst jedes Plugin über die Plugin-Kaskade auf, wie der Workspace sie konfiguriert, statt die Kern-Plugins in sich selbst zu finden.

Für Windows enthält das Release außerdem aggrega-<version>-windows-amd64-setup.exe, das Windows-Installationsprogramm, das die Standarddatei für Sie installiert.

Jedes Release enthält außerdem SHA256SUMS, den SHA-256-Digest jeder anderen beigefügten Datei, einschließlich der beiden Installationsskripte, in der Form, die sha256sum liest. Der Installationsbefehl führt diese Prüfung selbst durch. Um einen Download unter Linux von Hand zu prüfen, mit SHA256SUMS im selben Verzeichnis:

Terminal window
sha256sum --check --ignore-missing SHA256SUMS

Die heruntergeladene Datei wird mit OK gemeldet; jede andere Meldung bedeutet, dass es nicht die vom Release veröffentlichte Datei ist.

Die vorkompilierte Binärdatei für Windows

Die ausführbare Datei für Windows ist aggrega-<version>-windows-amd64.exe (die Debug- und Light-Varianten daneben im Release werden genauso installiert). Benennen Sie sie in aggrega.exe um, verschieben Sie sie nach %LOCALAPPDATA%\Programs\aggrega, den Ordner, den der Installationsbefehl verwendet, und fügen Sie diesen Ordner Ihrem Benutzer-PATH hinzu: Windows führt eine Datei mit der Endung .exe aus, ohne dass sie als ausführbar markiert werden muss, und findet sie unter diesem Namen als Befehl aggrega. In PowerShell zum Beispiel, mit <version> ersetzt durch die heruntergeladene Version:

Terminal window
$dir = "$env:LOCALAPPDATA\Programs\aggrega"
New-Item -ItemType Directory -Force $dir | Out-Null
Move-Item ".\aggrega-<version>-windows-amd64.exe" "$dir\aggrega.exe"
Unblock-File "$dir\aggrega.exe"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")

Ein danach geöffnetes Terminal findet aggrega; ein bereits geöffnetes behält den PATH, mit dem es gestartet wurde.

Die ausführbaren Dateien sind signiert. Jede trägt eine Authenticode-Signatur, die Codesignatur, die Windows prüft, und der Herausgeber, den Windows dafür anzeigt, ist Cognitio S.r.l. Jede Signatur trägt außerdem einen Zeitstempel: Das Zertifikat hinter einer Signatur ist nur wenige Tage gültig, und der Zeitstempel sorgt dafür, dass die Signatur nach Ablauf dieses Zertifikats gültig bleibt. So prüfen Sie eine heruntergeladene Datei, bevor Sie sie ausführen:

  • Im Datei-Explorer öffnen Sie die Properties der Datei und deren Registerkarte Digital Signatures. Die Signaturliste nennt Cognitio S.r.l.; wählen Sie den Eintrag und dann Details, wo This digital signature is OK. gemeldet wird.

  • In PowerShell, mit $dir wie im obigen Beispiel:

    Terminal window
    $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"
    $signature.Status
    $signature.SignerCertificate.Subject

    Status meldet Valid, und der Antragsteller beginnt mit CN=Cognitio S.r.l.. NotSigned oder HashMismatch bedeutet, dass die Datei nicht die vom Release veröffentlichte ist oder nach dem Signieren verändert wurde.

Eine Signatur nennt den Herausgeber; sie lässt nicht jede Warnung verschwinden. Welche Ihnen begegnet, hängt davon ab, wie die Datei angekommen ist und wie Sie sie starten:

  • Beim Herunterladen kann ein Browser warnen, dass die Datei nicht häufig heruntergeladen wird, und fragen, ob sie behalten werden soll. Wenn Sie sie behalten, wird die Datei so gespeichert, wie sie heruntergeladen wurde.
  • Wenn Sie sie aus dem Datei-Explorer oder aus dem Browser starten, kann Windows Windows protected your PC anzeigen. Diese Meldung stammt von Microsoft Defender SmartScreen, das die Reputation abwägt, die eine Datei und ihr Herausgeber aufgebaut haben, sodass eine neu veröffentlichte Version ihr trotz Signatur noch begegnen kann, bis sich ihre eigene Reputation aufgebaut hat. Bei einer signierten Datei nennt die Meldung den Herausgeber: Wählen Sie More info, prüfen Sie, dass sie Cognitio S.r.l. und den Namen der heruntergeladenen Datei nennt, und wählen Sie dann Run anyway. Wird dieselbe Datei stattdessen aus PowerShell oder einer Eingabeaufforderung gestartet, läuft sie möglicherweise ohne diese Meldung; ob das der Fall ist, hängt von der Windows-Version und ihren Einstellungen ab.
  • Unblock-File beantwortet diese Meldung im Voraus. Eine heruntergeladene Datei ist als aus dem Internet stammend markiert, und auf diese Markierung reagiert die Prüfung Windows protected your PC. Unblock-File in PowerShell, wie im obigen Beispiel, entfernt die Markierung; ebenso das Kontrollkästchen Unblock auf der Registerkarte General der Properties der Datei im Datei-Explorer.
  • Wo Smart App Control eingeschaltet ist (Windows 11), prüft es ein Programm, wenn Sie es starten. Wie Microsoft es beschreibt, fragt Smart App Control zunächst den Cloud-Sicherheitsdienst von Microsoft, ob das Programm sicher ist; kann dieser Dienst keine zuverlässige Vorhersage treffen, prüft es die Signatur, lässt ein Programm mit gültiger Signatur laufen und blockiert eines, das unsigniert ist oder dessen Signatur ungültig ist. Ob es eingeschaltet ist, zeigt App & browser control in der Windows-Sicherheit.

Die vorkompilierte Binärdatei für macOS

Die ausführbaren Dateien für macOS sind aggrega-<version>-darwin-arm64 für einen Mac mit Apple Silicon und aggrega-<version>-darwin-amd64 für einen Mac mit Intel-Prozessor; About This Mac im Apple-Menü zeigt, welchen Sie haben. Die Debug- und Light-Varianten daneben im Release werden genauso installiert. Ein Mac mit Apple Silicon führt auch die Intel-Datei aus, über Rosetta 2, wo es installiert ist, aber die Apple-Silicon-Datei ist die für ihn gebaute.

Benennen Sie die Datei in aggrega um, markieren Sie sie als ausführbar und verschieben Sie sie nach ~/.local/bin, den Ordner, den der Installationsbefehl verwendet. Im Terminal zum Beispiel, in dem Verzeichnis, in dem der Download liegt, mit <version> ersetzt durch die heruntergeladene Version und arm64 durch amd64 auf einem Intel-Mac:

Terminal window
chmod +x aggrega-<version>-darwin-arm64
mkdir -p ~/.local/bin
mv aggrega-<version>-darwin-arm64 ~/.local/bin/aggrega

mkdir legt den Ordner an, wo er noch nicht existiert. ~/.local/bin liegt nicht im PATH, den macOS einem neuen Terminal gibt, fügen Sie also die Zeile aus Von Hand installieren zu ~/.zshrc hinzu, oder für bash zu ~/.bash_profile, sofern sie dort nicht bereits steht.

Die ausführbaren Dateien sind signiert und notarisiert. Jede trägt eine Codesignatur, erstellt mit der Developer ID von Cognitio s.r.l. — dem Zertifikat, das Apple einem Entwickler für Software ausstellt, die außerhalb des Mac App Store vertrieben wird —, mit der gehärteten Laufzeitumgebung und einem sicheren Zeitstempel, und Apples Notarisierungsdienst hat jede geprüft und notarisiert. Gatekeeper, die macOS-Prüfung für Software aus dem Internet, bewertet ein Programm, das die Quarantänemarkierung trägt, die Markierung, die ein Webbrowser einer heruntergeladenen Datei hinzufügt, und akzeptiert eines, das Apple notarisiert hat, sodass eine von der Release-Seite heruntergeladene Datei so läuft, wie sie ist. Ein Notarisierungsticket kann nicht an eine einzelne ausführbare Datei angehängt werden, daher findet Gatekeeper das Ticket online, wenn die Datei zum ersten Mal läuft; auf einem Mac, der in diesem Moment offline ist, kann Gatekeeper die Datei blockieren, bis der Mac Apple erreichen kann.

Um eine heruntergeladene Datei vor dem Ausführen zu prüfen, im Terminal mit dem Namen der heruntergeladenen Datei:

Terminal window
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64
codesign --display --verbose=2 aggrega-<version>-darwin-arm64

Der erste meldet, dass die Datei valid on disk ist und satisfies its Designated Requirement. Der zweite listet die Zertifizierungsstellen der Signatur auf, deren erste Developer ID Application: COGNITIO SRL ist, gefolgt von der Team-Kennung in Klammern, sowie einen Timestamp. Eine Datei, die eine der beiden Prüfungen nicht besteht, ist nicht die vom Release veröffentlichte oder wurde nach dem Signieren verändert.

Eine mit curl abgerufene Datei trägt keine Quarantänemarkierung, daher bewertet Gatekeeper sie überhaupt nicht: curl fügt die Markierung, die ein Browser hinzufügt, nicht hinzu. Das ist auch der Grund, warum die Binärdatei, die der Installationsbefehl ablegt, ohne diese Bewertung läuft.