확장 설정
전제 조건
- 데스크톱용 Visual Studio Code 1.85 이상. 이 확장은
aggrega프로그램을 시작하는 방식으로 동작하며 대신 브라우저에서 실행할 수 있는 버전을 제공하지 않으므로, vscode.dev나 github.dev처럼 완전히 웹 브라우저 안에서 실행되는 편집기에서는 실행되지 않습니다. - 작업 영역이 있는 컴퓨터의
aggrega컴파일러. 확장은aggrega.server.binaryPath설정이 지정하는 컴파일러를 실행합니다.~/(Windows에서는~\) 또는${userHome}으로 시작하는 경로는 해당 컴퓨터의 홈 폴더를 기준으로 읽히고, 그 밖의 경로는 적힌 그대로 사용되며, 단순한 이름(기본값은aggrega)은PATH에서 찾습니다. 찾지 못하면 확장이 다운로드를 제안하며, 나중에 Aggrega: Select Compiler Version으로 버전을 바꿀 수 있습니다. 컴파일러 얻기를 참조하십시오. - 연 폴더 또는 그 상위에 있는, Aggrega가 작업 영역 루트로 인식하는 폴더. Aggrega는 프로젝트 루트에 있는 파일 하나(
workspace:블록을 담은.aggrega-config.yaml)를 읽으며, 연 폴더에서 상위로 올라가며 그 파일을 찾습니다.workspace:블록으로 루트를 표시하는 것이 명시적인 방법이며 권장되는 방법입니다. 블록을 한 번도 선언하지 않은 프로젝트도 다른 표식으로 인식될 수 있으며, 이 표식들은 더 큰 프로젝트에서 구성으로 할 수 있는 다른 모든 일과 함께 Aggrega 자체 구성 참조에서 다룹니다.
이 중 어느 것도 직접 준비할 필요는 없습니다. 시작 페이지를 참조하십시오.
확장 설치
확장의 식별자는 aggrega-ai.aggrega이며, 두 곳에 등록되어 있습니다.
- Visual Studio Marketplace: Visual Studio Code가 설치에 사용하는 곳입니다.
- Open VSX: Open VSX에서 확장을 설치하는 편집기용입니다.
편집기에서 확장 보기를 열고 Aggrega를 검색한 다음, 식별자가 aggrega-ai.aggrega인 항목을 설치합니다.
터미널에서는 식별자를 Visual Studio Code의 명령줄 프로그램에 전달합니다.
code --install-extension aggrega-ai.aggrega확장은 자체 텍스트(명령, 설정, 보기, 메시지)를 Visual Studio Code가 실행되는 표시 언어로 번역되어 있으면 그 언어로, 그렇지 않으면 영어로 표시합니다. Configure Display Language로 변경한 표시 언어는 편집기를 다시 시작하면 적용됩니다. 컴파일러가 보고하는 내용은 진단과 가져오기의 질문을 포함해 터미널에서와 마찬가지로 컴파일러가 표현한 그대로 전달됩니다.
컴파일러 얻기
확장은 aggrega.server.binaryPath가 지정하는 컴파일러를 실행하며, 컴파일러를 얻도록 제안하기 전에 먼저 컴파일러를 찾습니다. 설정의 경로 중 ~/(Windows에서는 ~\) 또는 ${userHome}으로 시작하는 경로는 작업 영역이 있는 컴퓨터의 홈 폴더를 기준으로 읽히므로, Linux와 macOS에서 ~/.local/bin/aggrega는 설치 스크립트가 그곳에 두는 파일을 가리킵니다. 그 밖의 경로는 적힌 그대로 사용됩니다. 단순한 이름(기본값은 aggrega)은 PATH에서 찾으며, Aggrega 출력 채널에 찾은 파일과 그 파일이 보고하는 버전이 표시됩니다.

