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.

Trang chào mừng

Trang chào mừng — trang riêng của Aggrega trong thẻ trình soạn thảo riêng, cho biết Aggrega là gì rồi liệt kê những gì tiện ích mở rộng cần trong không gian làm việc này, đánh dấu mỗi điều kiện là Met hoặc To do. Mỗi bước đưa ra một cách để tạo thứ cần thiết và một cách để trỏ tới thứ bạn đã có, giải thích điều kiện, và một bước đã được đáp ứng không hỏi bạn gì cả. Một bước được đánh dấu Met sẽ quay lại To do nếu điều kiện của nó mất đi. Một bước đã được đáp ứng mở ra ở trạng thái thu gọn, nên trang mở ra ở phần công việc còn lại. Mỗi bước cũng hiển thị giá trị hiện tại của nó — gốc không gian làm việc, trình biên dịch, Release, các registry — lớn hơn và đậm hơn phần hướng dẫn, được giới thiệu bằng Selected:, nằm dưới tiêu đề khi bước được thu gọn và ngay phía trên các nút khi bước đang mở, và nói rõ bằng lời khi bạn chưa chọn — None selected. khi có thứ để chọn, None available. khi hoàn toàn không có gì để chọn. Cuối trang có hộp kiểm quyết định trang có mở khi khởi động hay không, cùng công tắc mà màn hình cài đặt nắm giữ, bên dưới là phiên bản của tiện ích mở rộng và trình biên dịch bạn đang chạy, và cuối cùng là máy chủ ngôn ngữ có đang chạy hay không và phiên bản mà nó báo cáo. Một biểu tượng ngôi nhà trên thanh tiêu đề của bảng Commands mở lại trang bất cứ lúc nào. Nó không chiếm chỗ trong khung nhìn Aggrega.

Welcome to Aggrega! mở trong một thẻ trình soạn thảo riêng. Trang này cho biết Aggrega là gì, sau đó liệt kê những gì tiện ích mở rộng cần trong không gian làm việc bạn đang mở:

  1. Một không gian làm việc mà Aggrega nhận diện — cơ chế phát hiện được mô tả trong Điều kiện tiên quyết.
  2. Một trình biên dịch mà trình soạn thảo này có thể chạy — tệp nhị phân aggrega được chỉ định trong aggrega.server.binaryPath.
  3. Một Release để thao tác — xây dựng, xem trước và đồ thị cấu trúc liên kết đều thao tác trên một Release.
  4. Một registry để phân giải — việc kéo các phụ thuộc và tìm kiếm danh mục đã công bố được phân giải theo các registry mà cấu hình của bạn chỉ định.

Mỗi bước giải thích điều kiện dùng để làm gì và trình soạn thảo đạt được nó như thế nào, nên trang này là nơi để đọc về sản phẩm chứ không chỉ là một danh sách kiểm tra.

Thẻ Welcome to Aggrega! trong một thư mục mà Aggrega chưa nhận diện, với bước đầu tiên, Một không gian làm việc mà Aggrega nhận diện, được đánh dấu là cần làm và đang mở phần giải thích.

Mỗi bước đưa ra nhiều hơn một cách để hoàn thành, và một trong số đó luôn là “Tôi đã có cái này rồi.” Bạn có thể tạo cấu hình không gian làm việc hoặc trỏ trình soạn thảo tới một thư mục đã có cấu hình; dùng trình biên dịch trên PATH của bạn, chọn một bản dựng bạn có ở nơi khác, hoặc tải xuống một bản; soạn thảo một Release hoặc chọn một Release của bạn; khởi tạo hub chính thức, chỉ định registry của riêng bạn, hoặc thêm một registry vào cấu hình bạn đã có. Không có gì ở đây là ngõ cụt chỉ đưa cho bạn một hộp thoại tệp rồi để bước đó vẫn chưa xong.

