언어 서버
언어 서버 상태: 상태 표시줄 왼쪽, Release 표시기 옆에 있는 표시기로, running, starting 또는 빨간색 not running으로 표시됩니다. 컴파일러가 무엇을 하든 항상 있는 유일한 표시이므로, 조용해진 표시들로부터 추측하게 두는 대신 아무것도 실행 중이 아님을 여기서 알 수 있습니다. 도구 설명은 두 가지 이유 중 어느 것에 해당하는지 알려 줍니다. 여기에 Aggrega가 인식하는 폴더가 없거나, 폴더는 있지만 서버가 그 폴더에 연결되지 않은 경우입니다. 클릭하면 아무것도 실행 중이 아닐 때는 Start를, 실행 중일 때는 Restart를 제시하고 선택한 것을 실행합니다. 언어 서버가 실행 중이 아닐 때를 참조하십시오.
언어 서버가 실행되고 있지 않을 때
이 확장이 제공하는 모든 명령은 언어 서버가 실행 중인지 여부와 관계없이 확장이 시작되는 순간부터 존재하며, 그중 두 개만 명령 색인에 나열되기 전에 서버를 기다립니다. 아래에서 언급하는 명령과 Aggrega: Attach a Feature to the connection at the cursor로, 후자는 언어 서버가 Aggregate 또는 Release로 보고하는 문서에서만 나열됩니다. 서버가 연결된 뒤에야 생겨나는 명령은 그것이 가장 필요한 바로 그때 — 아무것도 실행되지 않고 있고 그것을 시작할 방법을 찾고 있을 때 — 명령 색인에서 빠져 있게 됩니다.
왼쪽의 상태 표시줄 표시기에서 무슨 일이 일어나고 있는지 알 수 있습니다. 표시기는 running, starting 또는 빨간색 not running을 표시하며, 그 툴팁이 이유를 알려 줍니다. 이 창의 어떤 폴더도 Aggrega가 인식하는 폴더가 아니거나, 그런 폴더가 있지만 서버가 연결되어 있지 않은 경우입니다. 클릭하면 해당하는 쪽인 Start 또는 Restart를 제공하고 실행합니다.

