Pilih Release yang Anda kerjakan
Release terpilih — indikator bilah status dan baris Release di bagian atas panel Commands, yang masing-masing menyebutkan satu Release yang sedang dikerjakan editor. Segala sesuatu yang bekerja pada Release — validasi, grafik topologi, build, build pratinjau, dan pull — bekerja pada Release tersebut. Panel grafik yang sudah terbuka mempertahankan Release asal gambarnya ketika Anda memilih Release lain, dan menampilkan grafik lagi akan menggambar Release yang baru dipilih. Grafik, build, build pratinjau, dan pull membaca direktori katalog yang menjadi dasar build Release tersebut: direktori miliknya sendiri, jika konfigurasi ruang kerja Anda menunjuk beberapa untuknya di bawah workspace.releases, dan jika tidak, direktori milik ruang kerja — yang sama dengan yang dibaca aggrega build --release di terminal, sehingga satu jendela membangun setiap Release dari sebuah ruang kerja terhadap katalognya sendiri tanpa flag yang perlu diteruskan. Panel Catalog, inspeksi, pemeriksaan baris Catalog, hover, pelengkapan, Go to Definition, Find References, dan Find Implementations juga menjawab menurut Release terpilih: jika konfigurasi ruang kerja Anda menunjuk direktori katalog untuk setiap Release, masing-masing membaca dokumen yang dimuat ruang kerja kecuali yang berada di direktori yang hanya dibaca Release lain, serta direktori katalog yang menjadi dasar build Release terpilih — sehingga nama yang dideklarasikan beberapa varian, satu per Release, diresolusikan ke milik Release terpilih. Jika tidak ada Release yang dipilih, semuanya menjawab menurut ruang kerja itu sendiri. Lihat Memilih Release.
Memilih Release
Sebagian besar yang dilakukan ekstensi dicakup oleh sebuah Release: direktori katalog mana yang dibaca, komponen mana yang di-resolve, pin lockfile mana yang berlaku, dan temuan mana yang didapat sebuah dokumen. Karena itu ekstensi bekerja pada satu Release yang dipilih dalam satu waktu, dan menunjukkan yang mana di bilah status, di samping ikon roket.
Release yang Anda pilih diingat oleh jendela editor itu. Ketika server bahasa terhubung, pilihan yang diingat diperiksa terhadap apa yang masih ditawarkan ruang kerja dan dipulihkan jika masih ada; jika sudah tidak ada, editor memberi tahu Anda dan kembali ke apa yang tersirat dari ruang kerja Anda, yang juga merupakan titik awal pilihan ketika Anda belum memilih apa pun di jendela ini. Jawaban itu berasal dari, menurut urutan prioritas:
build.authoring_releasedi.aggrega-config.yaml, pengaturan yang di-commit dan dibagikan seluruh tim..aggrega/active-release, file penanda lokal yang tidak di-commit.- Satu-satunya Release di ruang kerja, jika jumlahnya tepat satu.
Klik salah satu indikator untuk memilih Release lain (atau jalankan Aggrega: Select Release… dari Command Palette). Perubahan langsung berlaku — tidak ada yang dimulai ulang, setiap file YAML yang terbuka diperiksa ulang terhadap Release yang baru saja Anda pilih, dan panel Catalog membaca ulang daftarnya untuk Release itu; hal yang sama terjadi ketika sebuah Release diambil saat server bahasa terhubung. Ingatan itu bersifat lokal bagi jendela editor: memilih tidak menulis apa pun ke ruang kerja Anda. Jika fokus Anda berada di panel Commands saat pemilih dibuka — pada baris Release-nya, atau pada salah satu kontrolnya — fokus kembali ke kontrol itu saat pemilih ditutup, baik Anda memilih Release maupun menutupnya; jika dibuka dari tempat lain, pemilih meninggalkan panel tanpa fokus.

