Dil sunucusu
Dil sunucusu durumu — durum çubuğunun solunda, Release göstergesinin yanında bulunan ve running, starting veya kırmızı renkte not running gösteren bir gösterge. Derleyici ne yaparsa yapsın orada olan tek yüzeydir; bu nedenle hiçbir şeyin çalışmadığını, sessizleşmiş yüzeylerden çıkarmak zorunda kalmak yerine burada öğrenirsiniz — ve araç ipucu iki nedenden hangisinin geçerli olduğunu söyler: burada Aggrega’nın tanıdığı bir klasör yoktur ya da vardır ama sunucu ona bağlı değildir. Üzerine tıklamak, hiçbir şey çalışmıyorken Start, bir şey çalışırken Restart önerir ve seçtiğinizi yapar. Bkz. Dil sunucusu çalışmadığında.
Dil sunucusu çalışmıyorken
Bu uzantının sağladığı her komut, bir dil sunucusu çalışsın ya da çalışmasın, uzantı başladığı andan itibaren vardır ve bunlardan yalnızca ikisi komut dizini onları listelemeden önce bir sunucuyu bekler: aşağıda adı geçen komut ve yalnızca dil sunucusunun Aggregate veya Release olarak bildirdiği bir belgede listelenen Aggrega: Attach a Feature to the connection at the cursor. Ancak bir sunucu bağlandıktan sonra var olan bir komut, tam da ona en çok ihtiyaç duyulan anda — hiçbir şeyin çalışmadığı ve onu başlatmanın yolunu aradığınız anda — komut dizininde eksik olurdu.
Neler olup bittiğini soldaki durum çubuğu göstergesinden öğrenirsiniz. Gösterge running, starting veya kırmızıyla not running gösterir ve araç ipucu nedenini söyler: bu penceredeki hiçbir klasör Aggrega’nın tanıdığı bir klasör değildir ya da böyle bir klasör vardır ve sunucu ona bağlı değildir. Tıklandığında hangisi geçerliyse Start veya Restart sunar ve onu yapar.