Một bước bạn đã đáp ứng được đánh dấu và không hỏi bạn gì cả. Trang đọc trạng thái thực tế thay vì đặt cùng những câu hỏi cho mọi người, nên nếu bạn đã xây dựng cấu hình từ dòng lệnh rồi mới mở trình soạn thảo, mọi bước đều hiển thị đã được đánh dấu.

Mọi bước đều có thể thu gọn, và trang mở ra hiển thị những gì vẫn còn cần. Một dấu mũ ở góc trên bên phải của mỗi bước dùng để mở và đóng bước đó. Bước có điều kiện đã được đáp ứng mở ra ở trạng thái thu gọn, còn bước chưa được đáp ứng mở ra với phần giải thích ngay trước mắt bạn — vì vậy những gì bạn đọc là về công việc bạn vẫn còn phải làm chứ không phải công việc bạn đã làm. Một bước đã thu gọn vẫn giữ tiêu đề và mọi nút của nó, chỉ ẩn phần giải thích: khi bạn đã biết một bước dùng để làm gì, bạn vẫn có thể thao tác với nó mà không cần đọc lại.

Cách sắp xếp được quyết định khi trang được tạo và sau đó thuộc về bạn. Một bước trở nên được đáp ứng trong lúc bạn đang đọc sẽ cập nhật dấu của nó và vẫn mở — nó không thu gọn lại dưới con trỏ của bạn — và một dấu mũ bạn nhấn sẽ giữ nguyên ở trạng thái bạn đặt, dù trang làm mới xung quanh nó bao nhiêu lần. Đóng và mở lại trang sẽ đọc lại các điều kiện và sắp xếp lại từ đầu. Trang được vẽ thay cho trang bạn đang mở khi trình soạn thảo khởi động lại các tiện ích mở rộng cũng vậy — như khi một thư mục được thêm vào cửa sổ đang mở trên một thư mục: trang bạn có bị đóng và một trang mới được vẽ trong cùng nhóm thẻ, bất kể trang có được đặt để mở khi khởi động hay không, nên cửa sổ vẫn giữ một trang và trang đó theo không gian làm việc bạn đang ở.

Mỗi bước cũng hiển thị giá trị hiện tại của nó, nên trang trả lời cái nào chứ không chỉ có hay không: gốc không gian làm việc, trình biên dịch, Release và các registry mà cấu hình khai báo. Giá trị được hiển thị lớn hơn và đậm hơn phần giải thích xung quanh, vì một giá trị được vẽ cùng độ đậm với một khối văn bản là thứ bạn phải đi tìm. Một bước đã thu gọn hiển thị nó dưới tiêu đề, nên bạn có thể xác nhận lựa chọn của mình mà không cần mở rộng gì; một bước đang mở hiển thị nó ở cuối phần giải thích, ngay phía trên các nút, nơi nó là thứ cuối cùng được đọc trước khi bạn thao tác. Một giá trị đã chọn được giới thiệu bằng Selected:, hiển thị nhỏ hơn và nhạt hơn chính giá trị để nhãn chỉ vào giá trị thay vì cạnh tranh với nó.

Trang chào mừng trong một không gian làm việc đã cấu hình, với các bước trình biên dịch, Release và registry được đánh dấu là đã đáp ứng và thu gọn, mỗi bước hiển thị giá trị đã chọn phía trên các nút của nó, và ở cuối trang là hộp kiểm khởi động, các phiên bản và trạng thái của máy chủ ngôn ngữ.

Khi bạn chưa chọn, bước đó nói rõ bằng lời thay vì để một dòng trống, vốn sẽ trông như trang không vẽ được — và nó phân biệt hai trạng thái mà người đọc xử lý khác nhau. None selected. nghĩa là có thứ để chọn nhưng bạn chưa chọn cái nào. None available. nghĩa là ở đây hoàn toàn không có gì để chọn, nên nhấn “I already have one” của bước đó chỉ có thể cho bạn thấy một danh sách trống, và điều bạn cần là cách hoàn thành còn lại của nó. Chỉ hai bước đưa ra danh sách mới có thể hiển thị None available. — không gian làm việc và Release. Trình biên dịch được chỉ định trực tiếp và registry được đăng ký trực tiếp, nên không bước nào trong hai bước đó có danh sách có thể trống. Bước registry giữ một cách hiển thị thứ ba, Not read yet., cho trường hợp không thể hỏi trình biên dịch: nói với bạn rằng bạn chưa cấu hình gì khi không có gì có thể trả lời sẽ là nói nhiều hơn những gì trang biết.