찾지 못하면 다운로드를 제안합니다. 제안은 시작 페이지의 컴파일러 단계(Download the compiler가 Use the compiler on my PATH, Point at a compiler I have와 나란히 있습니다)와, 경로에 아무것도 없어 언어 서버를 시작할 수 없었다는 알림에서 나옵니다. 다운로드는 다음과 같이 진행됩니다.
- 이 확장이 지원하는 최신 게시 릴리스를 제시합니다. 이 릴리스는 작업 영역이 있는 컴퓨터의 운영 체제와 프로세서용으로 빌드된 것이며, 원격 컴퓨터, 컨테이너 또는 WSL에서 연 창에서는 그 컴퓨터가 대상입니다. Releases에는 64비트 x86 및 64비트 ARM의 Linux와 macOS, 64비트 x86의 Windows용 바이너리가 포함됩니다. 그 밖의 컴퓨터에서는 다운로드가 거부되며 해당 컴퓨터가 표시됩니다.
- Aggrega 설치 스크립트가 사용하는 폴더를 제안합니다. Linux와 macOS에서는
~/.local/bin, Windows에서는%LOCALAPPDATA%\Programs\aggrega이며, 컴파일러는 그 안에aggrega(Windows에서는aggrega.exe)로 저장됩니다. 폴더는 변경할 수 있으며, 버전은 질문의 제목에 표시됩니다. - 무엇이든 다운로드하기 전에 버전과 파일을 확인하도록 요청하고, 그런 다음 중지할 수 있는 진행 상황을 표시합니다.
- 파일을 릴리스의
SHA256SUMS와 대조하고, 일치하지 않는 다운로드는 삭제하고 그 사실을 표시하며, 파일을 실행 가능하게 만들고,aggrega version -o json으로 한 번 실행합니다. 세 가지를 모두 통과한 파일만 제자리에 놓이며, 그때에야 사용자 설정에서aggrega.server.binaryPath가 그 파일로 설정됩니다.
다운로드는 편집기가 확장에 사용하는 프록시를 거치며, 이 프록시는 편집기의 http.proxy 및 http.proxyStrictSSL 설정으로 구성됩니다. 릴리스 목록이나 파일을 읽을 수 없으면(오프라인이거나, GitHub가 주소에서 오는 요청을 제한하거나, 요청이 거부된 경우) 아무것도 다운로드되지 않고 설정은 그대로 유지되며, 이유가 한 문장으로 표시됩니다.
교체할 권한이 있는 컴파일러만 교체합니다. 그 공유 폴더에 있는 컴파일러나 확장이 직접 다운로드한 컴파일러이며, 후자는 설정이 아니라 해당 컴퓨터의 확장 자체 저장소에 기록됩니다. 다른 곳에 둔 컴파일러를 덮어써서 다운로드하라는 요청을 받으면, 그런 컴파일러는 절대 교체하지 않는다고 알리고 대신 공유 폴더를 제안합니다.
스스로 업그레이드하는 일은 없습니다. 교체할 수 있는 컴파일러의 경우, 창이 열릴 때 릴리스 목록을 읽고 더 새로운 릴리스를 사용할 수 있다는 사실을 버전마다 한 번씩 알립니다. 직접 지정한 컴파일러에 대해서는 아무것도 묻지 않습니다.
Aggrega: Select Compiler Version은 실행하는 버전을 변경하고, 다시 변경할 때까지 그 버전을 유지합니다. 이 확장이 지원하는 릴리스를 최신순으로 나열하고 사용 중인 것을 표시합니다. 무엇이든 다운로드하기 전에, 이 컴파일러는 이 컴퓨터의 모든 작업 영역이 사용하는 것이므로 버전이 모든 작업 영역에서 바뀐다는 점과, 다른 버전이 잠금 파일을 쓴 Release는 Pull을 다시 실행해야 할 수 있다는 점을 경고합니다. Download and switch로 확인합니다. 새 버전은 현재 버전 옆에 다운로드되고 다른 다운로드와 마찬가지로 검사되며, 그 위에서 언어 서버가 시작된 다음에야 이전 버전을 교체합니다. 언어 서버가 시작되지 않으면 새 버전은 삭제되고, 이전 버전이 남으며, 언어 서버는 다시 이전 버전으로 시작됩니다. Aggrega 작업 영역이 열려 있지 않은 창에서는 시작할 언어 서버가 없으므로 버전 검사가 그 역할을 대신하며, 메시지에도 그렇게 표시됩니다. 다운로드가 교체할 수 있는 곳에서만 컴파일러를 교체하며, 직접 어딘가에 둔 컴파일러에 대해서는 그렇게 알리고 대신 공유 폴더를 제안합니다.