Uzantıyı kurma
Ön koşullar
- Masaüstünde Visual Studio Code 1.85 veya daha yenisi. Uzantı
aggregaprogramını başlatarak çalışır ve onun yerine bir tarayıcının çalıştırabileceği bir sürüm sunmaz; bu nedenle vscode.dev ve github.dev gibi tamamen bir web tarayıcısında çalışan düzenleyicilerde çalışmaz. - Çalışma alanınızın bulunduğu makinede
aggregaderleyicisi. Uzantı,aggrega.server.binaryPathayarının belirttiği derleyiciyi çalıştırır:~/(Windows’ta~\) veya${userHome}ile başlayan bir yol o makinedeki ana klasörünüzden itibaren okunur, diğer her yol yazıldığı gibi kullanılır, düz bir ad — varsayılan olarakaggrega— isePATHüzerinde aranır. Hiçbiri bulunamazsa uzantı sizin için bir tane indirmeyi önerir ve Aggrega: Select Compiler Version sürümü daha sonra değiştirir; bkz. Derleyiciyi edinme. - Aggrega’nın çalışma alanı kökü olarak tanıdığı, açtığınız klasörde veya onun üstünde bulunan bir klasör. Aggrega proje kökünüzdeki tek bir dosyayı —
workspace:bloğu taşıyan.aggrega-config.yamldosyasını — okur ve onu bulmak için açılan klasörden yukarı doğru çıkar. Kökü birworkspace:bloğuyla işaretlemek açık olan ve tercih edilmesi gereken seçimdir; hiç böyle bir blok bildirmemiş bir proje de başka işaretlerle tanınabilir; bunları, daha büyük bir projede yapılandırmanın yapabileceği diğer her şeyle birlikte Aggrega’nın kendi yapılandırma başvurusu ele alır.
Bunların hiçbirini elle düzenlemeniz gerekmez: bkz. Hoş geldiniz sayfası.
Uzantıyı yükleme
Uzantının tanımlayıcısı aggrega-ai.aggrega’dır ve uzantı iki yerde listelenir:
- Visual Studio Code’un yükleme yaptığı Visual Studio Marketplace;
- uzantılarını Open VSX’ten yükleyen düzenleyiciler için Open VSX.
Düzenleyicide Uzantılar görünümünü açın, Aggrega için arama yapın ve tanımlayıcısı aggrega-ai.aggrega olan girdiyi yükleyin.
Bir terminalden, tanımlayıcıyı Visual Studio Code’un komut satırı programına iletin:
code --install-extension aggrega-ai.aggregaUzantı kendi metnini — komutlarını, ayarlarını, görünümlerini ve iletilerini — Visual Studio Code’un çalıştığı görüntüleme dilinde, o dile çevrilmişse o dilde, aksi hâlde İngilizce gösterir; Configure Display Language ile değiştirdiğiniz bir görüntüleme dili, editör yeniden başladığında ona ulaşır. Derleyicinin bildirdikleri, tanılamaları ve bir içe aktarmanın soruları da dahil, tıpkı bir terminalde olduğu gibi derleyicinin ifade ettiği şekilde size ulaşır.
Derleyiciyi edinme
Uzantı, aggrega.server.binaryPath ayarının belirttiği derleyiciyi çalıştırır ve bir tane edinmeyi önermeden önce bir tane bulmaya çalışır. Ayardaki ~/ — Windows’ta ~\ — veya ${userHome} ile başlayan bir yol, çalışma alanınızın bulunduğu makinedeki ana klasörünüzden itibaren okunur; bu nedenle Linux ve macOS’ta ~/.local/bin/aggrega, kurulum betiklerinin oraya koyduğu dosyayı belirtir; diğer her yol yazıldığı gibi kullanılır. Düz bir ad — varsayılanı aggrega — PATH üzerinde aranır ve Aggrega çıktı kanalı bunun hangi dosyayı bulduğunu ve dosyanın bildirdiği sürümü söyler.

