Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Máy chủ ngôn ngữ

Trạng thái máy chủ ngôn ngữ — một chỉ báo trên thanh trạng thái ở bên trái, cạnh chỉ báo Release, hiển thị running, starting, hoặc not running màu đỏ. Đây là bề mặt duy nhất luôn hiện diện bất kể trình biên dịch đang làm gì, nên đây là nơi bạn biết rằng không có gì đang chạy thay vì phải suy ra điều đó từ những bề mặt đã im lặng — và chú giải công cụ của nó cho biết lý do nào trong hai lý do áp dụng: không có thư mục nào ở đây được Aggrega nhận diện, hoặc có một thư mục như vậy nhưng máy chủ không được gắn vào nó. Nhấp vào nó sẽ đưa ra Start khi không có gì đang chạy và Restart khi có thứ đang chạy, và thực hiện lựa chọn của bạn. Xem Khi máy chủ ngôn ngữ không chạy.

Khi máy chủ ngôn ngữ không chạy

Mọi lệnh mà tiện ích mở rộng này đóng góp đều tồn tại ngay từ lúc nó khởi động, dù máy chủ ngôn ngữ có đang chạy hay không, và chỉ hai lệnh trong số đó chờ một máy chủ trước khi chỉ mục lệnh liệt kê chúng: lệnh được nêu bên dưới, và Aggrega: Attach a Feature to the connection at the cursor, lệnh chỉ được liệt kê trong một tài liệu mà máy chủ ngôn ngữ báo là một Aggregate hoặc một Release. Một lệnh chỉ xuất hiện sau khi một máy chủ đã gắn vào sẽ vắng mặt khỏi chỉ mục lệnh đúng vào lúc cần nó nhất — lúc không có gì đang chạy và bạn đang tìm cách khởi động nó.

Chỉ báo trên thanh trạng thái ở bên trái là nơi bạn biết được chuyện gì đang xảy ra. Nó hiển thị running, starting, hoặc not running màu đỏ, và chú giải công cụ của nó cho biết lý do: không có thư mục nào trong cửa sổ này là thư mục mà Aggrega nhận ra, hoặc có một thư mục như vậy nhưng máy chủ không gắn vào nó. Nhấp vào nó sẽ cung cấp Start hoặc Restart — tùy trường hợp — và thực hiện điều đó.

Thanh trạng thái báo bằng màu đỏ rằng máy chủ ngôn ngữ Aggrega không chạy, và menu mà chỉ báo của nó mở ra, cung cấp Start.

Chỉ báo đó tồn tại vì một lệnh không thể chạy thì không giải thích được gì: chỉ mục lệnh bỏ nó ra mà không nói lý do, và không có bề mặt nào của trình soạn thảo hiển thị chú giải công cụ trên một điều khiển bị vô hiệu hóa. Chỉ báo là nơi lý do được ghi lại, và cũng là nơi bạn hành động theo nó.

Một lần khởi động thất bại sẽ cho biết đường dẫn của trình biên dịch có vấn đề gì. Khi aggrega.server.binaryPath không trỏ tới gì, thông báo hiển thị Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Không khởi động được máy chủ ngôn ngữ Aggrega: không tìm thấy trình biên dịch tại ⟨path⟩.); khi nó trỏ tới một tệp không thể chạy, thông báo hiển thị … ⟨path⟩ is not an executable file. (… ⟨path⟩ không phải là tệp thực thi.). ⟨path⟩ là tệp mà tiện ích mở rộng đã cố khởi động: một cài đặt bắt đầu bằng ~/ hoặc ${userHome} được hiển thị ở dạng đã phân giải từ thư mục chính của bạn, đúng như cách nó được tìm kiếm. Cả hai đều tiếp tục yêu cầu đặt aggrega.server.binaryPath thành tệp nhị phân aggrega, và kèm theo Open binary path setting, nút mở màn hình cài đặt tại đúng cài đặt đó, và Show output. Khi đường dẫn không trỏ tới gì, thông báo còn kèm Download the compiler và Choose another file trước hai nút đó, vì khi ấy không có trình biên dịch nào để thay thế: nút đầu tải xuống một trình biên dịch như mô tả trong Lấy trình biên dịch, và nút sau hỏi một tệp trình biên dịch bạn đang có và trỏ cài đặt tới nó. Một tệp có ở đó nhưng không thể chạy là tệp bạn đã đặt ở đó, nên thông báo đó không cung cấp việc tải xuống. Mọi lỗi khởi động khác sẽ nêu lý do nhận được, sau cùng phần mở đầu đó, rồi nêu trình biên dịch đã được chạy và cài đặt chỉ định nó. Kênh đầu ra Aggrega cũng ghi lại cùng nội dung đó.

