Chọn Release bạn làm việc
Release được chọn — một chỉ báo trên thanh trạng thái và một hàng Release ở đầu bảng Commands, mỗi thứ nêu tên một Release duy nhất mà trình soạn thảo đang làm việc. Mọi thứ thao tác trên một Release — xác thực, đồ thị cấu trúc liên kết, xây dựng, xây dựng xem trước và kéo — đều thao tác trên Release đó. Một bảng đồ thị đã mở giữ Release mà nó được vẽ từ đó khi bạn chọn một Release khác, và hiển thị lại đồ thị sẽ vẽ Release mới được chọn. Đồ thị, xây dựng, xây dựng xem trước và kéo đọc các thư mục danh mục mà Release đó được xây dựng dựa trên: các thư mục của riêng nó, nếu cấu hình không gian làm việc của bạn chỉ định một số thư mục cho nó dưới workspace.releases, và nếu không thì các thư mục của không gian làm việc — chính là những thư mục mà aggrega build --release đọc ở terminal, nên một cửa sổ xây dựng mỗi Release của một không gian làm việc dựa trên danh mục riêng của nó mà không cần truyền cờ nào. Bảng Catalog, một lần kiểm tra, mục kiểm tra của hàng Catalog, di chuột, hoàn thành, Go to Definition, Find References và Find Implementations cũng trả lời theo góc nhìn của Release được chọn: khi cấu hình không gian làm việc của bạn chỉ định các thư mục danh mục cho từng Release, mỗi tính năng đọc các tài liệu mà không gian làm việc chứa, trừ những tài liệu trong một thư mục chỉ có Release khác đọc, cùng các thư mục danh mục mà Release được chọn được xây dựng dựa trên — nên một tên được nhiều biến thể khai báo, mỗi biến thể cho một Release, sẽ được phân giải thành tên của Release được chọn. Khi không có Release nào được chọn, chúng trả lời theo góc nhìn của chính không gian làm việc. Xem Chọn một Release.
Chọn một Release
Phần lớn những gì tiện ích mở rộng làm đều có phạm vi theo một Release: những thư mục catalog nào được đọc, những thành phần nào được phân giải, những ghim lockfile nào được áp dụng, và một tài liệu nhận được những phát hiện nào. Vì vậy, tiện ích mở rộng làm việc trên một Release được chọn tại một thời điểm, và cho bạn thấy đó là Release nào trên thanh trạng thái, cạnh biểu tượng tên lửa.
Release bạn chọn được cửa sổ trình soạn thảo đó ghi nhớ. Khi máy chủ ngôn ngữ kết nối, lựa chọn đã ghi nhớ được đối chiếu với những gì không gian làm việc vẫn cung cấp và được khôi phục nếu vẫn còn; nếu đã mất, trình soạn thảo cho bạn biết và quay về những gì không gian làm việc của bạn ngụ ý, đây cũng là nơi lựa chọn bắt đầu khi bạn chưa chọn gì trong cửa sổ này. Câu trả lời đó đến từ, theo thứ tự ưu tiên:
build.authoring_releasetrong.aggrega-config.yaml, cài đặt đã commit mà cả nhóm cùng chia sẻ..aggrega/active-release, một tệp đánh dấu cục bộ không được commit.- Release duy nhất trong không gian làm việc, khi có đúng một Release.
Nhấp vào một trong hai chỉ báo để chọn một Release khác (hoặc chạy Aggrega: Select Release… từ bảng lệnh). Thay đổi có hiệu lực ngay lập tức — không có gì khởi động lại, mọi tệp YAML đang mở được kiểm tra lại theo Release bạn vừa chọn, và bảng Catalog đọc lại danh sách của nó cho Release đó; điều tương tự xảy ra khi một Release được lấy lúc máy chủ ngôn ngữ kết nối. Việc ghi nhớ chỉ cục bộ trong cửa sổ trình soạn thảo: việc chọn không ghi gì vào không gian làm việc của bạn. Nếu tiêu điểm của bạn đang ở bảng Commands khi bộ chọn mở ra — trên hàng Release của nó, hoặc trên bất kỳ điều khiển nào của nó — tiêu điểm sẽ quay lại điều khiển đó khi bộ chọn đóng, dù bạn đã chọn một Release hay bỏ qua nó; nếu mở từ bất kỳ nơi nào khác, bộ chọn để bảng không có tiêu điểm.

