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

Üzerinde çalıştığınız Release'i seçin

Seçili Release — bir durum çubuğu göstergesi ve Commands panelinin üstündeki bir Release satırı; her biri düzenleyicinin üzerinde çalıştığı tek Release’i adlandırır. Bir Release üzerinde işlem yapan her şey — doğrulama, topoloji grafiği, derleme, önizleme derlemesi ve çekme — o Release üzerinde işlem yapar. Zaten açık olan bir grafik paneli, başka bir Release seçtiğinizde çizildiği Release’i korur ve grafiği yeniden göstermek yeni seçileni çizer. Grafik, derleme, önizleme derlemesi ve çekme, o Release’in derlendiği katalog dizinlerini okur: çalışma alanı yapılandırmanız workspace.releases altında onun için bazılarını belirtiyorsa kendi dizinlerini, aksi takdirde çalışma alanınınkileri — bir terminalde aggrega build --release komutunun okuduklarıyla aynılarını; böylece tek bir pencere, bir çalışma alanının her Release’ini hiçbir bayrak geçirmeden kendi kataloğuna göre derler. Catalog paneli, bir inceleme, Catalog satırının denetimi, üzerine gelme, tamamlama, Go to Definition, Find References ve Find Implementations da seçili Release’in terimleriyle yanıt verir: çalışma alanı yapılandırmanız her Release için katalog dizinleri belirtiyorsa her biri, çalışma alanının barındırdığı belgeleri — yalnızca başka bir Release’in okuduğu bir dizindekiler hariç — ve seçili Release’in derlendiği katalog dizinlerini okur; böylece birkaç varyantın, her Release için bir tane olmak üzere, bildirdiği bir ad seçili Release’inkine çözümlenir. Hiçbir Release seçili değilken çalışma alanının kendi terimleriyle yanıt verirler. Bkz. Bir Release seçme.

Bir Release seçme

Uzantının yaptıklarının çoğu bir Release kapsamındadır: hangi katalog dizinlerinin okunduğu, hangi bileşenlerin çözümlendiği, hangi lockfile sabitlemelerinin uygulandığı ve bir belgenin hangi bulguları aldığı. Bu nedenle uzantı aynı anda tek bir seçili Release üzerinde çalışır ve hangisi olduğunu durum çubuğunda bir roket simgesinin yanında gösterir.

Seçtiğiniz bir Release o düzenleyici penceresi tarafından hatırlanır. Dil sunucusu bağlandığında, hatırlanan seçim çalışma alanının hâlâ sunduklarıyla karşılaştırılır ve hâlâ oradaysa geri yüklenir; kaybolmuşsa düzenleyici bunu size bildirir ve çalışma alanınızın ima ettiğine geri döner; bu pencerede hiçbir şey seçmediğinizde seçim de buradan başlar. Bu yanıt, öncelik sırasına göre şunlardan gelir:

  1. .aggrega-config.yaml içindeki build.authoring_release, tüm ekibin paylaştığı commit edilmiş ayar.
  2. .aggrega/active-release, commit edilmeyen yerel bir işaret dosyası.
  3. Tam olarak bir tane olduğunda, çalışma alanındaki tek Release.

Farklı bir Release seçmek için göstergelerden herhangi birine tıklayın (veya Komut Paleti’nden Aggrega: Select Release… komutunu çalıştırın). Değişiklik hemen etkili olur — hiçbir şey yeniden başlamaz, açık her YAML dosyası az önce seçtiğiniz Release’e göre yeniden denetlenir ve Catalog paneli listesini onun için yeniden okur; dil sunucusu bağlanırken bir Release alındığında da aynısı olur. Hatırlanma düzenleyici penceresine yereldir: seçmek çalışma alanınıza hiçbir şey yazmaz. Seçici açıldığında odağınız Commands panelindeyse — Release satırında veya denetimlerinden herhangi birinde — seçici kapandığında, bir Release seçmiş ya da onu kapatmış olmanızdan bağımsız olarak odak o denetime geri döner; başka herhangi bir yerden açıldığında seçici paneli odaksız bırakır.

Bir çalışma alanının dört Releases'ini yollarıyla listeleyen Release seçicisi; Release satırı ve durum çubuğu hiçbirinin seçili olmadığını gösteriyor.

