İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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:

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

Windows’ta, PowerShell’de:

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

Homebrew ile, macOS ve Linux’ta:

Terminal window
brew install aggrega-ai/tap/aggrega

Scoop ile, Windows’ta:

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

winget ile, Windows’ta:

Terminal window
winget install Cognitio.Aggrega

Ardından çalıştığını doğrulayın:

Terminal window
aggrega version

Bir 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:

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

Komutun 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 SHA256SUMS dosyası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/aggrega olarak, Windows’ta %LOCALAPPDATA%\Programs\aggrega\aggrega.exe olarak; 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. Asla sudo kullanmaz. Windows’ta, elle yapılan adımlardaki Unblock-File gibi, internetten indirilen bir dosyanın taşıyabileceği işareti de kaldırır. macOS’ta curl ile 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), bir fish_add_path satırıyla fish için ~/.config/fish/config.fish ve 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 penceresinin PATH’ine de ekler; böylece aggrega o 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 bir aggrega geliyorsa 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 ekleyen aggrega 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ğin 0.8.7, baştaki v ile 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 orada aggrega, Windows’ta aggrega.exe adı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:

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

PowerShell’de önce pencerede ayarlayın; Remove-Item Env:AGGREGA_VERSION ile kaldırana kadar orada ayarlı kalır:

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

Kurulum 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:

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

irm … | 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/completions içine yazar. aggrega için Bash tamamlaması bu paketi gerektirir.
  • zsh: _aggrega dosyasını ~/.local/share/zsh/site-functions içine yazar ve ~/.zshrc dosyası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ıysa compinit komutunu çalıştırır.
  • fish: aggrega.fish dosyasını, fish’in kendiliğinden okuduğu ~/.config/fish/completions içine yazar.
  • PowerShell: betiği %LOCALAPPDATA%\aggrega\completion.ps1 olarak yazar ve onu yükleyen iki satırı, içinde çalıştığı PowerShell’in tüm host uygulamalarına yönelik profilinize, yani $PROFILE.CurrentUserAllHosts dosyası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 ilkesi RemoteSigned, Unrestricted veya Bypass olduğunda çalışır; Restricted gibi 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:

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

irm … | 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 list yazdırır. curl … | sh altı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,cursor veya --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:

DurumAnlam
0aggrega kuruldu ve bir seçeneğin istediği her adım başarılı oldu
1hiçbir şey kurulmadı ya da kurulan aggrega çalışmadı
2komuta almadığı bir seçenek ya da hiçbir asistan adlandırmayan bir liste verildi; hiçbir şey yapmadı
3aggrega kuruldu ve çalışıyor, ancak kabuk tamamlamanın ayarlanması başarısız oldu
4aggrega kuruldu ve çalışıyor, ancak becerinin kurulması başarısız oldu
5aggrega 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 becerisini aggrega skills install --global ile 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 terminal aggrega’yı bulur; zaten açık olan bir terminal başladığı PATH’i korur. Seçim kaldırıldığında PATH’inize hiçbir şey eklenmez ve bir terminal aggrega.exe dosyası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ı, PATH girdisini 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ında uninstall.exe, lisans metnini içeren LICENSE ve EnVar.dll dosyalarını barındırır; sonuncusu, yükleyicinin ve kaldırıcının PATH’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:

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

Yü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:

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

Windows 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:

Terminal window
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İşlemciDosya
Linux64 bit x86 (uname -m, x86_64 yazdırır)aggrega-<version>-linux-amd64
Linux64 bit ARM (uname -m, aarch64 yazdırır)aggrega-<version>-linux-arm64
Windows64 bit x86aggrega-<version>-windows-amd64.exe
macOSApple siliconaggrega-<version>-darwin-arm64
macOSIntelaggrega-<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:

Terminal window
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:

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")

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, $dir yukarıdaki örnekteki gibi olacak şekilde:

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

    Status, Valid değerini bildirir ve konu CN=Cognitio S.r.l. ile başlar. NotSigned veya HashMismatch, 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-File bu 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’deki Unblock-File bu 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:

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

mkdir, 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:

Terminal window
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64
codesign --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.