Bu gösterge vardır, çünkü çalışamayan bir komut hiçbir şeyi açıklamaz: komut dizini nedenini söylemeden onu dışarıda bırakır ve hiçbir düzenleyici yüzeyi devre dışı bir denetimde araç ipucu göstermez. Gösterge, nedenin yazıldığı yerdir ve aynı zamanda ona göre harekete geçtiğiniz yerdir.
Başarısız bir başlatma, derleyicinin yolunda neyin yanlış olduğunu söyler. aggrega.server.binaryPath hiçbir şeyi adlandırmıyorsa bildirim Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Aggrega dil sunucusu başlatılamadı: ⟨path⟩ konumundaki derleyici bulunamadı.) şeklindedir; çalıştırılamayan bir dosyayı adlandırıyorsa … ⟨path⟩ is not an executable file. (… ⟨path⟩ çalıştırılabilir bir dosya değil.) şeklindedir. ⟨path⟩, uzantının başlatmaya çalıştığı dosyadır: ~/ veya ${userHome} ile başlayan bir ayar, arandığı biçimde ev klasörünüzden çözümlenmiş olarak gösterilir. Her ikisi de devamında aggrega.server.binaryPath ayarını aggrega ikili dosyasına ayarlamanızı söyler ve ayarlar ekranını o tek ayarda açan Open binary path setting ile Show output düğmelerini taşır. Yol hiçbir şeyi adlandırmıyorsa bildirim bu ikisinden önce Download the compiler ve Choose another file düğmelerini de taşır, çünkü bu durumda değiştirilecek bir derleyici yoktur: ilki Derleyiciyi edinme bölümünde açıklandığı gibi bir derleyici indirir, ikincisi elinizdeki bir derleyici dosyasını sorar ve ayarı ona yönlendirir. Var olan ama çalıştırılamayan bir dosyayı oraya siz koymuşsunuzdur, bu nedenle o bildirim indirme sunmaz. Başka herhangi bir başlatma hatası, aynı girişten sonra kendisine verilen nedeni verir ve ardından çalıştırılan derleyiciyi ve onu adlandıran ayarı adlandırır. Aggrega çıktı kanalı da aynı açıklamayı taşır.
Validate, sunucunun çalışmadığını söyler ve geri dönüş yolunu sunar. Hiçbir dil sunucusu çalışmıyorken basıldığında Aggrega: the language server is not running. (Aggrega: dil sunucusu çalışmıyor.) yanıtını verir — son başlatma başarısız olduysa ardından, o hatanın bildirildiği sözlerle nedeni gelir — ve Show output, Open binary path setting ile durum çubuğu göstergesinin kendi Start düğmesini sunar.
Liste panelleri bir hata bildirmek yerine sunucunun çalışmadığını söyler. Hiçbir dil sunucusu çalışmıyorken Registries ve Catalog panellerinin her biri listelerinin yerine göstergenin kendi araç ipucuyla birlikte The Aggrega language server is not running. (Aggrega dil sunucusu çalışmıyor.) çizer ve satıra basmak sunucuyu başlatır. Plugins panelinin listesi dil sunucusundan değil, derleyiciyi bir komut olarak çalıştırmaktan gelir; bu nedenle o komut başlatılamadığında satırı, yolda neyin yanlış olduğunu bildirimin sözleriyle söyler ve ona basmak ayarı açar.
Aggrega: Open status bar menu, hiçbir dil sunucusu yanıt vermiyorken komut dizininin dışında bırakılır: sunduğu her şey çalışan bir dil sunucusu üzerindeki bir eylemdir ve düzenleyiciniz orada çalışamayacak bir komutu listelemez. Bir sunucu yanıt verdiği anda geri gelir.
Sunucu olmadan çalışan bir komut komut dizininde kalır, sunucuyla ilgili olsa bile. Aggrega: Toggle the artifact-rendering stage while inspecting bir tercih yazar ve sunucu bu tercihi başladığında okur — bu nedenle durdurulmuş bir sunucu, onu ayarlamak için en yararlı andır, onu esirgemek için bir neden değil.
Yaşam döngüsü
Uzantı, dil sunucusu sürecinin tüm yaşam döngüsünü yönetir. Dil sunucusunu durdurduğunda — düzenleyici kapandığında, dil sunucusu farklı bir Aggrega çalışma alanına geçtiğinde veya bağlanabileceği tek bir çalışma alanı kalmadığında — önce dil sunucusundan iş birliği içinde çıkmasını ister; bu, devam eden işlerin tamamlanmasına olanak tanır. Bu bekleme süresi dolduğunda dil sunucusu hâlâ çalışıyorsa, bir kez daha istenir — bu sefer işi bitirmek yerine bırakması. Hâlâ çıkmadıysa uzantı, işletim sistemi düzeyinde sonlandırmaya başvurur. Yeniden başlatma — yeniden başlatma komutu, aggrega.server.binaryPath değerinin değişmesi veya uzantının kendisinin yaptığı bir yapılandırma değişikliği — istemez: süreci işletim sistemi düzeyinde sonlandırır ve yeni bir süreç başlatır. Bu adımların her biri Aggrega çıktı kanalına bildirilir; böylece yavaş bir kapanışta hangi adımın zaman aldığı ve dil sunucusunun yanıt verip vermediği görülür. Anlam, POSIX ve Windows ana bilgisayarlarında aynıdır.
İstenmeden duran bir dil sunucusu, sınırlı sayıda yeniden başlatılır. Çalışan bir sunucu sona erdiğinde uzantı yeni bir sunucu başlatır; o da sona ererse — başlarken, uzantının açılış isteğini yanıtlamadan önce ya da çalışırken — sırayla yeniden başlatılır; bu, aggrega.server.respawnWindowSeconds saniye içinde en fazla aggrega.server.respawnAttempts yeniden başlatmaya kadar sürer. Sonuncusundan sonraki sona erme sunucuyu durmuş hâlde bırakır ve sunucuyu yeniden başlatan komutu belirten Aggrega language server has stopped responding. (Aggrega dil sunucusu yanıt vermeyi durdurdu.) iletisini gösterir; bundan sonra hiçbir şey onu kendiliğinden yeniden başlatmaz — böylece her başladığında çöken bir sunucu o kadar kez yeniden başlatılır, daha fazla değil. Aggrega çıktı kanalı her adımı sözcüklerle anlatır: sunucunun beklenmedik şekilde durduğunu ve nasıl sona erdiğini, her yeniden başlatmayı ve ayarın kaç tanesine izin verdiğini, ayağa kalkmayan bir yeniden başlatmayı ve nedenini, ve sunucunun artık yeniden başlatılmayacağını. Sizin istediğiniz bir durdurma veya yeniden başlatma — yeniden başlatma komutu, aggrega.server.binaryPath değerinin değişmesi veya uzantının kendisinin yaptığı bir yapılandırma değişikliği — sayılmaz ve bir yeniden başlatma sayımı sıfırdan başlatır. İlk başlatma ve sizin istediğiniz bir yeniden başlatma başarısız olduğunda tekrarlanmaz: her biri, dil sunucusunun başlatılamadığını nedeniyle birlikte bildiren bildirimle sona erer.
Her dil sunucusu Problems panelini kendi bildirdikleriyle başlatır. Bir sunucu başladığında — ilk sunucu, nasıl istenmiş olursa olsun bir yeniden başlatma, sonuncusu beklenmedik şekilde durduktan sonra yeniden başlatılan bir sunucu, başka bir Aggrega çalışma alanına taşınan bir sunucu ve hiçbirinin çalışmadığı yerde başlatılan bir sunucu — Problems paneli önceki sunucunun bildirdiği her şeyden temizlenir ve açık her YAML dosyası, yeni sunucu yanıt verir vermez ona göre denetlenir. Bir sunucu bildirdiğini geri alamaz ve ondan sonra başlatılan sunucu bunun ne olduğunu bilmez; bu yüzden ortada bırakılan bir bulgu, çalışan hiçbir sunucunun arkasında durmadığı bir bulgu olur — bir taşımadan sonra, ayrıldığınız çalışma alanıyla ilgili bir bulgu. Açık dosyalar denetlenirken bulgular kaybolup yeniden görünür. Yalnızca başka bir isteğin hesapladığı bir bulgu, o istek yeniden çalışana kadar görünmez: derlemenin bulguları grafik çizildiğinde ya da bir derleme veya önizleme derlemesi çalıştığında, bir kilit dosyasının sapma uyarısı grafik çizildiğinde geri gelir — o Release üzerinde bir grafik paneli açıksa, sunucu geri geldiğinde yeniden çizildiği için ikisi birden gelir — ve yayımlama uzlaşımlarına ilişkin bulgular Lint çalıştırdığınızda geri gelir. Durup yerine yenisi gelmeyen bir sunucu — yeniden başlatmaları tükenmiş ya da bağlanacak bir Aggrega çalışma alanı kalmamış — Problems panelini olduğu gibi bırakır.
Dil sunucusu yapılandırmasını başlarken okur ve durana kadar korur. Komut satırı onu her çalıştırmada yeniden okur; bu yüzden .aggrega-config.yaml veya ~/.config/aggrega/config.yaml dosyasında yapılan bir düzenleme bir terminalin yaptığını hemen değiştirir, ancak zaten çalışan bir dil sunucusunda hiçbir şeyi değiştirmez. Bu nedenle uzantı, çalışan sunucunun okuduğunu bildirdiği yapılandırma dosyalarını — Show config komutunun katkıda bulunan dosyalar arasında listelediği dosya yollarını — izler ve bunlardan biri diskte değiştiğinde, silindiğinde veya geri geldiğinde ve böylece sunucunun okuduğuyla artık eşleşmediğinde, dosyayı adlandıran ve dil sunucusunun yapılandırmasını başlarken okuduğunu söyleyen tek bir uyarı gösterir; uyarıda Aggrega: Start or restart the language server komutunu çalıştıran bir Restart server düğmesi bulunur. Tek bir kaydetmeden gelen birkaç yazma tek bir uyarı oluşturur. Uyarı ekrandayken o dosya için yeniden gösterilmez; siz kapattıktan sonra da dosya yeniden değişene kadar gösterilmez; bir yeniden başlatma, izlemeyi yeniden başlatılan sunucunun okuduklarından baştan başlatır. Sunucu başladığında var olmayan bir yapılandırma dosyası okunmamıştır; bu yüzden izlenmez ve böyle bir dosya oluşturmak hiçbir şey göstermez; bir sonraki başlatma onu okur. Hangi dosyaların izlendiği, her sunucu başladığında Aggrega çıktı kanalına yazılır.
Uzantının kendisinin yaptığı bir yapılandırma değişikliği, sormadan dil sunucusu yeniden başlatılarak uygulanır. Bir kayıt defteri eklemek veya kaldırmak, karşılama sayfasından bir kayıt defterini ilk kez doldurmak, bir eklenti eklemek veya kaldırmak, karşılama sayfasından çalışma alanı yapılandırmasını oluşturmak ve dosyayı oluşturması gerektiğinde Aggrega: Set authoring_release in .aggrega-config.yaml… komutunun her birinin ardından bir yeniden başlatma gelir; bu yeniden başlatma sürerken sunucunun okumak üzere olduğu dosyayı adlandıran bir bildirim olarak gösterilir ve bunların hiçbiri uyarı göstermez: o değişikliği siz istediniz. Çalışma alanı yapılandırmasını oluşturmanın dil sunucusunu kendisinin başlattığı durumlarda — hiçbiri çalışmıyordu ya da başka bir klasör için çalışıyordu — bu başlatma yeni dosyayı okur ve ikinci bir yeniden başlatma gelmez. Değişiklikten sonra başlayan bir dil sunucusu onu okuduğunda, işlemin kendi bitiş iletisine, ikinci bir bildirim yerine, değişikliğin artık geçerli olduğunu söyleyen bir cümle eklenir; yeniden başlatma başarısız olduysa ya da değişikliği okuyacak çalışan bir dil sunucusu yoksa cümle çıkarılır, çünkü değişiklik bu durumda dosyadadır ama henüz geçerli değildir. authoring_release ayarı bir cümleyle değil dosyayı açarak sona erer; bu yüzden hiçbir şey eklemez.