Aggrega kurulumu
Aggrega iki şeye ihtiyaç duyar: kurulu aggrega ikili dosyası ve bir yapay zekâ asistanıyla yazmak için, asistanınızın istemcisinin ikili dosyanın içerdiği MCP sunucusuna bağlanmış olması. Önce komutlar gelir; her birinin ne yaptığı ve diğer kurulum yolları ardından gelir.
İkili dosyayı kurun
Linux ve macOS’ta, bir terminalde:
curl -fsSL https://aggrega.ai/install.sh | shWindows’ta, PowerShell’de:
irm https://aggrega.ai/install.ps1 | iexHomebrew ile, macOS ve Linux’ta:
brew install aggrega-ai/tap/aggregaScoop ile, Windows’ta:
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucketscoop install aggregawinget ile, Windows’ta:
winget install Cognitio.AggregaArdından çalıştığını doğrulayın:
aggrega versionBir sürüm dizesi, ikili dosyanın bulunduğu ve çalıştırılabildiği anlamına gelir. MCP sunucusunun ihtiyaç duyduğu her şey budur. Her kurulum yolu, ayrıntılı olarak her komutun ne yaptığını, ikili dosyayı nereye koyduğunu ve Windows yükleyicisiyle ya da elle nasıl kurulacağını anlatır.
Bir MCP istemcisi bağlayın
Yapay zekâ asistanınızın istemcisi Aggrega’nın MCP sunucusunu aggrega mcp komutunu çalıştırarak başlatır; MCP sunucusunu bağlama onu ekleyen komutu veya girdiyi istemci istemci verir. Eklenti yükleyen bir asistanda Aggrega eklentisi sunucuyu ve Aggrega becerisini tek adımda ekler: bkz. Eklentiyi yükleme.
Her kurulum yolu, ayrıntılı olarak
Aggrega tek bir yürütülebilir dosya olarak dağıtılır. Tek bir komut onu kurar; ardından gelen elle yapılan adımlar aynı işi elle yapar. Her ikisi de onu her seferinde aynı olan, size ait tek bir klasöre koyar ve hiçbiri yönetici hakları gerektirmez: Linux ve macOS’ta ~/.local/bin/aggrega, Windows’ta %LOCALAPPDATA%\Programs\aggrega\aggrega.exe. Windows’ta Windows yükleyicisi ve winget de onu aynı klasöre, yine yönetici hakları olmadan kurar ve yüklü uygulamalarınız arasında listeler: bkz. Windows yükleyicisiyle kurulum ve winget ile kurulum. macOS ve Linux’ta Homebrew ile Windows’ta Scoop da onu, her biri kendi klasörlerine kurar: bkz. Paket yöneticisiyle kurulum.
Tek komutla kurulum
Kurulum komutu Linux ve macOS’ta curl -fsSL https://aggrega.ai/install.sh | sh, Windows’ta PowerShell içinde irm https://aggrega.ai/install.ps1 | iex komutudur; bunlar İkili dosyayı kurun bölümünün ilk iki komutudur. Bu iki adres en son sürümün eklediği kurulum betiklerine yönlendirir; bu nedenle aynı komutlar sürümün kendi adresleriyle de çalışır:
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 | iexKomutun yaptıkları:
- En son sürümden makineniz için varsayılan ikili dosyayı seçer: 64 bit x86 veya 64 bit ARM üzerinde Linux ve macOS, 64 bit x86 üzerinde Windows. Başka herhangi bir sistemi veya işlemciyi, neyi bulduğunu ya da bunun yerine nereye başvurulacağını söyleyen bir iletiyle reddeder. Apple silicon’lu bir Mac’te, Rosetta 2 üzerinden çalışan bir kabuktan bile Apple silicon ikili dosyasını seçer.
- İkili dosyayı sürümün
SHA256SUMSdosyasına karşı denetler; bunu herhangi bir şey kurmadan önce yapar. SHA-256 özeti listede verilenden farklı olan bir indirme silinir, hiçbir şey kurulmaz ve komut her iki özeti de belirten bir iletiyle durur. - İkili dosyayı yalnızca sizin için kurar: Linux ve macOS’ta
~/.local/bin/aggregaolarak, Windows’ta%LOCALAPPDATA%\Programs\aggrega\aggrega.exeolarak; klasör yoksa oluşturur ve oradaki önceki kopyayı tek adımda değiştirir, bu nedenle komutu yeniden çalıştırmak elinizdeki kopyayı günceller. Aslasudokullanmaz. Windows’ta, elle yapılan adımlardakiUnblock-Filegibi, internetten indirilen bir dosyanın taşıyabileceği işareti de kaldırır. macOS’tacurlile indirir, bu nedenle kurduğu ikili dosya karantina işareti taşımaz (bkz. macOS için önceden derlenmiş ikili dosya). - Komutu erişilebilir kılar. Linux ve macOS’ta, klasör
PATH’inizde değilse, klasörü kabuğunuzun başlarken okuduğu dosyaya ekleyen bir komut yazdırır: zsh için~/.zshrc, bash için~/.bashrc(macOS’ta~/.bash_profile), birfish_add_pathsatırıyla fish için~/.config/fish/config.fishve diğer tüm kabuklar için~/.profile. Bu komutu kendisi çalıştırmaz: komutu çalıştırın ve yeni bir terminal açın. Windows’ta klasör kullanıcıPATH’inizde değilse onu ekler, ayrıca içinde çalıştığı PowerShell penceresininPATH’ine de ekler; böyleceaggregao pencerede ve ondan sonra açılan her terminalde çalışır ve klasörü eklediğini bildirir. - Kurulan ikili dosyanın çalıştığını denetler ve çalışmıyorsa başka bir şey ayarlanmadan önce bir iletiyle durur.
PATH’inizde kurduğu dosyadan önce başka biraggregageliyorsa bir not ekler. - Kurulan sürümü yazdırır; kurduğu ikili dosyayı tam yoluyla çalıştırır, böylece sürüm,
PATH’iniz klasörü kapsamadan önce de görünür. - Sonraki adımlarla biter; bunlar
Next:altında, her biri bir satır olarak yer alır: Başlarken bölümünde anlatıldığı gibi yapay zekâ hızlı başlangıcını çalıştıran komut; Kurulum sırasında asistan becerisini ekleme bölümünde anlatıldığı gibi Aggrega becerisini makinenizdeki yapay zekâ asistanlarına ekleyenaggrega skills install --global; ve kabuk tamamlama ile yukarıdaki Bir MCP istemcisini bağlama için bu sayfanın adresi. Bir seçenek beceriyi zaten kurmuşsa, onun satırı çıkarılır.
Yazdırdıkları kısadır: kurulum yaptığı sürüm ve sistem, indirilen dosya sağlama toplamıyla eşleştiğinde bir satır ve kurduğu yol. Başlarken eksiksiz bir çalıştırmayı gösterir. Aşağıdaki seçenekler gibi sh -s -- sonrasında verilen --verbose, ayrıca sağlama toplamı listesinin adresini, yayın dosyasının adını ve onu indirdiği adresi de yazdırır; install.ps1, aynı anahtara -Verbose olarak sahiptir; bu, betiğin bağımsız değişkenlerle çalıştırılması içindir ve irm … | iex bunu sağlayamaz. Komut reddettiğinde veya bir adım başarısız olduğunda bunu tek satırda bildirir: install.sh için standart hataya, install.ps1 için ise PowerShell’in gösterdiği hata veya uyarı olarak:
aggrega install: error: <what went wrong> - <what to do>Linux ve macOS betiği install.sh; curl veya wget, uname ve sha256sum veya shasum gerektirir. Windows betiği install.ps1, Windows PowerShell 5.1’de ve PowerShell 7’de çalışır.
Kurduğu şeyi iki ayar değiştirir; her biri betiğin çalıştığı ortamdan okunur:
AGGREGA_VERSION, kurulacak sürümü belirtir; örneğin0.8.7, baştakivile veya olmadan yazılabilir. Ayarlanmadığında komut en son sürümü kurar — GitHub’ın latest olarak işaretlediği ve asla ön sürüm olmayan sürüm; bu nedenle bir ön sürüm yalnızca burada belirtildiğinde kurulur.AGGREGA_INSTALL_DIR, varsayılanın yerine kurulum yapılacak klasörü belirtir. İkili dosya oradaaggrega, Windows’taaggrega.exeadını taşır ve komut bu klasörü yukarıdaki gibi erişilebilir kılar.
Linux ve macOS’ta, betiğin alabilmesi için ayarı curl’ün önüne değil sh’nin önüne koyun:
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> shPowerShell’de önce pencerede ayarlayın; Remove-Item Env:AGGREGA_VERSION ile kaldırana kadar orada ayarlı kalır:
$env:AGGREGA_VERSION = "<version>"irm https://aggrega.ai/install.ps1 | iexKurulum sırasında kabuk tamamlamayı ayarlama
--completion ile install.sh kabuk tamamlamayı da ayarlar; böylece Tab tuşu aggrega komutlarını ve bayraklarını tamamlar. Seçenekler sh -s -- ifadesinden sonra gelir; bu ifade onları sh’nin borudan okuduğu betiğe iletir:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completionirm … | iex bir betiğe hiçbir seçenek iletmez. PowerShell’de, kurulum tamamlandıktan sonra, Kabuk tamamlama bölümünde anlatıldığı gibi aggrega completion powershell komutunun yazdığı betikle tamamlamayı ayarlayın. install.ps1, betiğin bağımsız değişkenlerle çalıştırılması için -Completion seçeneğini de kabul eder.
Tamamlamayı yalnızca sizin için, yönetici hakları olmadan, SHELL ayarınızın adlandırdığı kabuk için ya da PowerShell’de içinde çalıştığı PowerShell için ayarlar. Kurulan ikili dosyanın kendi aggrega completion komutunun yazdığı betiği kullanır ve yazdığı ya da değiştirdiği her dosyayı adlandırır:
- bash: betiği, bash-completion paketinin size ait tamamlamaları okuduğu klasör olan
~/.local/share/bash-completion/completionsiçine yazar.aggregaiçin Bash tamamlaması bu paketi gerektirir. - zsh:
_aggregadosyasını~/.local/share/zsh/site-functionsiçine yazar ve~/.zshrcdosyasına, bu klasörü zsh’nin işlev yoluna koyan ve yükleyen üç satır ekler; dosyada daha önce hiçbir şey çalıştırmadıysacompinitkomutunu çalıştırır. - fish:
aggrega.fishdosyasını, fish’in kendiliğinden okuduğu~/.config/fish/completionsiçine yazar. - PowerShell: betiği
%LOCALAPPDATA%\aggrega\completion.ps1olarak yazar ve onu yükleyen iki satırı, içinde çalıştığı PowerShell’in tüm host uygulamalarına yönelik profilinize, yani$PROFILE.CurrentUserAllHostsdosyasına ekler. Windows PowerShell ve PowerShell 7 ayrı profiller tutar; bu nedenle kullandığınız her birinden çalıştırın. Bir profil yalnızca yeni bir pencerenin aldığı yürütme ilkesiRemoteSigned,UnrestrictedveyaBypassolduğunda çalışır;Restrictedgibi başka herhangi bir ilkede hiçbir şey yazmaz ve hangi ilkeyi bulduğunu söyler. İlkeyi asla değiştirmez.
XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR ve ZDOTDIR, bu klasörleri ve dosyaları her kabuğun onları okuduğu şekilde taşır. Yeni bir terminal veya pencere tamamlamayı yükler. Komutu yeniden çalıştırmak, bir betiği yalnızca kurulu aggrega farklı bir betik yazdığında yeniden yazar ve satırları ~/.zshrc dosyasına ya da profile yalnızca bir kez ekler; komut bu sırada ikili dosyayı yeniden kurduğundan, var olan bir kuruluma tamamlama eklemenin yolu da budur.
Kurulum sırasında asistan becerisini ekleme
--skills (PowerShell’de -Skills) ile kurulum komutu ayrıca makinenizdeki yapay zekâ asistanları için tüm projelerinizde Aggrega becerisini — bir yapay zekâ asistanına Aggrega’yı kurmayı ve kullanmayı öğreten talimatları — kurar. İki seçenek birlikte verilebilir:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skillsirm … | iex hiçbir seçenek iletmediği için PowerShell’de, kurulum tamamlandıktan sonra aggrega skills install --global komutunu çalıştırın: -Skills seçeneğinin çalıştırdığı komut budur.
Kurulan ikili dosyanın kendi aggrega skills install --global komutunu çalıştırır; bu komut makinenizdeki asistanları — yapılandırma klasörü ana dizininizde olan ya da komutu PATH’inizde bulunan her birini — arar ve bulduğu her asistanı ve onu neyin bulduğunu yazdırır. Ardından:
- Bir terminalde önce sorar. Bulunan asistanlar için beceriyi kurmak üzere Enter tuşuna basın ya da başka asistanları eklemek için tanımlayıcılarını boşluk veya virgülle ayırarak yazın; tanımlayıcıları
aggrega skills listyazdırır.curl … | shaltında betik kendisini borudan okuduğundan, bunun yerine terminaliniz üzerinden sorar. - Sormak için bir terminal olmadığında, örneğin bir betikte, bulduğu asistanlar için kurar.
- Asistanları kendiniz seçmek için, onları seçenekten sonra virgülle ayırarak verin:
--skills claude-code,cursorveya--skills=claude-code,cursor, PowerShell’de ise-Skills claude-code,cursor. Bu durumda yalnızca bunlar için kurar ve başkalarını aramaz.
Yazdığı her beceri klasörünü yazdırır; örneğin Claude Code için ~/.claude/skills/aggrega; hepsi ana dizininizin altındadır. Komutu yeniden çalıştırmak, önceki bir çalıştırmanın yazdığı kopyaları değiştirir; beceri, ikili dosyayı daha yeni bir sürüme bu şekilde izler. aggrega skills, komutu, her asistanın okuduğu klasörü ve her birini neyin bulduğunu açıklar.
Bir adım yapılamadığında
Tamamlama ayarlanamadığında — dash gibi ayarlamadığı bir kabuk, yazamadığı bir klasör ya da hiçbir profil çalıştırmayan bir PowerShell yürütme ilkesi — veya beceri kurulamadığında — hiçbir asistan bulunamadığında ve hiçbiri adlandırılmadığında, tanımadığı bir tanımlayıcıda ya da bir beceri klasöründe hiçbir kurulumun yazmadığı bir dosya olduğunda — ikili dosya yine de kurulur ve çalışır. Komut adımın neden başarısız olduğunu söyler, sonraki adımları yazdırır ve hangi adımın başarısız olduğunu belirten bir durumla sona erer. Durumlar şunlardır:
| Durum | Anlam |
|---|---|
0 | aggrega kuruldu ve bir seçeneğin istediği her adım başarılı oldu |
1 | hiçbir şey kurulmadı ya da kurulan aggrega çalışmadı |
2 | komuta almadığı bir seçenek ya da hiçbir asistan adlandırmayan bir liste verildi; hiçbir şey yapmadı |
3 | aggrega kuruldu ve çalışıyor, ancak kabuk tamamlamanın ayarlanması başarısız oldu |
4 | aggrega kuruldu ve çalışıyor, ancak becerinin kurulması başarısız oldu |
5 | aggrega kuruldu ve çalışıyor, ancak bunların ikisi de başarısız oldu |
PowerShell betiği içinde çalıştığı pencereyi hiçbir zaman kapatmaz, bu nedenle durumu $LASTEXITCODE içinde bırakır ve 0 dışındaki her durum bir hatayla sona erer; powershell -Command ve pwsh -Command bunu çıkış durumu 1 olarak bildirir.
Windows yükleyicisiyle kurulum
Her sürüm, https://github.com/aggrega-ai/aggrega-cli/releases adresindeki sürüm sayfasında bir Windows yükleyicisi, aggrega-<version>-windows-amd64-setup.exe, içerir. İndirip çalıştırın. Varsayılan aggrega.exe dosyasını kısa bir sihirbaz aracılığıyla yalnızca sizin için, yönetici hakları olmadan ve bunları istemeden kurar:
- Bir karşılama sayfası, ardından lisans, yani Aggrega’nın Apache License 2.0 lisansı: I Agree düğmesine basana kadar hiçbir şey kurulmaz. Ardından bileşenler: her zaman kurulan Aggrega’nın kendisi ve seçili olan Add to PATH.
- Kurulum klasörü, başka birini seçmediğiniz sürece
%LOCALAPPDATA%\Programs\aggrega; bu, kurulum komutunun kullandığı klasördür. - İlerleme, ardından klasörü adlandıran ve bu kurulumun onu
PATH’inize ekleyip eklemediğini söyleyen bir bitiş sayfası, sonraki adımlarla birlikte: Aggrega becerisiniaggrega skills install --globalile kurmak ve yapay zekâ istemcinizi Bir MCP istemcisi bağlayın bölümünde anlatıldığı gibi bağlamak.
Ne yapar:
- Add to PATH seçiliyse, kurulum klasörünü kullanıcı
PATH’inize ekler; zaten oradaysa eklemez. Kurulumdan sonra açılan bir terminalaggrega’yı bulur; zaten açık olan bir terminal başladığıPATH’i korur. Seçim kaldırıldığındaPATH’inize hiçbir şey eklenmez ve bir terminalaggrega.exedosyasını tam yoluyla çalıştırır; önceki bir kurulumun eklediği bir girdi olduğu gibi bırakılır. - Aggrega’yı yüklü uygulamalarınız arasında listeler; yayımcı Cognitio s.r.l.‘dir, bu nedenle diğer tüm uygulamalar gibi Ayarlar → Uygulamalar üzerinden kaldırılır. Kaldırıcı onaylamanızı ister, ardından yükleyicinin klasöre koyduğu dosyaları,
PATHgirdisini ve o listedeki girdiyi kaldırır; klasörde başka bir şey kalmadığında klasörü de kaldırır. - Yeniden çalıştırıldığında mevcut olanın üzerine kurar ve en son kurduğu klasörü önerir; böylece sonraki bir sürümün yükleyicisi elinizdeki kopyayı günceller ve
PATH’inizde tek bir girdi tutar. - Klasör,
aggrega.exe’nin yanındauninstall.exe, lisans metnini içerenLICENSEveEnVar.dlldosyalarını barındırır; sonuncusu, yükleyicinin ve kaldırıcınınPATH’inizi düzenlemek için kullandığı bileşendir.
aggrega.exe çalışırken — bir düzenleyici veya bir yapay zekâ istemcisi tarafından başlatılmışsa — yükleyici onu değiştiremez ve bunu belirten bir iletiyle durur; onu başlatanı kapatın ve yükleyiciyi yeniden çalıştırın. Kaldırıcı da hiçbir şeyi kaldırmadan önce aynı şekilde durur.
Pencere olmadan kurmak için, bir betikten veya birçok makineye yazılım kuran bir araçtan, yükleyiciyi büyük harfle yazılmış /S ile çalıştırın; bu durumda pencere veya soru olmadan, önceki bir kurulumun kullandığı klasöre, yoksa varsayılan klasöre, Add to PATH ile kurar ve bir hatayı 0 olmayan çıkış koduyla bildirir. Kaldırıcı da aynı anahtarı kabul eder:
.\aggrega-<version>-windows-amd64-setup.exe /S& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /SYükleyici, yürütülebilir dosyalar gibi, yayımcı Cognitio S.r.l. ve bir zaman damgasıyla imzalanmıştır: Windows için önceden derlenmiş ikili dosya bölümündeki denetimler aggrega.exe için olduğu gibi ona da uygulanır; Windows’un indirilmiş bir dosya için gösterebileceği istemler hakkında orada söylenenler de öyle. SHA256SUMS, sürümün diğer tüm dosyalarında olduğu gibi onun özetini de listeler.
Yükleyici uygun değilse yukarıdaki kurulum komutu ve elle yapılan adımlar aynı aggrega.exe dosyasını aynı klasöre kurar.
Paket yöneticisiyle kurulum
Her sürüm ayrıca bir Homebrew formülünü ve bir Scoop bildirimini (manifest) günceller; böylece zaten kullandığınız paket yöneticisi Aggrega’yı kurabilir ve güncel tutabilir. Her biri, kurulum komutunun kurduğu varsayılan ikili dosyanın aynısını kurar ve sürümün SHA256SUMS dosyasının onun için verdiği SHA-256 özetine karşı denetler.
macOS ve Linux’ta brew install aggrega-ai/tap/aggrega, onu Homebrew ile kurar. Homebrew ilk seferde aggrega-ai/tap tap’ini ekler ve sisteminiz ile işlemciniz için ikili dosyayı kurar: Apple silicon veya Intel üzerinde macOS, 64 bit x86 veya 64 bit ARM üzerinde Linux. Yeni bir sürümden sonra brew upgrade, kurduğunuz diğer tüm formüllerle birlikte onu günceller.
Windows’ta Scoop ile Aggrega bucket’ını bir kez scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket ile ekleyin ve oradan scoop install aggrega ile kurun. Scoop, Windows ikili dosyasını aggrega.exe olarak kurar ve PATH’inizde tuttuğu shim klasörü aracılığıyla aggrega olarak erişilebilir kılar. Yeni bir sürümden sonra scoop update bucket’ları yeniler ve scoop update aggrega Aggrega’yı günceller.
Homebrew ve Scoop, ~/.local/bin veya %LOCALAPPDATA%\Programs\aggrega yerine her biri kendi klasörlerine kurar ve yalnızca kendi kurdukları kopyayı günceller. Bir makinede tek bir kurulum yöntemi kullanın: kurulum komutuyla veya elle kurulan bir kopya ile Homebrew veya Scoop ile kurulan bir kopya iki ayrı kopyadır ve hangisinin çalışacağına PATH’inizde önce gelen klasör karar verir.
winget ile kurulum
Windows’ta winget install Cognitio.Aggrega, onu Windows Paket Yöneticisi olan winget ile kurar. winget, sürümün Windows yükleyicisini sürüm sayfasından indirir, paketin bildiriminde verilen SHA-256 özetine karşı denetler ve gözetimsiz olarak çalıştırır. Sonuç yükleyicinin kendi sonucudur: %LOCALAPPDATA%\Programs\aggrega içinde ya da önceki bir kurulumun kullandığı klasörde aggrega.exe, kullanıcı PATH’inizde bu klasör ve yüklü uygulamalar listenizde Aggrega; hepsi yönetici hakları olmadan. winget içinde çalıştığı terminalin PATH’ini değiştirmez, bu nedenle aggrega version komutunu çalıştırmadan önce yeni bir terminal açın.
winget upgrade Cognitio.Aggrega üzerine sonraki bir sürümü kurar ve winget uninstall Cognitio.Aggrega kaldırıcısını çalıştırır. Yükleyicide başka bir klasör seçmediğiniz sürece winget, yükleyici ve kurulum komutu hepsi aynı klasöre kurar, bu nedenle oradaki aggrega.exe dosyasını en son hangisi çalıştıysa o koyar.
Elle kurulum
Her sürüm, 64 bit x86 ve 64 bit ARM üzerinde Linux, 64 bit x86 üzerinde Windows ve Apple silicon ile Intel üzerinde macOS için önceden derlenmiş ikili dosyaları https://github.com/aggrega-ai/aggrega-cli/releases adresindeki sürüm sayfasında içerir. İşletim sisteminize ve işlemcinize uygun yürütülebilir dosyayı indirin — aşağıdaki Dosyayı seçme bölümü her birinin adını verir — ve orada anlatıldığı gibi sürümün SHA256SUMS dosyasına karşı denetleyin. Ardından yürütülebilir olarak işaretleyin ve ~/.local/bin/aggrega konumuna taşıyın. Linux’ta, indirilen dosyanın bulunduğu dizinden, <version> yerine indirdiğiniz sürümü ve 64 bit ARM’de amd64 yerine arm64 yazarak:
chmod +x aggrega-<version>-linux-amd64mkdir -p ~/.local/binmv aggrega-<version>-linux-amd64 ~/.local/bin/aggregaWindows için aşağıdaki Windows için önceden derlenmiş ikili dosya bölümüne, macOS için macOS için önceden derlenmiş ikili dosya bölümüne bakın.
~/.local/bin PATH’inizde değilse bu satırı kabuğunuzun başlarken okuduğu dosyaya — zsh için ~/.zshrc, bash için ~/.bashrc (macOS’ta ~/.bash_profile) — ekleyin ve yeni bir terminal açın:
export PATH="$HOME/.local/bin:$PATH"Kaynaktan kurmak için, kurulu bir Go araç zinciriyle aggrega komutunu kaynak ağacından derleyin ve elde edilen ikili dosyayı aynı klasöre koyun.
Kurulumu, İkili dosyayı kurun bölümünün sonunda olduğu gibi aggrega version ile doğrulayın.
Dosyayı seçme
Bir sürüm her yürütülebilir dosyayı aggrega-<version>-<system>-<processor> olarak adlandırır; Windows’ta sonuna .exe eklenir:
| Sistem | İşlemci | Dosya |
|---|---|---|
| Linux | 64 bit x86 (uname -m, x86_64 yazdırır) | aggrega-<version>-linux-amd64 |
| Linux | 64 bit ARM (uname -m, aarch64 yazdırır) | 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 |
Bu dosya, kurulum komutunun kurduğu ve elle indirilecek olan dosyadır. Yanında onun iki varyantı bulunur; kurulum komutu hiçbirini kurmaz ve her biri elle aynı şekilde kurulur:
aggrega-debug-<version>-…, bir hata ayıklayıcının veya profil oluşturucunun okuduğu hata ayıklama bilgilerini içeren aynı programdır. Varsayılan dosyayla tam olarak aynı şekilde çalışır ve sürümünü bildirir; boyutu daha büyüktür.aggrega-light-<version>-…, gömülü plugin’ler olmadan derlenmiştir: çekirdek plugin’leri kendi içinde bulmak yerine her plugin’i, çalışma alanının yapılandırdığı şekilde plugin basamağı aracılığıyla çözümler.
Windows için sürüm ayrıca varsayılan dosyayı sizin için kuran Windows yükleyicisi olan aggrega-<version>-windows-amd64-setup.exe dosyasını içerir.
Her sürüm ayrıca SHA256SUMS içerir: iki kurulum betiği dahil, eklediği diğer tüm dosyaların SHA-256 özeti, sha256sum’ın okuduğu biçimde. Kurulum komutu bu denetimi kendisi yapar. Linux’ta bir indirmeyi elle denetlemek için, SHA256SUMS aynı dizindeyken:
sha256sum --check --ignore-missing SHA256SUMSİndirdiğiniz dosya OK olarak bildirilir; başka herhangi bir bildirim, dosyanın sürümün yayımladığı dosya olmadığı anlamına gelir.
Windows için önceden derlenmiş ikili dosya
Windows yürütülebilir dosyası aggrega-<version>-windows-amd64.exe dosyasıdır (sürümde yanında bulunan hata ayıklama ve hafif varyantlar da aynı şekilde kurulur). Dosyayı aggrega.exe olarak yeniden adlandırın, kurulum komutunun kullandığı klasör olan %LOCALAPPDATA%\Programs\aggrega içine taşıyın ve bu klasörü kullanıcı PATH’inize ekleyin: Windows, .exe ile biten bir dosyayı yürütülebilir olarak işaretlemeden çalıştırır ve bu ad altında aggrega komutu olarak bulur. Örneğin PowerShell’den, <version> yerine indirdiğiniz sürümü yazarak:
$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")Bundan sonra açılan bir terminal aggrega’yı bulur; zaten açık olan bir terminal ise başlatıldığı PATH’i korur.
Yürütülebilir dosyalar imzalıdır. Her biri, Windows’un denetlediği kod imzası olan bir Authenticode imzası taşır ve Windows’un bunun için gösterdiği yayıncı Cognitio S.r.l.‘dir. Her imza ayrıca bir zaman damgası taşır: bir imzanın arkasındaki sertifika yalnızca birkaç gün geçerlidir ve sertifikanın süresi dolduktan sonra imzayı geçerli tutan şey zaman damgasıdır. İndirilen bir dosyayı çalıştırmadan önce denetlemek için:
-
Dosya Gezgini’nde, dosyanın Özellikler penceresini ve Dijital İmzalar sekmesini açın. İmza listesi Cognitio S.r.l. adını gösterir; bunu seçip ardından Ayrıntılar’ı seçin; bu, Bu dijital imza geçerli. bilgisini verir.
-
PowerShell’de,
$diryukarıdaki örnekteki gibi olacak şekilde:Terminal window $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"$signature.Status$signature.SignerCertificate.SubjectStatus,Validdeğerini bildirir ve konuCN=Cognitio S.r.l.ile başlar.NotSignedveyaHashMismatch, dosyanın sürümün yayımladığı dosya olmadığı ya da imzalandıktan sonra değiştirildiği anlamına gelir.
Bir imza yayıncıyı adlandırır; her uyarıyı ortadan kaldırmaz. Hangisiyle karşılaşacağınız, dosyanın nasıl geldiğine ve onu nasıl başlattığınıza bağlıdır:
- İndirme sırasında, bir tarayıcı dosyanın yaygın olarak indirilmediği konusunda uyarabilir ve dosyayı saklayıp saklamayacağınızı sorabilir. Saklamak, dosyayı indirildiği haliyle kaydeder.
- Dosyayı Dosya Gezgini’nden veya tarayıcıdan başlattığınızda, Windows Windows bilgisayarınızı korudu uyarısını gösterebilir. Bu istem, bir dosyanın ve yayıncısının oluşturduğu itibarı değerlendiren Microsoft Defender SmartScreen’den gelir; bu nedenle yeni yayımlanmış bir sürüm, imzalı olsa bile, kendi itibarı oluşana kadar bu istemle karşılaşabilir. İmzalı bir dosya için istem yayıncıyı adlandırır: Daha fazla bilgi’yi seçin, Cognitio S.r.l. adını ve indirdiğiniz dosyanın adını gösterdiğini denetleyin, ardından Yine de çalıştır’ı seçin. Bunun yerine PowerShell’den veya bir komut isteminden başlatıldığında aynı dosya bu istem olmadan çalışabilir; bunun olup olmayacağı Windows sürümüne ve ayarlarına bağlıdır.
Unblock-Filebu istemi önceden yanıtlar. İndirilen bir dosya internetten geldiği şeklinde işaretlenir ve Windows bilgisayarınızı korudu denetiminin baktığı şey bu işarettir. Yukarıdaki örnekte olduğu gibi PowerShell’dekiUnblock-Filebu işareti kaldırır; Dosya Gezgini’nde dosyanın Özellikler penceresindeki Genel sekmesinde bulunan Engellemeyi kaldır onay kutusu da aynısını yapar.- Akıllı Uygulama Denetimi açıksa (Windows 11), bir programı başlattığınızda onu denetler. Microsoft’un açıkladığı şekliyle Akıllı Uygulama Denetimi önce Microsoft’un bulut güvenlik hizmetine programın güvenli olup olmadığını sorar; bu hizmet güvenilir bir tahminde bulunamadığında imzayı denetler, geçerli imzalı bir programın çalışmasına izin verir ve imzasız ya da imzası geçersiz olanı engeller. Açık olup olmadığı Windows Güvenliği’nde Uygulama ve tarayıcı denetimi altında gösterilir.
macOS için önceden derlenmiş ikili dosya
macOS yürütülebilir dosyaları, Apple silicon’lu bir Mac için aggrega-<version>-darwin-arm64 ve Intel işlemcili bir Mac için aggrega-<version>-darwin-amd64 dosyalarıdır; hangisine sahip olduğunuzu Apple menüsündeki Bu Mac Hakkında gösterir. Sürümde yanlarında bulunan hata ayıklama ve hafif varyantlar da aynı şekilde kurulur. Apple silicon’lu bir Mac, kuruluysa Rosetta 2 aracılığıyla Intel dosyasını da çalıştırır, ancak onun için derlenmiş olan Apple silicon dosyasıdır.
Dosyayı aggrega olarak yeniden adlandırın, yürütülebilir olarak işaretleyin ve kurulum komutunun kullandığı klasör olan ~/.local/bin içine taşıyın. Örneğin Terminal’den, indirilen dosyanın bulunduğu dizinde, <version> yerine indirdiğiniz sürümü ve Intel Mac’te arm64 yerine amd64 yazarak:
chmod +x aggrega-<version>-darwin-arm64mkdir -p ~/.local/binmv aggrega-<version>-darwin-arm64 ~/.local/bin/aggregamkdir, klasör henüz yoksa onu oluşturur. ~/.local/bin, macOS’un yeni bir terminale verdiği PATH üzerinde değildir; bu nedenle zaten orada değilse Elle kurulum bölümündeki satırı ~/.zshrc dosyasına veya bash için ~/.bash_profile dosyasına ekleyin.
Yürütülebilir dosyalar imzalanmış ve onaylanmıştır (notarize edilmiştir). Her biri, Cognitio s.r.l.‘nin Developer ID’siyle — Apple’ın Mac App Store dışında dağıtılan yazılımlar için bir geliştiriciye verdiği sertifika — güçlendirilmiş çalışma zamanı (hardened runtime) ve güvenli bir zaman damgasıyla yapılmış bir kod imzası taşır ve Apple’ın onay hizmeti her birini denetleyip onaylamıştır. macOS’un internetten gelen yazılımlar için yaptığı denetim olan Gatekeeper, karantina işareti — bir web tarayıcısının indirdiği dosyaya eklediği işaret — taşıyan bir programı değerlendirir ve Apple’ın onayladığı programı kabul eder; bu nedenle sürüm sayfasından indirilen bir dosya olduğu gibi çalışır. Bir onay bileti tek bir yürütülebilir dosyaya eklenemez, bu nedenle Gatekeeper bileti dosya ilk kez çalıştığında çevrimiçi olarak bulur; o anda çevrimdışı olan bir Mac’te Gatekeeper, Mac Apple’a ulaşabilene kadar dosyayı engelleyebilir.
İndirilen bir dosyayı çalıştırmadan önce denetlemek için Terminal’den, indirdiğiniz dosya adıyla:
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64codesign --display --verbose=2 aggrega-<version>-darwin-arm64İlki dosyanın valid on disk olduğunu ve satisfies its Designated Requirement olduğunu bildirir. İkincisi imzanın yetkililerini listeler; bunların ilki Developer ID Application: COGNITIO SRL ve ardından parantez içinde ekip tanımlayıcısıdır; ayrıca bir Timestamp gösterilir. Bunlardan herhangi birinde başarısız olan bir dosya, sürümün yayımladığı dosya değildir veya imzalandıktan sonra değiştirilmiştir.
curl ile alınan bir dosya karantina işareti taşımaz, bu nedenle Gatekeeper onu hiç değerlendirmez: curl, bir tarayıcının eklediği işareti eklemez. Kurulum komutunun yerleştirdiği ikili dosyanın bu değerlendirme olmadan çalışmasının nedeni de budur.