Các Releases được cung cấp là những Release nằm bên trong thư mục mà máy chủ ngôn ngữ neo vào, được đặt tên tương đối với thư mục đó, vì đó là dạng mà nó chấp nhận. Khi một Release không thể được cung cấp, trình soạn thảo cho biết có bao nhiêu và chúng nằm ở đâu thay vì lặng lẽ bỏ qua chúng. Máy chủ ngôn ngữ không đọc Release nào qua một liên kết ra khỏi thư mục đó, nên một Release mà cây tệp của trình soạn thảo hiển thị qua một liên kết dẫn ra ngoài — một liên kết tới một thư mục bên ngoài, hoặc tới một tệp Release bên ngoài — sẽ không được cung cấp. Ngoại lệ duy nhất là một liên kết tới một tệp Release mà cấu hình không gian làm việc chỉ định, dưới dạng build.authoring_release hoặc một khóa của workspace.releases: Release đó được đọc qua liên kết của nó và được cung cấp. Việc mở bộ chọn cho biết điều đó trong một thông báo riêng, nêu theo đường dẫn tương đối với thư mục đó từng liên kết như vậy nằm ở nơi mà máy chủ ngôn ngữ lẽ ra sẽ đọc: các liên kết tới thư mục trước, rồi các liên kết tới tệp. Một liên kết có tên kết thúc bằng .yaml hoặc .yml được nêu bất kể tệp mà nó dẫn tới chứa gì, vì tệp đó không được đọc để tìm hiểu điều này.
Khi bạn muốn một lựa chọn được ghi lại trong chính không gian làm việc — để một bản checkout mới bắt đầu từ nó — có hai lệnh làm điều đó, và không lệnh nào thay đổi những gì bạn đang làm ngay lúc này:
- Aggrega: Set the selected Release as this workspace’s default yêu cầu máy chủ ngôn ngữ ghi Release đang được chọn vào
.aggrega/active-release. Tệp đó là cục bộ đối với bản checkout của bạn, nên đó là nơi phù hợp cho một mặc định cá nhân. Khi.aggregahoặc tệp đánh dấu là một liên kết dẫn ra ngoài không gian làm việc Aggrega, không có gì được ghi, và thông báo nêu lý do bằng chính lời của trình biên dịch. - Aggrega: Set authoring_release in .aggrega-config.yaml… mở tệp cấu hình để bạn có thể đặt
build.authoring_release. Cài đặt đó được commit và chia sẻ, và nó được ưu tiên hơn tệp đánh dấu. Khi máy chủ ngôn ngữ báo rằng tệp cấu hình là một liên kết dẫn ra ngoài không gian làm việc Aggrega, tệp không được mở, và một lỗi cho biết nó dẫn ra ngoài không gian làm việc, nên Aggrega không sử dụng nó; điều khiển trên trang chào mừng dùng để tạo cấu hình không gian làm việc cũng làm như vậy với một tệp mà nó thấy đã có sẵn ở đó.
Nếu không gian làm việc không cung cấp Release nào — không có cấu hình, không có tệp đánh dấu, và không có đúng một tệp để dự phòng — chỉ báo sẽ cho biết điều đó, và cho biết trường hợp nào trong hai trường hợp là đúng. Nó hiển thị Release: none selected (Release: chưa chọn) khi có các Releases để chọn nhưng bạn không ở trên Release nào trong số đó, và Release: none available (Release: không có Release nào khả dụng) khi không gian làm việc Aggrega hoàn toàn không cung cấp Release nào. Trường hợp thứ hai không phải là trạng thái bạn có thể giải quyết bằng cách chọn, nên chú giải công cụ của nó nêu các cách thoát khỏi nó — làm việc trong một không gian làm việc Aggrega khác, hoặc tạo một Release — thay vì đưa bạn tới một danh sách chỉ có thể trả về trống rỗng. Khi chưa có gì đọc không gian làm việc, chú giải công cụ cho biết điều đó thay vì báo cáo một con số mà không ai đếm. Mỗi cách hiển thị đó đều mang theo những gì đã được tìm kiếm, và bản giải thích đầy đủ được ghi vào kênh đầu ra Aggrega. Việc xác thực vẫn chạy trong trạng thái đó: bạn nhận được những phát hiện mà một tài liệu tự trả lời được — nó có phân tích cú pháp được không, và hình dạng của chính nó có chấp nhận được không — còn các kiểm tra cần một Release sẽ bị bỏ qua cho đến khi bạn chọn một Release.