Thiết lập tiện ích mở rộng
Điều kiện tiên quyết
- Visual Studio Code 1.85 trở lên, trên máy tính để bàn. Tiện ích mở rộng hoạt động bằng cách khởi động chương trình
aggregavà không cung cấp phiên bản nào mà trình duyệt có thể chạy thay thế, vì vậy nó không chạy trong các trình soạn thảo chạy hoàn toàn trong trình duyệt web, chẳng hạn vscode.dev và github.dev. - Trình biên dịch
aggrega, trên máy chứa không gian làm việc của bạn. Tiện ích mở rộng chạy trình biên dịch mà cài đặtaggrega.server.binaryPathchỉ định: một đường dẫn bắt đầu bằng~/(~\trên Windows) hoặc${userHome}được đọc từ thư mục home của bạn trên máy đó, mọi đường dẫn khác được dùng đúng như đã viết, còn một tên đơn thuần — mặc định làaggrega— được tìm trênPATH. Nếu không tìm thấy, tiện ích mở rộng đề nghị tải xuống một trình biên dịch cho bạn, và Aggrega: Select Compiler Version cho phép thay đổi phiên bản sau này; xem Lấy trình biên dịch. - Một thư mục mà Aggrega nhận diện là gốc không gian làm việc, tại hoặc phía trên thư mục bạn mở. Aggrega đọc một tệp tại gốc dự án của bạn —
.aggrega-config.yaml, chứa một khốiworkspace:— và đi ngược lên từ thư mục đã mở để tìm nó. Đánh dấu gốc bằng một khốiworkspace:là lựa chọn tường minh và là lựa chọn nên ưu tiên; một dự án chưa từng khai báo khối này vẫn có thể được nhận diện bằng các dấu hiệu khác, được trình bày trong tài liệu tham chiếu cấu hình của chính Aggrega cùng mọi thứ khác mà cấu hình có thể làm trong một dự án lớn hơn.
Bạn không cần tự tay sắp xếp bất kỳ điều nào trong số đó: xem Trang chào mừng.
Cài đặt tiện ích mở rộng
Định danh của tiện ích mở rộng là aggrega-ai.aggrega, và nó được niêm yết ở hai nơi:
- Visual Studio Marketplace, nơi Visual Studio Code cài đặt từ đó;
- Open VSX, cho các trình soạn thảo cài đặt tiện ích mở rộng từ Open VSX.
Trong trình soạn thảo, mở khung nhìn Extensions, tìm Aggrega và cài đặt mục có định danh là aggrega-ai.aggrega.
Từ một terminal, truyền định danh cho chương trình dòng lệnh của Visual Studio Code:
code --install-extension aggrega-ai.aggregaTiện ích mở rộng hiển thị văn bản của chính nó — các lệnh, cài đặt, chế độ xem và thông báo — bằng ngôn ngữ hiển thị mà Visual Studio Code đang chạy, nếu văn bản đã được dịch sang ngôn ngữ đó, và bằng tiếng Anh nếu không; ngôn ngữ hiển thị bạn thay đổi bằng Configure Display Language sẽ áp dụng cho nó sau khi trình soạn thảo khởi động lại. Những gì trình biên dịch báo cáo, bao gồm các chẩn đoán của nó và các câu hỏi của một lần nhập, đến với bạn đúng như trình biên dịch diễn đạt, như tại terminal.
Lấy trình biên dịch
Tiện ích mở rộng chạy trình biên dịch mà aggrega.server.binaryPath chỉ định, và tìm một trình biên dịch trước khi đề nghị lấy một trình biên dịch. Một đường dẫn trong cài đặt bắt đầu bằng ~/ — ~\ trên Windows — hoặc bằng ${userHome} được đọc từ thư mục home của bạn trên máy chứa không gian làm việc của bạn, vì vậy trên Linux và macOS, ~/.local/bin/aggrega chỉ tệp mà các script cài đặt đặt ở đó; mọi đường dẫn khác được dùng đúng như đã viết. Một tên đơn thuần — mặc định là aggrega — được tìm trên PATH của bạn, và kênh đầu ra Aggrega cho biết tệp nào đã được tìm thấy và phiên bản mà tệp đó báo cáo.