Validate cho biết máy chủ không chạy và đưa ra cách quay lại. Khi được nhấn lúc không có máy chủ ngôn ngữ nào đang chạy, nó trả lời Aggrega: the language server is not running. (Aggrega: máy chủ ngôn ngữ không chạy.) — tiếp theo, nếu lần khởi động trước thất bại, là lý do, bằng đúng lời mà lỗi đó đã được báo cáo — kèm Show output, Open binary path setting, và Start của chính chỉ báo trên thanh trạng thái.

Các bảng danh sách cho biết máy chủ không chạy thay vì báo một lỗi. Khi không có máy chủ ngôn ngữ nào đang chạy, các bảng Registries và Catalog mỗi bảng đều vẽ The Aggrega language server is not running. (Máy chủ ngôn ngữ Aggrega không chạy.) thay cho danh sách của chúng, kèm chú giải công cụ của chính chỉ báo, và nhấn vào hàng đó sẽ khởi động máy chủ. Danh sách của bảng Plugins đến từ việc chạy trình biên dịch như một lệnh chứ không phải từ máy chủ ngôn ngữ, nên khi không thể khởi động lệnh đó, hàng của nó cho biết đường dẫn có vấn đề gì bằng lời của thông báo, và nhấn vào nó sẽ mở cài đặt.

Aggrega: Open status bar menu bị bỏ khỏi chỉ mục lệnh khi không có máy chủ ngôn ngữ nào đang trả lời: mọi thứ nó cung cấp đều là một hành động trên một máy chủ ngôn ngữ đang chạy, và trình soạn thảo của bạn không liệt kê một lệnh không thể chạy ở đó. Nó quay lại ngay khi có một máy chủ trả lời.

Một lệnh hoạt động được mà không cần máy chủ sẽ ở lại trong chỉ mục lệnh, dù nó liên quan đến máy chủ. Aggrega: Toggle the artifact-rendering stage while inspecting ghi một tùy chọn, và máy chủ đọc tùy chọn đó khi khởi động — vì vậy lúc máy chủ đã dừng là thời điểm hữu ích nhất để đặt nó, chứ không phải lý do để ẩn nó đi.

Vòng đời

Extension quản lý toàn bộ vòng đời của tiến trình máy chủ ngôn ngữ. Khi dừng máy chủ ngôn ngữ — khi trình soạn thảo đóng, khi máy chủ ngôn ngữ chuyển sang một không gian làm việc Aggrega khác, hoặc khi không còn một không gian làm việc duy nhất nào để nó gắn vào — extension trước tiên yêu cầu máy chủ ngôn ngữ thoát một cách hợp tác, cho phép công việc đang dở hoàn tất. Nếu máy chủ ngôn ngữ vẫn đang làm việc khi khoảng thời gian ân hạn đó kết thúc, nó được yêu cầu thêm một lần nữa — lần này là bỏ dở công việc đó thay vì hoàn tất. Nếu nó vẫn chưa thoát, extension chuyển sang chấm dứt ở cấp hệ điều hành. Một lần khởi động lại — lệnh khởi động lại, một thay đổi của aggrega.server.binaryPath, hoặc một thay đổi cấu hình do chính extension thực hiện — không yêu cầu: nó chấm dứt tiến trình ở cấp hệ điều hành và khởi động một tiến trình mới. Mỗi bước này đều được báo cáo tới kênh đầu ra Aggrega, nên một lần tắt chậm sẽ cho thấy bước nào đang tốn thời gian và máy chủ ngôn ngữ có trả lời hay không. Ngữ nghĩa giống hệt nhau trên máy chủ POSIX và Windows.

