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

Uzantıyı kurma

Ön koşullar

  • Masaüstünde Visual Studio Code 1.85 veya daha yenisi. Uzantı aggrega programı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 aggrega derleyicisi. Uzantı, aggrega.server.binaryPath ayarı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 olarak aggrega — ise PATH ü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.yaml dosyasını — okur ve onu bulmak için açılan klasörden yukarı doğru çıkar. Kökü bir workspace: 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:

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:

Terminal window
code --install-extension aggrega-ai.aggrega

Uzantı 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.

Hoş geldiniz sayfasının, yapılacak olarak işaretlenmiş ve Use the compiler on my PATH, Point at a compiler I have ve Download the compiler seçeneklerini sunan derleyici adımı.

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 burada aggrega olarak, Windows’ta ise aggrega.exe olarak 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 SHA256SUMS dosyasıyla karşılaştırarak doğrular, eşleşmeyen bir indirmeyi silip bunu belirtir, dosyayı çalıştırılabilir yapar ve aggrega version -o json ile bir kez çalıştırır. Yalnızca üçünü de geçen bir dosya yerine konur ve ancak o zaman aggrega.server.binaryPath sizin 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.