Server bahasa
Status server bahasa — indikator bilah status di sebelah kiri, di samping indikator Release, yang menampilkan running, starting, atau not running berwarna merah. Ini adalah satu-satunya permukaan yang selalu ada apa pun yang sedang dilakukan kompiler, sehingga di sinilah Anda mengetahui bahwa tidak ada yang berjalan alih-alih dibiarkan menyimpulkannya dari permukaan yang menjadi sepi — dan tooltip-nya menyebutkan alasan mana dari dua alasan yang berlaku: tidak ada folder di sini yang dikenali Aggrega, atau ada folder seperti itu tetapi server tidak terpasang padanya. Mengekliknya menawarkan Start ketika tidak ada yang berjalan dan Restart ketika ada yang berjalan, lalu menjalankan pilihan Anda. Lihat Ketika server bahasa tidak berjalan.
Ketika server bahasa tidak berjalan
Setiap perintah yang disumbangkan ekstensi ini ada sejak ekstensi dimulai, baik server bahasa sedang berjalan maupun tidak, dan hanya dua di antaranya yang menunggu server sebelum indeks perintah mencantumkannya: perintah yang disebut di bawah, dan Aggrega: Attach a Feature to the connection at the cursor, yang hanya dicantumkan di dokumen yang dilaporkan server bahasa sebagai Aggregate atau Release. Perintah yang baru muncul setelah server terhubung akan hilang dari indeks perintah tepat pada saat paling dibutuhkan — saat tidak ada yang berjalan dan Anda sedang mencari cara untuk memulainya.
Indikator bilah status di sebelah kiri adalah tempat Anda mengetahui apa yang sedang terjadi. Indikator ini menampilkan running, starting, atau not running berwarna merah, dan tooltip-nya menyebutkan alasannya: tidak ada folder di jendela ini yang dikenali Aggrega, atau ada satu dan server tidak terhubung ke folder itu. Mengkliknya menawarkan Start atau Restart — mana pun yang berlaku — dan menjalankannya.