Một máy chủ ngôn ngữ dừng mà không được yêu cầu sẽ được khởi động lại, với số lần có giới hạn. Khi một máy chủ đang chạy kết thúc, extension khởi động một máy chủ mới; nếu máy chủ đó cũng kết thúc — khi đang khởi động, trước khi trả lời yêu cầu mở đầu của extension, hoặc khi đã chạy — nó lại được khởi động lại, tối đa aggrega.server.respawnAttempts lần khởi động lại trong vòng aggrega.server.respawnWindowSeconds giây. Lần kết thúc sau lần khởi động lại cuối cùng để máy chủ ở trạng thái dừng và hiển thị Aggrega language server has stopped responding. (Máy chủ ngôn ngữ Aggrega đã ngừng phản hồi.), nêu tên lệnh khởi động lại nó, và sau đó không có gì tự khởi động lại nó nữa — nên một máy chủ chết mỗi lần khởi động sẽ được khởi động lại đúng chừng ấy lần và không hơn. Kênh đầu ra Aggrega mô tả từng bước bằng lời: rằng máy chủ đã dừng bất ngờ và nó kết thúc như thế nào, mỗi lần khởi động lại và thiết lập cho phép bao nhiêu lần, một lần khởi động lại không lên được và lý do, và rằng nó sẽ không được khởi động lại nữa. Một lần dừng hoặc khởi động lại mà bạn yêu cầu — lệnh khởi động lại, một thay đổi của aggrega.server.binaryPath, hoặc một thay đổi cấu hình do chính extension thực hiện — không được tính, và một lần khởi động lại sẽ bắt đầu đếm lại từ đầu. Lần khởi động đầu tiên, và một lần khởi động lại mà bạn yêu cầu, không được lặp lại khi thất bại: mỗi lần kết thúc bằng thông báo rằng máy chủ ngôn ngữ không khởi động được, kèm lý do.

Mỗi máy chủ ngôn ngữ bắt đầu bảng điều khiển Problems từ những gì chính nó báo cáo. Khi một máy chủ khởi động — máy chủ đầu tiên, một lần khởi động lại dù được yêu cầu theo cách nào, một máy chủ được khởi động lại sau khi máy chủ trước dừng bất ngờ, một máy chủ được chuyển sang không gian làm việc Aggrega khác, và một máy chủ được khởi động ở nơi chưa có máy chủ nào chạy — bảng điều khiển Problems được xóa sạch mọi thứ máy chủ trước đã báo cáo, và mọi tệp YAML đang mở được kiểm tra với máy chủ mới ngay khi nó trả lời. Một máy chủ không thể rút lại những gì nó đã báo cáo, và máy chủ khởi động sau nó không biết đó là gì, nên một phát hiện còn sót lại sẽ là phát hiện mà không máy chủ đang chạy nào đứng sau — sau một lần chuyển, đó là phát hiện về không gian làm việc bạn đã rời đi. Các phát hiện biến mất rồi xuất hiện lại trong khi các tệp đang mở được kiểm tra. Một phát hiện mà chỉ một yêu cầu khác tính toán sẽ không xuất hiện cho đến khi yêu cầu đó chạy lại: các phát hiện của bản build quay lại khi đồ thị được vẽ hoặc một bản build hay bản build xem trước chạy, cảnh báo sai lệch của một lockfile quay lại khi đồ thị được vẽ — cả hai cùng lúc khi một bảng điều khiển đồ thị đang mở trên Release đó, vì nó được vẽ lại khi máy chủ quay lại — và các phát hiện về quy ước xuất bản quay lại khi bạn chạy Lint. Một máy chủ dừng và không được thay thế — đã dùng hết số lần khởi động lại, hoặc không còn không gian làm việc Aggrega nào để gắn vào — để nguyên bảng điều khiển Problems như cũ.