Releases yang ditawarkan adalah yang berada di dalam folder tempat server bahasa berlabuh, dinamai relatif terhadapnya, karena itulah bentuk yang diterimanya. Jika sebuah Release tidak dapat ditawarkan, editor menyebutkan berapa banyak dan di mana letaknya alih-alih menghilangkannya diam-diam. Server bahasa tidak membaca Release apa pun melalui tautan yang keluar dari folder itu, sehingga Release yang ditampilkan pohon file editor Anda melalui tautan yang mengarah keluar — tautan ke direktori di luar, atau ke file Release di luar — tidak ditawarkan. Satu-satunya pengecualian adalah tautan ke file Release yang disebut konfigurasi ruang kerja, sebagai build.authoring_release atau sebagai kunci workspace.releases: Release itu dibaca melalui tautannya dan ditawarkan. Membuka pemilih menyatakan hal itu dalam notifikasi tersendiri, yang menyebut dengan jalurnya relatif terhadap folder itu setiap tautan semacam itu yang berada di tempat yang seharusnya dibaca server bahasa: tautan ke direktori terlebih dahulu, lalu tautan ke file. Tautan yang namanya berakhiran .yaml atau .yml disebut apa pun isi file yang ditujunya, karena file itu tidak dibaca untuk mengetahuinya.
Jika Anda ingin pilihan dicatat di ruang kerja itu sendiri — agar checkout baru dimulai dengannya — dua perintah melakukannya, dan keduanya tidak mengubah apa yang sedang Anda kerjakan saat ini:
- Aggrega: Set the selected Release as this workspace’s default meminta server bahasa menulis Release yang sedang dipilih ke
.aggrega/active-release. File itu bersifat lokal bagi checkout Anda, sehingga merupakan tempat yang tepat untuk default pribadi. Jika.aggregaatau penanda adalah tautan yang mengarah ke luar ruang kerja Aggrega, tidak ada yang ditulis, dan notifikasi memuat alasannya dengan kata-kata kompiler sendiri. - Aggrega: Set authoring_release in .aggrega-config.yaml… membuka file konfigurasi agar Anda dapat mengatur
build.authoring_release. Pengaturan itu di-commit dan dibagikan, dan prioritasnya lebih tinggi daripada file penanda. Jika server bahasa melaporkan bahwa file konfigurasi adalah tautan yang mengarah ke luar ruang kerja Aggrega, file tidak dibuka, dan sebuah galat menyatakan bahwa file itu mengarah ke luar ruang kerja, sehingga Aggrega tidak menggunakannya; kontrol di halaman sambutan yang membuat konfigurasi ruang kerja melakukan hal yang sama dengan file yang sudah ditemukannya di sana.
Jika ruang kerja tidak menawarkan Release apa pun — tidak ada yang dikonfigurasi, tidak ada penanda, dan tidak ada tepat satu file untuk dijadikan cadangan — indikator menyatakannya, dan menyatakan mana dari dua hal yang benar. Indikator menampilkan Release: none selected (Release: tidak ada yang dipilih) jika ada Releases untuk dipilih dan Anda tidak berada di salah satunya, dan Release: none available (Release: tidak ada yang tersedia) jika ruang kerja Aggrega sama sekali tidak menawarkan satu pun. Yang kedua bukan keadaan yang dapat Anda jawab dengan memilih, sehingga tooltip-nya menyebut cara keluar darinya — bekerja di ruang kerja Aggrega lain, atau membuat Release — alih-alih mengarahkan Anda ke daftar yang hanya bisa kembali kosong. Jika belum ada yang membaca ruang kerja, tooltip menyatakan hal itu alih-alih melaporkan jumlah yang tidak dihitung siapa pun. Setiap tampilan tersebut memuat apa yang dicari, dan penjelasan lengkapnya ditulis ke saluran output Aggrega. Validasi tetap berjalan dalam keadaan itu: Anda mendapatkan temuan yang dapat dijawab sebuah dokumen sendiri — apakah dokumen itu dapat di-parse, dan apakah bentuknya sendiri dapat diterima — dan pemeriksaan yang memerlukan Release dilewati sampai Anda memilihnya.