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:
curl -fsSL https://aggrega.ai/install.sh | shUnter Windows in PowerShell:
irm https://aggrega.ai/install.ps1 | iexMit Homebrew, unter macOS und Linux:
brew install aggrega-ai/tap/aggregaMit Scoop, unter Windows:
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucketscoop install aggregaMit winget, unter Windows:
winget install Cognitio.AggregaPrüfen Sie dann, ob es läuft:
aggrega versionEine 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:
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | shirm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iexWas 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
SHA256SUMSdes 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/aggregaunter Linux und macOS und als%LOCALAPPDATA%\Programs\aggrega\aggrega.exeunter 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 niesudo. Unter Windows entfernt er außerdem die Markierung, die eine aus dem Internet heruntergeladene Datei tragen kann, wie esUnblock-Filein den manuellen Schritten tut. Unter macOS lädt er mitcurlherunter, 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
PATHliegt, einen Befehl aus, der den Ordner in die Datei einträgt, die Ihre Shell beim Start liest:~/.zshrcfür zsh,~/.bashrcfür bash (~/.bash_profileunter macOS),~/.config/fish/config.fishfür fish, mit einerfish_add_path-Zeile, und~/.profilefü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-PATHhinzu, wenn er dort nicht steht, und demPATHdes PowerShell-Fensters, in dem er läuft, sodassaggregain 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
PATHein anderesaggregavor 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
PATHden 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_VERSIONnennt das zu installierende Release, etwa0.8.7, geschrieben mit oder ohne führendesv. 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_DIRnennt den Ordner, in den statt des Standardordners installiert wird. Die Binärdatei heißt dortaggrega, unter Windowsaggrega.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:
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> shIn PowerShell setzen Sie sie zuerst im Fenster; dort bleibt sie gesetzt, bis Sie sie mit Remove-Item Env:AGGREGA_VERSION entfernen:
$env:AGGREGA_VERSION = "<version>"irm https://aggrega.ai/install.ps1 | iexShell-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:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completionirm … | 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üraggregabraucht dieses Paket. - zsh: Er schreibt
_aggreganach~/.local/share/zsh/site-functionsund fügt~/.zshrcdrei Zeilen hinzu, die diesen Ordner in den Funktionspfad von zsh aufnehmen und sie laden, wobeicompinitausgeführt wird, wo nichts in der Datei es zuvor ausgeführt hat. - fish: Er schreibt
aggrega.fishnach~/.config/fish/completions, das fish von selbst liest. - PowerShell: Er schreibt das Skript als
%LOCALAPPDATA%\aggrega\completion.ps1und 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,UnrestrictedoderBypassist; unter jeder anderen, etwaRestricted, 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:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skillsFü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 listgibt die Kennungen aus. Untercurl … | shliest 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,cursoroder--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:
| Status | Bedeutung |
|---|---|
0 | aggrega ist installiert, und jeder Schritt, den eine Option angefordert hat, war erfolgreich |
1 | nichts wurde installiert, oder das installierte aggrega lief nicht |
2 | dem Befehl wurde eine Option übergeben, die er nicht annimmt, oder eine Liste, die keinen Assistenten nennt; er hat nichts getan |
3 | aggrega ist installiert und läuft, aber das Einrichten der Shell-Vervollständigung ist fehlgeschlagen |
4 | aggrega ist installiert und läuft, aber das Installieren des Skills ist fehlgeschlagen |
5 | aggrega 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
PATHhinzugefügt hat, mit den nächsten Schritten: den Aggrega-Skill mitaggrega skills install --globalinstallieren 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-
PATHhinzu, sofern er dort nicht bereits steht. Ein nach der Installation geöffnetes Terminal findetaggrega; ein bereits geöffnetes behält denPATH, mit dem es gestartet wurde. Ist die Option abgewählt, wird IhremPATHnichts hinzugefügt, und ein Terminal führtaggrega.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
PATHbehält. - Neben
aggrega.exeenthält der Ordneruninstall.exe,LICENSEmit dem Lizenztext undEnVar.dll, die Komponente, mit der das Installations- und das Deinstallationsprogramm IhrenPATHbearbeiten.
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:
.\aggrega-<version>-windows-amd64-setup.exe /S& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /SDas 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:
chmod +x aggrega-<version>-linux-amd64mkdir -p ~/.local/binmv aggrega-<version>-linux-amd64 ~/.local/bin/aggregaUnter 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:
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:
| System | Prozessor | Datei |
|---|---|---|
| Linux | 64-Bit-x86 (uname -m gibt x86_64 aus) | aggrega-<version>-linux-amd64 |
| Linux | 64-Bit-ARM (uname -m gibt aarch64 aus) | aggrega-<version>-linux-arm64 |
| Windows | 64-Bit-x86 | aggrega-<version>-windows-amd64.exe |
| macOS | Apple Silicon | aggrega-<version>-darwin-arm64 |
| macOS | Intel | aggrega-<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:
sha256sum --check --ignore-missing SHA256SUMSDie 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:
$dir = "$env:LOCALAPPDATA\Programs\aggrega"New-Item -ItemType Directory -Force $dir | Out-NullMove-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
$dirwie im obigen Beispiel:Terminal window $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"$signature.Status$signature.SignerCertificate.SubjectStatusmeldetValid, und der Antragsteller beginnt mitCN=Cognitio S.r.l..NotSignedoderHashMismatchbedeutet, 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-Filebeantwortet 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-Filein 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:
chmod +x aggrega-<version>-darwin-arm64mkdir -p ~/.local/binmv aggrega-<version>-darwin-arm64 ~/.local/bin/aggregamkdir 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:
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64codesign --display --verbose=2 aggrega-<version>-darwin-arm64Der 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.