작업할 Release 선택
선택된 Release: 상태 표시줄 표시기와 Commands 패널 상단의 Release 행으로, 둘 다 편집기가 작업 중인 하나의 Release를 나타냅니다. Release를 대상으로 하는 모든 작업(검증, 토폴로지 그래프, 빌드, 미리 보기 빌드, 풀)은 그 Release를 대상으로 합니다. 이미 열려 있는 그래프 패널은 다른 Release를 선택해도 그려질 때의 Release를 유지하며, 그래프를 다시 표시하면 새로 선택한 Release가 그려집니다. 그래프, 빌드, 미리 보기 빌드, 풀은 그 Release가 빌드에 사용하는 카탈로그 디렉터리를 읽습니다. 작업 영역 구성이 workspace.releases 아래에서 그 Release용 디렉터리를 지정하면 그것을, 그렇지 않으면 작업 영역의 디렉터리를 사용합니다. 이는 터미널에서 aggrega build --release가 읽는 것과 같으므로, 하나의 창에서 플래그를 전달하지 않고도 작업 영역의 각 Release를 각자의 카탈로그에 대해 빌드할 수 있습니다. Catalog 패널, 검사, Catalog 행의 확인, 호버, 완성, Go to Definition, Find References, Find Implementations도 선택된 Release의 관점에서 답합니다. 작업 영역 구성이 Release마다 카탈로그 디렉터리를 지정하는 경우, 각 기능은 다른 Release만 읽는 디렉터리에 있는 것을 제외한 작업 영역의 문서와, 선택된 Release가 빌드에 사용하는 카탈로그 디렉터리를 읽습니다. 따라서 여러 변형이 Release마다 하나씩 선언하는 이름은 선택된 Release의 것으로 해석됩니다. Release를 선택하지 않으면 작업 영역 자체의 관점에서 답합니다. Release 선택을 참조하십시오.
Release 선택
확장이 하는 일의 대부분은 Release를 범위로 합니다. 어떤 카탈로그 디렉터리를 읽는지, 어떤 컴포넌트가 해석되는지, 어떤 lockfile 고정이 적용되는지, 문서가 어떤 결과를 받는지가 그렇습니다. 따라서 확장은 한 번에 하나의 선택된 Release를 대상으로 작동하며, 상태 표시줄의 로켓 아이콘 옆에 어떤 Release인지 표시합니다.
선택한 Release는 그 편집기 창이 기억합니다. 언어 서버가 연결되면 기억된 선택을 워크스페이스가 여전히 제공하는 것과 대조하여 아직 있으면 복원하고, 없어졌으면 편집기가 이를 알리고 워크스페이스가 암시하는 것으로 돌아갑니다. 이 창에서 아무것도 선택하지 않았을 때도 선택은 여기서 시작합니다. 그 답은 우선순위 순서대로 다음에서 나옵니다:
.aggrega-config.yaml의build.authoring_release, 팀 전체가 공유하는 커밋된 설정입니다..aggrega/active-release, 커밋되지 않는 로컬 마커 파일입니다.- 워크스페이스에 Release가 정확히 하나만 있을 때의 그 Release입니다.
두 표시기 중 하나를 클릭하여 다른 Release를 선택합니다(또는 명령 팔레트에서 Aggrega: Select Release… 명령을 실행합니다). 변경은 즉시 적용됩니다 — 아무것도 다시 시작되지 않고, 열려 있는 모든 YAML 파일이 방금 선택한 Release를 기준으로 다시 검사되며, Catalog 패널은 그 Release에 대해 목록을 다시 읽습니다. 언어 서버가 연결될 때 Release가 채택되는 경우에도 마찬가지입니다. 기억은 편집기 창에 국한됩니다. 선택은 워크스페이스에 아무것도 쓰지 않습니다. 선택기가 열릴 때 포커스가 Commands 패널 — 그 Release 행이나 그 컨트롤 중 하나 — 에 있었다면, Release를 선택했든 닫았든 선택기가 닫힐 때 포커스는 그 컨트롤로 돌아갑니다. 다른 곳에서 열었다면 선택기는 패널에 포커스를 두지 않고 닫힙니다.