이 표시기가 존재하는 이유는 실행할 수 없는 명령은 아무것도 설명하지 않기 때문입니다. 명령 색인은 이유를 말하지 않고 그 명령을 빼 버리며, 비활성화된 컨트롤에 툴팁을 보여 주는 편집기 화면은 없습니다. 표시기는 이유가 적히는 곳이자 그에 따라 조치하는 곳이기도 합니다.
시작에 실패하면 컴파일러 경로에 무엇이 잘못되었는지 알려 줍니다. aggrega.server.binaryPath가 아무것도 가리키지 않으면 알림에 Aggrega language server failed to start: the compiler at ⟨path⟩ was not found.(Aggrega 언어 서버를 시작하지 못했습니다: ⟨path⟩의 컴파일러를 찾을 수 없습니다.)가 표시되고, 실행할 수 없는 파일을 가리키면 … ⟨path⟩ is not an executable file.(… ⟨path⟩은(는) 실행 파일이 아닙니다.)가 표시됩니다. ⟨path⟩는 확장이 시작하려고 한 파일입니다. ~/ 또는 ${userHome}으로 시작하는 설정은 찾을 때와 같이 홈 폴더를 기준으로 해석된 형태로 표시됩니다. 둘 다 이어서 aggrega.server.binaryPath를 aggrega 바이너리로 설정하라고 안내하며, 설정 화면에서 그 설정 하나를 여는 Open binary path setting과 Show output을 함께 제공합니다. 경로가 아무것도 가리키지 않을 때는 그 두 개 앞에 Download the compiler와 Choose another file도 제공합니다. 이때는 교체할 컴파일러가 없기 때문입니다. 앞의 것은 컴파일러 받기에서 설명하는 대로 컴파일러를 내려받고, 뒤의 것은 가지고 있는 컴파일러 파일을 물어 설정이 그 파일을 가리키게 합니다. 존재하지만 실행할 수 없는 파일은 직접 둔 것이므로, 그 알림은 다운로드를 제공하지 않습니다. 그 밖의 시작 실패는 같은 시작 문구 뒤에 전달받은 이유를 제시하고, 이어서 실행된 컴파일러와 그것을 지정하는 설정을 알려 줍니다. Aggrega 출력 채널에도 같은 설명이 기록됩니다.
Validate는 서버가 실행되고 있지 않다고 알리고 돌아갈 방법을 제공합니다. 언어 서버가 실행되고 있지 않을 때 누르면 Aggrega: the language server is not running.(Aggrega: 언어 서버가 실행되고 있지 않습니다.)이라고 응답하고 — 마지막 시작이 실패했다면 그 실패가 보고된 말 그대로 그 이유가 이어집니다 — Show output, Open binary path setting, 그리고 상태 표시줄 표시기 자체의 Start를 제공합니다.
목록 패널은 실패를 보고하는 대신 서버가 실행되고 있지 않다고 알립니다. 언어 서버가 실행되고 있지 않으면 Registries 패널과 Catalog 패널은 각각 목록 자리에 The Aggrega language server is not running.(Aggrega 언어 서버가 실행되고 있지 않습니다.)을 표시기 자체의 툴팁과 함께 그리며, 그 행을 누르면 서버가 시작됩니다. Plugins 패널의 목록은 언어 서버가 아니라 컴파일러를 명령으로 실행하여 얻으므로, 그 명령을 시작할 수 없었을 때는 그 행이 알림의 문구로 경로에 무엇이 잘못되었는지 알려 주며, 누르면 해당 설정이 열립니다.
Aggrega: Open status bar menu 명령은 언어 서버가 응답하지 않는 동안 명령 색인에서 빠집니다. 그것이 제공하는 모든 것이 실행 중인 언어 서버에 대한 작업이며, 편집기는 그곳에서 실행할 수 없는 명령을 나열하지 않기 때문입니다. 서버가 응답하는 순간 다시 나타납니다.
서버 없이도 작동하는 명령은 명령 색인에 남아 있습니다. 서버와 관련된 명령이라도 마찬가지입니다. Aggrega: Toggle the artifact-rendering stage while inspecting은 기본 설정을 기록하고, 서버는 시작할 때 그 기본 설정을 읽습니다. 따라서 서버가 중지되어 있을 때가 그것을 설정하기에 가장 유용한 때이지, 그것을 숨길 이유가 아닙니다.
수명 주기
확장은 언어 서버 프로세스의 전체 수명 주기를 관리합니다. 언어 서버를 중지할 때(편집기가 닫힐 때, 언어 서버가 다른 Aggrega 작업 공간으로 이동할 때, 또는 연결할 단일 작업 공간이 더 이상 없을 때) 확장은 먼저 언어 서버에 협조적으로 종료하도록 요청하여 진행 중인 작업이 끝나도록 합니다. 유예 시간이 끝날 때까지 언어 서버가 여전히 작업 중이면 한 번 더 요청하는데, 이번에는 작업을 끝내는 대신 포기하도록 요청합니다. 그래도 종료되지 않으면 확장은 OS 수준의 종료로 대체합니다. 재시작(재시작 명령, aggrega.server.binaryPath 변경, 또는 확장이 직접 수행한 구성 변경)은 요청하지 않고, 운영 체제 수준에서 프로세스를 종료한 뒤 새 프로세스를 시작합니다. 이러한 각 단계는 Aggrega 출력 채널에 보고되므로, 종료가 느릴 때 어느 단계에서 시간이 걸리는지, 그리고 언어 서버가 응답하기는 했는지 알 수 있습니다. 의미는 POSIX와 Windows 호스트에서 동일합니다.
요청 없이 중지된 언어 서버는 제한된 횟수만큼 다시 시작됩니다. 실행 중인 서버가 종료되면 확장은 새 서버를 시작합니다. 그 서버도 종료되면(시작하는 도중, 확장의 첫 요청에 응답하기 전, 또는 실행 중에) 차례로 다시 시작되며, aggrega.server.respawnWindowSeconds초 안에 최대 aggrega.server.respawnAttempts회까지 재시작됩니다. 마지막 재시작 이후의 종료는 서버를 중지된 상태로 두고, 서버를 다시 시작하는 명령을 알려 주는 Aggrega language server has stopped responding.(Aggrega 언어 서버가 응답을 멈췄습니다.)를 표시하며, 그 이후로는 아무것도 서버를 저절로 다시 시작하지 않습니다. 따라서 시작할 때마다 종료되는 서버는 그 횟수만큼만 다시 시작되고 그 이상은 시작되지 않습니다. Aggrega 출력 채널은 각 단계를 말로 설명합니다. 서버가 예기치 않게 중지되었다는 것과 어떻게 종료되었는지, 각 재시작과 설정이 허용하는 횟수, 올라오지 않은 재시작과 그 이유, 그리고 더 이상 다시 시작되지 않는다는 것입니다. 사용자가 요청한 중지나 재시작(재시작 명령, aggrega.server.binaryPath 변경, 또는 확장이 직접 수행한 구성 변경)은 횟수에 포함되지 않으며, 재시작하면 횟수를 처음부터 다시 셉니다. 첫 시작과 사용자가 요청한 재시작은 실패해도 반복되지 않으며, 각각 언어 서버를 시작하지 못했다는 알림과 그 이유로 끝납니다.
모든 언어 서버는 자신이 보고하는 내용으로 Problems 패널을 시작합니다. 서버가 시작될 때(첫 서버, 어떻게 요청되었든 재시작된 서버, 마지막 서버가 예기치 않게 중지된 후 다시 시작된 서버, 다른 Aggrega 작업 공간으로 이동한 서버, 그리고 실행 중인 서버가 없던 곳에서 시작된 서버) Problems 패널에서 이전 서버가 보고한 모든 내용이 비워지고, 열려 있는 모든 YAML 파일은 새 서버가 응답하는 즉시 새 서버를 기준으로 검사됩니다. 서버는 보고한 내용을 철회할 수 없고 그 뒤에 시작된 서버는 그것이 무엇이었는지 알지 못하므로, 남아 있는 결과는 실행 중인 어떤 서버도 뒷받침하지 않는 결과가 됩니다. 이동한 후라면 떠나온 작업 공간에 관한 결과입니다. 열린 파일을 검사하는 동안 결과가 잠깐 사라졌다가 다시 나타납니다. 다른 요청만 계산하는 결과는 그 요청이 다시 실행될 때까지 나타나지 않습니다. 빌드의 결과는 그래프가 그려지거나 빌드 또는 미리 보기 빌드가 실행될 때 돌아오고, 잠금 파일의 드리프트 경고는 그래프가 그려질 때 돌아오며(해당 Release에 그래프 패널이 열려 있으면 서버가 돌아올 때 다시 그려지므로 둘이 동시에 돌아옵니다), 게시 관례에 관한 결과는 Lint를 실행할 때 돌아옵니다. 중지된 후 대체되지 않는 서버(재시작 횟수를 모두 소진했거나 연결할 Aggrega 작업 공간이 없는 경우)는 Problems 패널을 그대로 둡니다.
언어 서버는 시작할 때 구성을 읽고, 중지될 때까지 그 구성을 유지합니다. 명령줄은 실행할 때마다 구성을 새로 읽으므로, .aggrega-config.yaml이나 ~/.config/aggrega/config.yaml을 편집하면 터미널의 동작은 즉시 바뀌지만 이미 실행 중인 언어 서버에서는 아무것도 바뀌지 않습니다. 그래서 확장은 실행 중인 서버가 읽었다고 보고하는 구성 파일(Show config가 기여한 파일로 나열하는 파일 경로)을 감시하며, 그중 하나가 디스크에서 변경되거나 삭제되거나 다시 나타나 서버가 읽은 내용과 더 이상 일치하지 않으면, 해당 파일을 지목하고 언어 서버가 시작할 때 구성을 읽는다고 알려 주는 경고를 하나 표시합니다. 이 경고에는 Aggrega: Start or restart the language server를 실행하는 Restart server 버튼이 있습니다. 한 번의 저장으로 생긴 여러 번의 쓰기는 경고 하나만 표시합니다. 경고가 화면에 있는 동안에는 그 파일에 대해 다시 표시되지 않으며, 경고를 닫은 후에도 파일이 다시 변경될 때까지는 표시되지 않습니다. 재시작하면 재시작된 서버가 읽은 내용을 기준으로 감시가 새로 시작됩니다. 서버가 시작될 때 존재하지 않았던 구성 파일은 읽히지 않았으므로 감시되지 않으며, 그런 파일을 만들어도 아무것도 표시되지 않습니다. 다음 시작 때 읽힙니다. 어떤 파일을 감시하는지는 서버가 시작될 때마다 Aggrega 출력 채널에 기록됩니다.
확장이 직접 수행하는 구성 변경은 묻지 않고 언어 서버를 재시작하여 적용됩니다. 레지스트리 추가 또는 제거, 시작 페이지에서 레지스트리 초기 설정, 플러그인 추가 또는 제거, 시작 페이지에서 작업 공간 구성 생성, 그리고 파일을 만들어야 하는 경우의 Aggrega: Set authoring_release in .aggrega-config.yaml… 뒤에는 각각 재시작이 이어집니다. 재시작이 진행되는 동안에는 서버가 곧 읽을 파일을 알려 주는 알림이 표시되며, 이들 중 어느 것도 경고를 표시하지 않습니다. 그 변경은 사용자가 요청한 것이기 때문입니다. 작업 공간 구성을 생성할 때 언어 서버 자체가 시작되는 경우(실행 중인 서버가 없었거나 다른 폴더를 위해 실행 중이었던 경우) 그 시작에서 새 파일을 읽으며, 두 번째 재시작은 이어지지 않습니다. 변경 후에 시작된 언어 서버가 변경 사항을 읽고 나면, 작업 자체의 마무리 메시지에 변경이 이제 적용되었다는 문장 하나가 추가되며, 두 번째 알림은 표시되지 않습니다. 재시작이 실패했거나 변경을 읽을 언어 서버가 실행 중이지 않았다면, 그 문장은 생략됩니다. 그 경우 변경은 파일에 있지만 아직 적용되지 않았기 때문입니다. authoring_release 설정은 문장 대신 파일을 여는 것으로 끝나므로 아무것도 추가하지 않습니다.