Sunulan Releases, dil sunucusunun bağlandığı klasörün içindekilerdir ve ona göreli olarak adlandırılır, çünkü kabul ettiği biçim budur. Bir Release sunulamadığında düzenleyici, onları sessizce dışarıda bırakmak yerine kaç tane olduklarını ve nerede durduklarını söyler. Dil sunucusu hiçbir Release’i o klasörün dışına çıkan bir bağlantı üzerinden okumaz; bu nedenle düzenleyicinizin dosya ağacının dışarı çıkan bir bağlantı — dışarıdaki bir dizine ya da dışarıdaki bir Release dosyasına giden bir bağlantı — üzerinden gösterdiği bir Release sunulmaz. Tek istisna, çalışma alanı yapılandırmasının build.authoring_release olarak veya workspace.releases altında bir anahtar olarak adlandırdığı bir Release dosyasına giden bağlantıdır: o Release bağlantısı üzerinden okunur ve sunulur. Seçiciyi açmak bunu kendine ait bir bildirimle söyler ve dil sunucusunun aksi halde okuyacağı yerde duran bu tür her bağlantıyı o klasöre göreli yoluyla adlandırır: önce dizinlere giden bağlantılar, sonra dosyalara giden bağlantılar. Adı .yaml veya .yml ile biten bir bağlantı, gittiği dosya ne içerirse içersin adlandırılır, çünkü bunu öğrenmek için o dosya okunmaz.

Bir seçimin çalışma alanının kendisine kaydedilmesini istediğinizde — yeni bir checkout onunla başlasın diye — bunu iki komut yapar ve ikisi de şu anda üzerinde çalıştığınız şeyi değiştirmez:

  • Aggrega: Set the selected Release as this workspace’s default, dil sunucusunun o anda seçili Release’i .aggrega/active-release dosyasına yazmasını sağlar. Bu dosya checkout’unuza yereldir, bu nedenle kişisel bir varsayılan için doğru yerdir. .aggrega veya işaret dosyası Aggrega çalışma alanının dışına çıkan bir bağlantıysa hiçbir şey yazılmaz ve bildirim nedenini derleyicinin kendi sözleriyle aktarır.
  • Aggrega: Set authoring_release in .aggrega-config.yaml…, build.authoring_release ayarını yapabilmeniz için yapılandırma dosyasını açar. Bu ayar commit edilir ve paylaşılır, ayrıca işaret dosyasından önceliklidir. Dil sunucusu yapılandırma dosyasının Aggrega çalışma alanının dışına çıkan bir bağlantı olduğunu bildirdiğinde dosya açılmaz ve bir hata, dosyanın çalışma alanının dışına çıktığını, bu nedenle Aggrega’nın onu kullanmadığını söyler; karşılama sayfasında çalışma alanı yapılandırması oluşturan denetim de zaten orada bulduğu bir dosyayla aynısını yapar.

Çalışma alanı hiçbir Release sunmuyorsa — hiçbiri yapılandırılmamış, işaret yok ve geri dönülecek tam olarak bir dosya da yok — gösterge bunu söyler ve iki durumdan hangisinin geçerli olduğunu belirtir. Aralarından seçim yapılacak Releases olup hiçbirinde değilseniz Release: none selected (Release: seçili değil), Aggrega çalışma alanı hiç sunmadıysa Release: none available (Release: kullanılabilir yok) gösterir. İkincisi seçim yaparak yanıtlayabileceğiniz bir durum değildir, bu nedenle araç ipucu, yalnızca boş dönebilecek bir listeye göndermek yerine ondan çıkış yollarını — farklı bir Aggrega çalışma alanında çalışmak ya da bir Release oluşturmak — adlandırır. Henüz hiçbir şey çalışma alanını okumamışsa araç ipucu, kimsenin saymadığı bir sayıyı bildirmek yerine bunu söyler. Bu gösterimlerin her biri neyin arandığını taşır ve tam açıklama Aggrega çıktı kanalına yazılır. Doğrulama bu durumda da çalışır: bir belgenin kendi başına yanıtladığı bulguları — ayrıştırılıp ayrıştırılmadığını ve kendi biçiminin kabul edilebilir olup olmadığını — alırsınız; bir Release gerektiren denetimler siz birini seçene kadar atlanır.