제공되는 Releases는 언어 서버가 기준으로 삼은 폴더 안에 있는 것들이며, 그 폴더 기준의 상대 이름으로 표시됩니다. 서버가 받아들이는 형식이 그것이기 때문입니다. Release를 제공할 수 없는 경우 편집기는 조용히 빼 버리는 대신 그 수와 위치를 알려 줍니다. 언어 서버는 그 폴더 밖으로 이어지는 링크를 통해서는 어떤 Release도 읽지 않으므로, 밖으로 이어지는 링크 — 외부 디렉터리에 대한 링크나 외부 Release 파일에 대한 링크 — 를 통해 편집기의 파일 트리에 표시되는 Release는 제공되지 않습니다. 유일한 예외는 워크스페이스 구성이 build.authoring_release로 또는 workspace.releases의 키로 지정하는 Release 파일에 대한 링크입니다. 그 Release는 링크를 통해 읽히고 제공됩니다. 선택기를 열면 별도의 알림이 이를 알리며, 언어 서버가 원래 읽었을 위치에 있는 그러한 각 링크를 그 폴더 기준 상대 경로로 표시합니다. 디렉터리에 대한 링크가 먼저, 파일에 대한 링크가 그다음입니다. 이름이 .yaml 또는 .yml로 끝나는 링크는 그것이 가리키는 파일에 무엇이 들어 있든 표시됩니다. 그것을 알아내기 위해 그 파일을 읽지 않기 때문입니다.
선택을 워크스페이스 자체에 기록하고 싶을 때 — 새 체크아웃이 그 선택으로 시작하도록 — 이를 수행하는 명령이 두 개 있으며, 둘 다 지금 작업 중인 내용은 바꾸지 않습니다:
- Aggrega: Set the selected Release as this workspace’s default는 언어 서버가 현재 선택된 Release를
.aggrega/active-release에 쓰도록 합니다. 이 파일은 체크아웃에 로컬이므로 개인 기본값을 두기에 알맞은 곳입니다..aggrega나 마커가 Aggrega 워크스페이스 밖으로 이어지는 링크이면 아무것도 쓰지 않으며, 알림에 그 이유가 컴파일러 자신의 말로 담깁니다. - Aggrega: Set authoring_release in .aggrega-config.yaml… 명령은 구성 파일을 열어
build.authoring_release를 설정할 수 있게 합니다. 이 설정은 커밋되어 공유되며 마커 파일보다 우선합니다. 언어 서버가 구성 파일이 Aggrega 워크스페이스 밖으로 이어지는 링크라고 보고하면 파일은 열리지 않으며, 그것이 워크스페이스 밖으로 이어지므로 Aggrega가 그것을 사용하지 않는다는 오류가 표시됩니다. 환영 페이지에서 워크스페이스 구성을 만드는 컨트롤도 이미 있는 파일을 발견하면 똑같이 동작합니다.
워크스페이스가 어떤 Release도 제공하지 않으면 — 구성도 없고, 마커도 없고, 대신 사용할 파일이 정확히 하나 있는 것도 아니면 — 표시기가 이를 알리며, 두 가지 중 어느 쪽인지도 알려 줍니다. 선택할 Releases가 있는데 그중 어느 것도 선택하지 않은 경우에는 Release: none selected(Release: 선택되지 않음)로, Aggrega 워크스페이스가 Release를 전혀 제공하지 않은 경우에는 Release: none available(Release: 사용 가능한 항목 없음)로 표시됩니다. 후자는 선택으로 해결할 수 있는 상태가 아니므로, 그 툴팁은 빈 결과만 돌아올 수 있는 목록으로 안내하는 대신 거기서 벗어나는 방법 — 다른 Aggrega 워크스페이스에서 작업하거나 Release를 만드는 것 — 을 알려 줍니다. 아직 아무것도 워크스페이스를 읽지 않았다면 툴팁은 아무도 세지 않은 개수를 보고하는 대신 그 사실을 알립니다. 이러한 표시마다 무엇을 찾았는지가 담기며, 전체 설명은 Aggrega 출력 채널에 기록됩니다. 이 상태에서도 검증은 실행됩니다. 문서가 단독으로 답할 수 있는 결과 — 파싱되는지, 그리고 자체 형태가 허용되는지 — 는 얻을 수 있고, Release가 필요한 검사는 Release를 선택할 때까지 건너뜁니다.