Máy chủ ngôn ngữ đọc cấu hình khi khởi động, và giữ nguyên nó cho đến khi dừng. Dòng lệnh đọc lại cấu hình ở mỗi lần chạy, nên một chỉnh sửa đối với .aggrega-config.yaml hoặc ~/.config/aggrega/config.yaml thay đổi ngay hành vi của terminal nhưng không thay đổi gì trong một máy chủ ngôn ngữ đang chạy. Vì vậy extension theo dõi các tệp cấu hình mà máy chủ đang chạy báo cáo là đã đọc — các đường dẫn tệp mà Show config liệt kê trong số các tệp đã đóng góp — và khi một trong số đó thay đổi trên đĩa, bị xóa hoặc xuất hiện lại, và do đó không còn khớp với những gì máy chủ đã đọc, nó hiển thị một cảnh báo nêu tên tệp và cho biết máy chủ ngôn ngữ đọc cấu hình khi khởi động, kèm nút Restart server chạy Aggrega: Start or restart the language server. Nhiều lần ghi từ một lần lưu chỉ tạo ra một cảnh báo. Cảnh báo không được hiển thị lại cho tệp đó khi nó còn trên màn hình, cũng như sau khi bạn đóng nó cho đến khi tệp thay đổi lần nữa, và một lần khởi động lại sẽ bắt đầu theo dõi lại từ những gì máy chủ đã khởi động lại đọc được. Một tệp cấu hình chưa tồn tại khi máy chủ khởi động thì chưa được đọc, nên nó không được theo dõi và việc tạo tệp đó không hiển thị gì; lần khởi động tiếp theo sẽ đọc nó. Những tệp nào đang được theo dõi được ghi vào kênh đầu ra Aggrega mỗi khi một máy chủ khởi động.

Một thay đổi cấu hình do chính extension thực hiện được áp dụng bằng cách khởi động lại máy chủ ngôn ngữ, không hỏi. Thêm hoặc xóa một registry, khởi tạo một registry từ trang chào mừng, thêm hoặc xóa một plugin, tạo cấu hình không gian làm việc từ trang chào mừng, và Aggrega: Set authoring_release in .aggrega-config.yaml… khi nó phải tạo tệp, mỗi thao tác đều được theo sau bởi một lần khởi động lại, được hiển thị trong khi chạy dưới dạng một thông báo nêu tên tệp mà máy chủ sắp đọc, và không thao tác nào hiển thị cảnh báo: chính bạn đã yêu cầu thay đổi đó. Khi việc tạo cấu hình không gian làm việc tự khởi động máy chủ ngôn ngữ — chưa có máy chủ nào chạy, hoặc nó đang chạy cho một thư mục khác — lần khởi động đó đọc tệp mới, và không có lần khởi động lại thứ hai nào theo sau. Khi một máy chủ ngôn ngữ khởi động sau thay đổi đã đọc nó, thông điệp kết thúc của chính thao tác sẽ thêm một câu cho biết thay đổi đã có hiệu lực, thay vì một thông báo thứ hai; khi lần khởi động lại thất bại, hoặc không có máy chủ ngôn ngữ nào đang chạy để đọc thay đổi, câu đó bị lược bỏ, vì khi đó thay đổi đã nằm trong tệp nhưng chưa có hiệu lực. Việc đặt authoring_release kết thúc bằng việc mở tệp thay vì bằng một câu, nên nó không thêm gì.