Indikator itu ada karena perintah yang tidak dapat dijalankan tidak menjelaskan apa pun: indeks perintah menghilangkannya tanpa menyebutkan alasannya, dan tidak ada permukaan editor yang menampilkan tooltip pada kontrol yang dinonaktifkan. Indikator adalah tempat alasan itu dituliskan, dan juga tempat Anda menindaklanjutinya.
Kegagalan memulai menyebutkan apa yang salah dengan jalur kompiler. Jika aggrega.server.binaryPath tidak menunjuk ke apa pun, notifikasi berbunyi Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Server bahasa Aggrega gagal dimulai: kompiler di ⟨path⟩ tidak ditemukan.); jika menunjuk ke file yang tidak dapat dijalankan, notifikasi berbunyi … ⟨path⟩ is not an executable file. (… ⟨path⟩ bukan file yang dapat dieksekusi.). ⟨path⟩ adalah file yang coba dijalankan oleh ekstensi: pengaturan yang diawali ~/ atau ${userHome} ditampilkan sebagai jalur yang diuraikan dari folder beranda Anda, sebagaimana file itu dicari. Keduanya selanjutnya meminta Anda mengatur aggrega.server.binaryPath ke biner aggrega, dan memuat Open binary path setting, yang membuka layar pengaturan pada pengaturan itu saja, serta Show output. Jika jalur tidak menunjuk ke apa pun, notifikasi juga memuat Download the compiler dan Choose another file sebelum keduanya, karena saat itu tidak ada kompiler yang perlu diganti: yang pertama mengunduh kompiler seperti dijelaskan di Mendapatkan kompiler, dan yang kedua meminta file kompiler yang Anda miliki lalu mengarahkan pengaturan ke file itu. File yang ada tetapi tidak dapat dijalankan adalah file yang Anda letakkan di sana, sehingga notifikasi itu tidak menawarkan unduhan. Kegagalan memulai lainnya memberikan alasan yang diterimanya, setelah pembuka yang sama, lalu menyebut kompiler yang dijalankan dan pengaturan yang menyebutnya. Saluran output Aggrega memuat penjelasan yang sama.
Validate menyatakan bahwa server tidak berjalan, dan menawarkan jalan kembali. Jika ditekan saat tidak ada server bahasa yang berjalan, perintah ini menjawab Aggrega: the language server is not running. (Aggrega: server bahasa tidak berjalan.) — diikuti, jika upaya memulai terakhir gagal, oleh alasannya, dengan kata-kata yang digunakan saat kegagalan itu dilaporkan — dengan Show output, Open binary path setting, dan Start milik indikator bilah status sendiri.
Panel daftar menyatakan bahwa server tidak berjalan alih-alih melaporkan kegagalan. Tanpa server bahasa yang berjalan, panel Registries dan Catalog masing-masing menampilkan The Aggrega language server is not running. (Server bahasa Aggrega tidak berjalan.) di tempat daftarnya, dengan tooltip indikator itu sendiri, dan menekan baris itu memulai server. Daftar panel Plugins berasal dari menjalankan kompiler sebagai perintah, bukan dari server bahasa, sehingga jika perintah itu tidak dapat dimulai, barisnya menyebutkan apa yang salah dengan jalur menggunakan kata-kata notifikasi, dan menekannya membuka pengaturan tersebut.
Aggrega: Open status bar menu dihilangkan dari indeks perintah selama tidak ada server bahasa yang menjawab: semua yang ditawarkannya adalah tindakan pada server bahasa yang sedang berjalan, dan editor Anda tidak mencantumkan perintah yang tidak dapat berjalan di sana. Perintah ini kembali begitu ada server yang menjawab.
Perintah yang dapat bekerja tanpa server tetap berada di indeks perintah, meskipun perintah itu berkaitan dengan server. Aggrega: Toggle the artifact-rendering stage while inspecting menulis sebuah preferensi, dan server membaca preferensi itu saat dimulai — sehingga server yang berhenti adalah saat paling berguna untuk mengaturnya, bukan alasan untuk menyembunyikannya.
Siklus hidup
Ekstensi mengelola seluruh siklus hidup proses server bahasa. Ketika ekstensi menghentikan server bahasa — saat editor ditutup, saat server bahasa berpindah ke workspace Aggrega lain, atau saat tidak ada lagi satu workspace pun yang dapat dilekatinya — ekstensi terlebih dahulu meminta server bahasa untuk keluar secara kooperatif, yang memungkinkan pekerjaan yang sedang berjalan selesai. Jika server bahasa masih bekerja saat masa tenggang itu berakhir, server diminta sekali lagi — kali ini untuk meninggalkan pekerjaan itu alih-alih menyelesaikannya. Jika masih belum keluar, ekstensi beralih ke penghentian tingkat OS. Restart — perintah restart, perubahan aggrega.server.binaryPath, atau perubahan konfigurasi yang dilakukan ekstensi sendiri — tidak meminta: restart menghentikan proses pada tingkat sistem operasi dan memulai proses baru. Setiap langkah ini dilaporkan ke kanal output Aggrega, sehingga penghentian yang lambat menunjukkan langkah mana yang memakan waktu dan apakah server bahasa menjawab sama sekali. Semantiknya identik di host POSIX dan Windows.
Server bahasa yang berhenti tanpa diminta akan dimulai lagi, dengan jumlah kali yang terbatas. Ketika server yang sedang berjalan berakhir, ekstensi memulai server baru; jika server itu juga berakhir — saat dimulai, sebelum menjawab permintaan pembuka ekstensi, atau setelah berjalan — server itu pada gilirannya dimulai lagi, hingga aggrega.server.respawnAttempts kali restart dalam aggrega.server.respawnWindowSeconds detik. Berakhirnya server setelah restart terakhir membuat server tetap berhenti dan memunculkan Aggrega language server has stopped responding. (Server bahasa Aggrega berhenti merespons.), yang menyebutkan perintah untuk memulainya lagi, dan setelah itu tidak ada yang memulainya lagi dengan sendirinya — sehingga server yang mati setiap kali dimulai akan dimulai lagi sebanyak itu dan tidak lebih. Kanal output Aggrega menjelaskan setiap langkah dengan kata-kata: bahwa server berhenti secara tak terduga dan bagaimana server itu berakhir, setiap restart dan berapa kali yang diizinkan pengaturan, restart yang gagal berjalan dan alasannya, serta bahwa server tidak akan dimulai lagi. Penghentian atau restart yang Anda minta — perintah restart, perubahan aggrega.server.binaryPath, atau perubahan konfigurasi yang dilakukan ekstensi sendiri — tidak dihitung, dan restart memulai hitungan lagi dari nol. Start pertama, dan restart yang Anda minta, tidak diulang saat gagal: masing-masing berakhir dengan notifikasi bahwa server bahasa gagal dimulai, beserta alasannya.
Setiap server bahasa memulai panel Problems dari apa yang dilaporkannya sendiri. Saat sebuah server dimulai — server pertama, restart bagaimana pun dimintanya, server yang dimulai lagi setelah yang terakhir berhenti secara tak terduga, server yang dipindahkan ke workspace Aggrega lain, dan server yang dimulai di tempat yang tidak ada server berjalan — panel Problems dikosongkan dari semua yang dilaporkan server sebelumnya, dan setiap file YAML yang terbuka diperiksa terhadap server baru begitu server itu menjawab. Server tidak dapat menarik kembali apa yang telah dilaporkannya, dan server yang dimulai setelahnya tidak tahu apa itu, sehingga temuan yang dibiarkan tetap ada akan menjadi temuan yang tidak didukung oleh server mana pun yang sedang berjalan — setelah perpindahan, temuan tentang workspace yang Anda tinggalkan. Temuan menghilang lalu muncul kembali selama file yang terbuka diperiksa. Temuan yang hanya dihitung oleh permintaan lain tidak muncul sampai permintaan itu dijalankan lagi: temuan build kembali saat graf digambar atau build maupun build pratinjau dijalankan, peringatan drift lockfile saat graf digambar — keduanya sekaligus jika panel graf terbuka pada Release itu, karena panel itu digambar ulang saat server kembali — dan temuan konvensi publikasi saat Anda menjalankan Lint. Server yang berhenti dan tidak digantikan — jatah restart-nya habis, atau tidak ada workspace Aggrega tersisa untuk dilekati — membiarkan panel Problems seperti apa adanya.
Server bahasa membaca konfigurasinya saat dimulai, dan mempertahankannya sampai berhenti. Baris perintah membacanya ulang di setiap eksekusi, sehingga suntingan pada .aggrega-config.yaml atau ~/.config/aggrega/config.yaml langsung mengubah perilaku terminal dan tidak mengubah apa pun di server bahasa yang sudah berjalan. Karena itu ekstensi memantau file konfigurasi yang dilaporkan telah dibaca oleh server yang sedang berjalan — path file yang dicantumkan Show config di antara file yang berkontribusi — dan ketika salah satunya berubah di disk, dihapus, atau muncul kembali, sehingga tidak lagi cocok dengan yang dibaca server, ekstensi memunculkan satu peringatan yang menyebutkan file tersebut dan menyatakan bahwa server bahasa membaca konfigurasinya saat dimulai, dengan tombol Restart server yang menjalankan Aggrega: Start or restart the language server. Beberapa penulisan dari satu kali penyimpanan memunculkan satu peringatan. Peringatan tidak dimunculkan lagi untuk file itu selama masih tampil di layar, juga tidak setelah Anda menutupnya sampai file berubah lagi, dan restart memulai pemantauan dari awal berdasarkan apa yang dibaca server yang di-restart. File konfigurasi yang belum ada saat server dimulai tidak dibaca, sehingga tidak dipantau dan membuatnya tidak memunculkan apa pun; start berikutnya akan membacanya. File mana yang dipantau ditulis ke kanal output Aggrega setiap kali sebuah server dimulai.
Perubahan konfigurasi yang dilakukan ekstensi sendiri diterapkan dengan me-restart server bahasa, tanpa bertanya. Menambahkan atau menghapus registry, menyemai registry dari halaman sambutan, menambahkan atau menghapus plugin, membuat konfigurasi workspace dari halaman sambutan, dan Aggrega: Set authoring_release in .aggrega-config.yaml… ketika perintah itu harus membuat file, masing-masing diikuti oleh restart, yang selama berjalan ditampilkan sebagai notifikasi yang menyebutkan file yang akan dibaca server, dan tidak satu pun memunculkan peringatan: Anda yang meminta perubahan itu. Jika pembuatan konfigurasi workspace memulai server bahasa itu sendiri — tidak ada yang berjalan, atau server berjalan untuk folder lain — start itu membaca file baru, dan tidak ada restart kedua yang menyusul. Begitu server bahasa yang dimulai setelah perubahan telah membacanya, pesan akhir operasi itu sendiri menambahkan satu kalimat yang menyatakan bahwa perubahan kini berlaku, alih-alih notifikasi kedua; jika restart gagal, atau tidak ada server bahasa yang berjalan untuk membaca perubahan, kalimat itu dihilangkan, karena perubahan saat itu ada di file tetapi belum berlaku. Menetapkan authoring_release diakhiri dengan membuka file alih-alih dengan sebuah kalimat, sehingga tidak menambahkan apa pun.