Nếu không tìm thấy, nó đề nghị tải xuống một trình biên dịch — từ bước trình biên dịch của trang chào mừng, nơi Download the compiler nằm cạnh Use the compiler on my PATH và Point at a compiler I have, và từ thông báo rằng máy chủ ngôn ngữ không thể khởi động vì không có gì tại đường dẫn. Quá trình tải xuống:
- đưa ra bản phát hành được công bố mới nhất mà tiện ích mở rộng này hỗ trợ, được xây dựng cho hệ điều hành và bộ xử lý của máy chứa không gian làm việc của bạn — trong một cửa sổ mở trên máy từ xa, container hoặc WSL, đó là máy đó. Releases chứa các tệp nhị phân cho Linux và macOS trên x86 64 bit và ARM 64 bit, và cho Windows trên x86 64 bit; trên bất kỳ máy nào khác, việc tải xuống bị từ chối và máy đó được nêu tên;
- đề xuất thư mục mà các tập lệnh cài đặt của Aggrega sử dụng —
~/.local/bintrên Linux và macOS,%LOCALAPPDATA%\Programs\aggregatrên Windows — nơi trình biên dịch được lưu dưới tênaggrega, hoặcaggrega.exetrên Windows, và cho phép bạn thay đổi thư mục đó; phiên bản nằm trong tiêu đề của câu hỏi; - yêu cầu bạn xác nhận phiên bản và tệp trước khi tải xuống bất cứ thứ gì, sau đó hiển thị tiến trình mà bạn có thể dừng;
- kiểm tra tệp với
SHA256SUMScủa bản phát hành, xóa bản tải xuống không khớp và nêu rõ điều đó, đặt tệp ở chế độ thực thi được, và chạy nó một lần vớiaggrega version -o json. Chỉ tệp vượt qua cả ba bước mới được đặt vào vị trí, và chỉ khi đóaggrega.server.binaryPathmới được đặt thành tệp đó, trong cài đặt của riêng bạn.
Việc tải xuống đi qua proxy mà trình soạn thảo của bạn dùng cho tiện ích mở rộng, như các cài đặt http.proxy và http.proxyStrictSSL của nó cấu hình. Nếu không thể đọc danh sách bản phát hành hoặc một tệp — bạn đang ngoại tuyến, GitHub đang giới hạn yêu cầu từ địa chỉ của bạn, hoặc yêu cầu bị từ chối — thì không có gì được tải xuống, cài đặt được giữ nguyên, và một câu cho biết lý do.
Nó chỉ thay thế trình biên dịch mà nó có quyền thay thế: trình biên dịch nằm trong thư mục dùng chung đó, hoặc trình biên dịch do chính nó tải xuống, điều mà nó ghi nhớ trên máy đó trong bộ lưu trữ riêng thay vì trong một cài đặt. Khi được yêu cầu tải xuống đè lên một trình biên dịch mà bạn đặt ở bất kỳ nơi nào khác, nó cho biết rằng nó không bao giờ thay thế trình biên dịch như vậy và đề nghị thư mục dùng chung thay vào đó.
Nó không bao giờ tự nâng cấp. Đối với trình biên dịch mà nó có thể thay thế, nó đọc danh sách bản phát hành khi một cửa sổ mở ra và thông báo, một lần cho mỗi phiên bản, rằng có bản phát hành mới hơn; nó không hỏi gì về trình biên dịch mà bạn tự chỉ định cho nó.
Aggrega: Select Compiler Version thay đổi phiên bản bạn chạy và giữ phiên bản đó cho đến khi bạn thay đổi lại. Lệnh này liệt kê các bản phát hành mà tiện ích mở rộng này hỗ trợ, mới nhất trước, và đánh dấu bản đang dùng. Trước khi tải xuống bất cứ thứ gì, nó cảnh báo rằng trình biên dịch này là trình biên dịch mà mọi không gian làm việc trên máy này sử dụng, nên phiên bản thay đổi cho tất cả chúng, và rằng một Release có tệp khóa do phiên bản khác ghi có thể cần chạy lại Pull; bạn xác nhận bằng Download and switch. Phiên bản mới được tải xuống bên cạnh phiên bản hiện tại và được kiểm tra như mọi lần tải xuống, máy chủ ngôn ngữ được khởi động trên nó, và chỉ khi đó nó mới thay thế phiên bản trước. Nếu nó không khởi động được máy chủ ngôn ngữ, nó bị xóa, phiên bản trước được giữ lại, và máy chủ ngôn ngữ được khởi động lại trên phiên bản trước. Trong một cửa sổ không mở không gian làm việc Aggrega nào thì không có máy chủ ngôn ngữ để khởi động, nên việc kiểm tra phiên bản thay thế cho bước đó và thông báo cũng nói rõ như vậy. Nó chỉ thay thế trình biên dịch ở nơi mà việc tải xuống được phép thay thế; với trình biên dịch mà bạn tự đặt ở đâu đó, nó cho biết như vậy và đề nghị thư mục dùng chung thay vào đó.