Hiçbiri bulunamazsa bir tane indirmeyi önerir — hoş geldiniz sayfasının derleyici adımında, burada Download the compiler düğmesi Use the compiler on my PATH ve Point at a compiler I have düğmelerinin yanında yer alır; ve yolda hiçbir şey olmadığı için dil sunucusunun başlatılamadığını bildiren bildirimde. İndirme işlemi:
- bu uzantının birlikte çalıştığı en yeni yayımlanmış sürümü sunar; bu sürüm, çalışma alanınızın bulunduğu makinenin işletim sistemi ve işlemcisi için derlenmiştir — uzak bir makinede, bir kapsayıcıda veya WSL’de açılmış bir pencerede bu, o makinedir. Releases; 64 bit x86 ve 64 bit ARM üzerinde Linux ve macOS için, 64 bit x86 üzerinde Windows için ikili dosyalar içerir; başka herhangi bir makinede indirme, makine adı belirtilerek reddedilir;
- Aggrega’nın yükleme betiklerinin kullandığı klasörü önerir — Linux ve macOS’ta
~/.local/bin, Windows’ta%LOCALAPPDATA%\Programs\aggrega— derleyici buradaaggregaolarak, Windows’ta iseaggrega.exeolarak kaydedilir ve klasörü değiştirmenize izin verir; sürüm sorunun başlığında yer alır; - herhangi bir şey indirilmeden önce sürümü ve dosyayı onaylamanızı ister, ardından durdurabileceğiniz bir ilerleme gösterir;
- dosyayı sürümün
SHA256SUMSdosyasıyla karşılaştırarak doğrular, eşleşmeyen bir indirmeyi silip bunu belirtir, dosyayı çalıştırılabilir yapar veaggrega version -o jsonile bir kez çalıştırır. Yalnızca üçünü de geçen bir dosya yerine konur ve ancak o zamanaggrega.server.binaryPathsizin kendi ayarlarınızda bu dosyaya ayarlanır.
İndirmeler, düzenleyicinizin uzantılar için kullandığı ve http.proxy ile http.proxyStrictSSL ayarlarının yapılandırdığı proxy üzerinden yapılır. Sürüm listesi veya bir dosya okunamazsa — çevrimdışıysanız, GitHub adresinizden gelen istekleri sınırlıyorsa veya istek reddedilirse — hiçbir şey indirilmez, ayar olduğu gibi bırakılır ve tek bir cümle nedenini söyler.
Yalnızca değiştirmeye yetkili olduğu bir derleyiciyi değiştirir: o paylaşılan klasördeki bir derleyiciyi veya kendi indirdiği bir derleyiciyi; ikincisini bir ayarda değil, o makinede kendi depolama alanında hatırlar. Başka herhangi bir yere koyduğunuz bir derleyicinin üzerine indirme yapması istendiğinde, böyle bir derleyiciyi asla değiştirmediğini söyler ve bunun yerine paylaşılan klasörü önerir.
Asla kendi kendine yükseltme yapmaz. Değiştirebileceği bir derleyici için bir pencere açıldığında sürüm listesini okur ve her sürüm için bir kez daha yeni bir sürümün mevcut olduğunu söyler; kendi gösterdiğiniz bir derleyici hakkında hiçbir şey sormaz.
Aggrega: Select Compiler Version çalıştırdığınız sürümü değiştirir ve siz yeniden değiştirene kadar onu korur. Bu uzantının birlikte çalıştığı sürümleri en yeniden başlayarak listeler ve kullanımda olanı işaretler. Herhangi bir şey indirilmeden önce, derleyicinin bu makinedeki her çalışma alanının kullandığı derleyici olduğunu, dolayısıyla sürümün hepsi için değişeceğini ve kilit dosyasını başka bir sürümün yazdığı bir Release’in Pull işleminin yeniden çalıştırılmasını gerektirebileceğini belirterek uyarır; Download and switch ile onaylarsınız. Yeni sürüm mevcut sürümün yanına indirilir ve her indirme gibi doğrulanır, dil sunucusu onun üzerinde başlatılır ve ancak bundan sonra önceki sürümün yerini alır. Dil sunucusunu başlatmazsa silinir, önceki sürüm kalır ve dil sunucusu yeniden onun üzerinde başlatılır. Açık bir Aggrega çalışma alanı olmayan bir pencerede başlatılacak dil sunucusu yoktur; bu nedenle onun yerine sürüm denetimi geçer ve ileti bunu belirtir. Bir derleyiciyi yalnızca bir indirmenin değiştirebileceği yerde değiştirir; kendiniz bir yere koyduğunuz bir derleyici için bunu söyler ve bunun yerine paylaşılan klasörü önerir.