Dấu của một bước theo điều kiện của nó theo cả hai chiều. Mỗi bước thể hiện trạng thái của mình bằng lời bên cạnh dấu — Met hoặc To do — vì bản thân dấu là một ký tự đồ họa, và chỉ riêng ký tự đồ họa thì để lại ý nghĩa cho người đọc đoán. Một bước hiển thị Met khi điều kiện của nó trở thành đúng và lại hiển thị To do nếu điều kiện sau đó mất đi — một trình biên dịch ngừng phản hồi, một Release bị bỏ chọn. Trang đọc trạng thái thực tế mỗi lần làm mới thay vì ghi nhớ những gì từng đúng, nên nó không bao giờ báo cáo thứ mà bạn đã mất từ đó. Khi việc mất đi có ý nghĩa, nó cũng được báo cáo ở nơi bạn đang nhìn: thanh trạng thái hiển thị trình biên dịch đã ngừng phản hồi, và các hàng Project folder, Aggrega workspace và Release ở đầu bảng Commands nêu lựa chọn hiện tại.

Việc nó là một thẻ trình soạn thảo thông thường chứ không phải hộp thoại là có chủ ý: mỗi bước yêu cầu bạn trỏ tới một thứ trong không gian làm việc của chính bạn, và một hộp thoại sẽ che mất các tệp chứa câu trả lời. Nó nằm trong vùng trình soạn thảo chứ không phải trong khung nhìn Aggrega, nên không chiếm chỗ của thanh bên và có thể nói sản phẩm là gì — điều mà một cột hẹp không có chỗ. Đây là thẻ riêng của Aggrega, được mở và đóng theo cách riêng của nó, và nó không cung cấp đường dẫn vào trang chào mừng của chính trình soạn thảo.

Trang đặt quyết định đó ở cuối trang, căn giữa, và Command Palette cũng có nó. Cả hai đều thay đổi một cài đặt duy nhất, aggrega.getStarted.show, được ghi vào cài đặt của riêng bạn — không bao giờ vào kho mã, nên lựa chọn của bạn không đi theo đến bất kỳ ai khác mở kho đó. Điều khiển ở cuối trang là một hộp kiểm có nhãn Show Aggrega welcome page on startup, được đánh dấu khi trang mở lúc khởi động — nên nó báo cáo cài đặt như hiện trạng thay vì đưa cho bạn hành động sẽ thay đổi nó. Tắt nó trong màn hình cài đặt thì hộp kiểm thay đổi theo; nhấn hộp kiểm thì màn hình cài đặt thay đổi theo. Đó là một công tắc ở hai nơi chứ không phải hai công tắc. Hộp kiểm giữ tiêu điểm bàn phím khi được nhấn, nên phím Space lần lượt đánh dấu và bỏ đánh dấu nó.

Tắt nó chỉ khiến trang không mở khi khởi động chứ không làm trang không thể truy cập, và đây không phải là cánh cửa một chiều: Aggrega: Get started trong Command Palette bật lại cài đặt và mở trang, còn Aggrega: Stop opening the welcome page on startup là cách riêng của bảng lệnh để đến cùng cài đặt đó.

Bảng Commands có một đường quay lại trang, bên cạnh biểu tượng bánh răng. Đó là biểu tượng ngôi nhà ở góc trên bên phải, và chú giải công cụ của nó là Open the welcome page — nên việc quay lại trang là thứ bạn tìm thấy bằng cách nhìn vào khung nhìn Aggrega chứ không phải thứ bạn phải biết để gõ. Nó mở trang và để cài đặt khởi động của bạn nguyên như bạn đã đặt: xem lại trang không bật lại cài đặt. Lệnh trong bảng lệnh mới làm điều đó, vì bật lại là một quyết định chứ không phải một cái liếc nhìn.

