Elige la Release en la que trabajas
Release seleccionada — un indicador en la barra de estado y una fila Release en la parte superior del panel Commands, que indican cada uno la única Release con la que trabaja el editor. Todo lo que actúa sobre una Release —la validación, el grafo de topología, la compilación, la compilación de vista previa y la descarga— actúa sobre esa. Un panel de grafo ya abierto conserva la Release a partir de la cual se dibujó cuando seleccionas otra, y volver a mostrar el grafo dibuja la recién seleccionada. El grafo, la compilación, la compilación de vista previa y la descarga leen los directorios de catálogo con los que se compila esa Release: los suyos propios, donde la configuración de tu espacio de trabajo indica algunos para ella en workspace.releases, y en caso contrario los del espacio de trabajo; los mismos que lee aggrega build --release en una terminal, de modo que una sola ventana compila cada Release de un espacio de trabajo con su propio catálogo sin ningún flag que pasar. El panel Catalog, una inspección, la comprobación de la fila Catalog, el hover, el autocompletado, Go to Definition, Find References y Find Implementations también responden en términos de la Release seleccionada: donde la configuración de tu espacio de trabajo indica directorios de catálogo para cada Release, cada uno lee los documentos que contiene el espacio de trabajo excepto los de un directorio que solo lee otra Release, y los directorios de catálogo con los que se compila la Release seleccionada; así, un nombre que declaran varias variantes, una por Release, se resuelve en la de la Release seleccionada. Sin ninguna Release seleccionada, responden en términos del propio espacio de trabajo. Consulta Seleccionar una Release.
Seleccionar una Release
Casi todo lo que hace la extensión está acotado a una Release: qué directorios de catálogo se leen, qué componentes se resuelven, qué pines del lockfile se aplican y qué hallazgos recibe un documento. Por eso la extensión trabaja con una Release seleccionada a la vez, y te muestra cuál en la barra de estado, junto a un icono de cohete.
La ventana del editor recuerda la Release que eliges. Cuando el servidor de lenguaje se conecta, una elección recordada se contrasta con lo que el workspace sigue ofreciendo y se restaura si sigue ahí; si ha desaparecido, el editor te lo indica y recurre a lo que implica tu workspace, que es donde empieza la selección cuando no has elegido nada en esta ventana. Esa respuesta procede de, por orden de precedencia:
build.authoring_releaseen.aggrega-config.yaml, la configuración confirmada en el repositorio que comparte todo un equipo..aggrega/active-release, un archivo marcador local que no se confirma en el repositorio.- La única Release del workspace, cuando hay exactamente una.
Haz clic en cualquiera de los dos indicadores para seleccionar otra Release (o ejecuta Aggrega: Select Release… desde la Command Palette). El cambio surte efecto de inmediato — nada se reinicia, cada archivo YAML abierto se vuelve a comprobar con la Release que acabas de elegir y el panel Catalog vuelve a leer su lista para ella; lo mismo ocurre cuando se adopta una Release al conectarse el servidor de lenguaje. Que se recuerde es local a la ventana del editor: elegir no escribe nada en tu workspace. Si el foco estaba en el panel Commands cuando se abrió el selector — en su fila Release o en cualquiera de sus controles —, vuelve a ese control cuando el selector se cierra, tanto si elegiste una Release como si lo descartaste; abierto desde cualquier otro lugar, el selector deja el panel sin el foco.

Las Releases que se ofrecen son las que hay dentro de la carpeta a la que se ancló el servidor de lenguaje, nombradas en relación con ella, porque esa es la forma que acepta. Cuando una Release no puede ofrecerse, el editor dice cuántas son y dónde están en lugar de omitirlas en silencio. El servidor de lenguaje no lee ninguna Release a través de un enlace que salga de esa carpeta, así que una Release que el árbol de archivos de tu editor muestra a través de un enlace que sale de ella — un enlace a un directorio externo, o a un archivo de Release externo — no se ofrece. La única excepción es un enlace a un archivo de Release que la configuración del workspace nombra, como build.authoring_release o como clave de workspace.releases: esa Release se lee a través de su enlace y se ofrece. Al abrirse, el selector lo indica en una notificación propia, nombrando por su ruta relativa a esa carpeta cada uno de esos enlaces situado donde el servidor de lenguaje leería de otro modo: primero los enlaces a directorios, después los enlaces a archivos. Un enlace cuyo nombre termina en .yaml o .yml se nombra contenga lo que contenga el archivo al que lleva, porque ese archivo no se lee para averiguarlo.
Cuando quieres que una elección quede registrada en el propio workspace — para que un checkout nuevo empiece con ella —, dos comandos lo hacen, y ninguno cambia aquello en lo que estás trabajando ahora mismo:
- Aggrega: Set the selected Release as this workspace’s default hace que el servidor de lenguaje escriba la Release seleccionada actualmente en
.aggrega/active-release. Ese archivo es local a tu checkout, así que es el lugar adecuado para un valor predeterminado personal. Cuando.aggregao el marcador es un enlace que sale del workspace de Aggrega, no se escribe nada, y la notificación recoge las propias palabras del compilador sobre el motivo. - Aggrega: Set authoring_release in .aggrega-config.yaml… abre el archivo de configuración para que puedas establecer
build.authoring_release. Esa configuración se confirma en el repositorio y se comparte, y tiene prioridad sobre el archivo marcador. Cuando el servidor de lenguaje informa de que el archivo de configuración es un enlace que sale del workspace de Aggrega, el archivo no se abre, y un error indica que sale del workspace, por lo que Aggrega no lo usa; el control de la página de bienvenida que crea una configuración del workspace hace lo mismo con un archivo que ya encuentra allí.
Si el workspace no ofrece ninguna Release — ninguna configurada, ningún marcador y no exactamente un archivo al que recurrir —, el indicador lo dice, y dice cuál de dos cosas es cierta. Muestra Release: none selected cuando hay Releases entre las que elegir y no estás en ninguna, y Release: none available cuando el workspace de Aggrega no ofreció ninguna. La segunda no es un estado al que puedas responder eligiendo, así que su tooltip nombra las salidas — trabajar en otro workspace de Aggrega, o crear una Release — en lugar de enviarte a una lista que solo puede volver vacía. Cuando nada ha leído todavía el workspace, el tooltip lo dice en lugar de informar de un recuento que nadie hizo. Cada una de esas indicaciones incluye lo que se buscó, y el informe completo se escribe en el canal de salida de Aggrega. La validación sigue ejecutándose en ese estado: obtienes los hallazgos que un documento responde por sí solo — si se analiza y si su propia forma es admisible — y las comprobaciones que necesitan una Release se omiten hasta que selecciones una.