Trang báo cáo những gì bạn đang chạy, ở cuối trang. Có hai chỉ số phiên bản ở đó: Extension, bản dựng nào của tiện ích mở rộng này mà trình soạn thảo đã tải, và Compiler, những gì tệp nhị phân aggrega mà máy chủ ngôn ngữ đang chạy nói về chính nó. Chỉ số Extension được ghi lại khi tiện ích mở rộng được xây dựng, từ trạng thái mã nguồn của nó tại thời điểm đó, theo cùng dạng mà bản dựng của chính trình biên dịch dùng cho phiên bản của nó — nên một cửa sổ phát triển, một bản sao đã cài đặt và một bản sao được đóng gói từ cây mã đã chỉnh sửa đều cho biết mình là loại nào:

  • chỉ riêng một thẻ phát hành, chẳng hạn 0.2.0, nghĩa là bản dựng chính xác là bản phát hành đó;
  • một thẻ theo sau là một số đếm và một commit, chẳng hạn 0.2.0-3-g1a2b3c4, nghĩa là bản dựng từ commit 1a2b3c4, ba commit sau bản phát hành đó — còn chỉ riêng một commit, chẳng hạn 1a2b3c4, nghĩa là bản dựng từ commit đó khi không có bản phát hành nào đứng trước nó;
  • hậu tố -dirty trên bất kỳ dạng nào trong số này nghĩa là bản dựng được tạo từ một bản sao mã nguồn có những thay đổi chưa được commit;
  • dev nghĩa là bản dựng được tạo ở nơi không thể đọc lịch sử của mã nguồn.

Không chỉ số nào được ghi sẵn vào trang — cả hai đều được đọc khi trang được vẽ, nên một bản dựng phát triển tự báo cáo là bản dựng phát triển thay vì không hiển thị gì, và khởi động lại với một trình biên dịch khác sẽ thay đổi chỉ số. Khi không thể lấy được một chỉ số — tiện ích mở rộng được xây dựng mà không ghi lại nó là bản dựng nào, không có gì đang chạy để hỏi, hoặc thứ đang chạy không trả lời — nhãn vẫn còn và cho biết phiên bản không được báo cáo, nên một chỉ số vắng mặt không bao giờ bị nhầm với một chỉ số mà bạn không để ý.

Dòng cuối cùng của trang cho biết máy chủ ngôn ngữ có đang chạy hay không, và đó là bản dựng nào. Nó hiển thị Language server running, starting, not running hoặc failed to start, bằng chính những từ mà thanh trạng thái và các thông báo sử dụng; failed to start nghĩa là lần thử khởi động gần nhất đã thất bại và không có máy chủ nào chạy kể từ đó. Kênh đầu ra Aggrega cho biết lý do, và thông báo xuất hiện khi lần khởi động đầu tiên hoặc lần khởi động lại thất bại cũng vậy. Trong khi máy chủ chạy, dòng này thêm phiên bản mà máy chủ đang chạy đã báo cáo về chính nó khi tiện ích mở rộng kết nối với nó, được viết theo cách mà chỉ số Compiler viết một phiên bản. Chỉ số Compiler ở phía trên là một thực tế khác: đó là những gì tệp nhị phân dùng để khởi động máy chủ nói khi được hỏi, và hai giá trị này khác nhau khi tệp tại đường dẫn đó bị thay thế trong khi máy chủ được khởi động từ nó vẫn tiếp tục chạy, nên trang hiển thị cả hai. Một máy chủ ngôn ngữ không báo cáo phiên bản của chính nó sẽ hiển thị version not reported ở đó, thay vì mượn phiên bản của tệp nhị phân. Dòng này và hai chỉ số phía trên theo dõi máy chủ khi nó khởi động, dừng, khởi động lại hoặc thất bại, mà không cần mở lại trang; các bước giữ nguyên dấu của chúng qua một lần khởi động lại.