Ruta
Un punto de entrada navegable, un menú de destinos, cada uno apuntando al componente que aporta su contenido.
Una Ruta define una superficie navegable de una app de Xuda: un menú de destinos, cada uno una ruta o una etiqueta asignada al Componente que la renderiza. Las Rutas viven en su propia rama del árbol de Studio, separada de Programas y Base de datos, y una misma app puede declarar varias, un sitio público, un panel de administración, un shell móvil, cada una como su propio documento Ruta.
Propiedades
studio_meta.parentId es por defecto routes, la raíz del árbol de Rutas. A diferencia de Programas y Base de datos, el árbol de Rutas no admite carpetas anidadas, cada Ruta está directamente bajo esa raíz.
La lista de valores permitidos de properties.menuType del comprobador (CHK_MSG_OBJ_GEN_105) omite route, así que cada documento Ruta genera "invalid properties.menuType" en la lista de problemas aunque check_route ejecute sus propias comprobaciones reales (CHK_MSG_RTE_MNU_010/020/030) justo a su lado. No impide guardar ni desplegar una ruta; es ruido que conviene esperar e ignorar en la salida del comprobador, no una señal de que la ruta esté mal configurada.
routeMenu
Cada entrada de menu necesita un prog_id que nombre el Componente que aporta su contenido; si falta, o nombra un programa que el proyecto no tiene, es un error del comprobador. Los elementos pueden anidarse (children) y cada uno lleva campos de visualización como bgColor / bgTextColor para su estado activo, rellenados por el editor de Rutas.
Ejemplo práctico
Lista los destinos
Una entrada de menú por pantalla: un título y el _id del Componente que abre.
Elige uno por defecto
default_menu_id nombra la entrada que se muestra cuando la ruta se abre por primera vez.
Apunta un Componente a ella
La mayoría de las apps también reflejan la ruta como interfaz de navegación literal (pestañas, una barra lateral), con el xu-on:click de cada botón llamando a call_page con el id del Componente de destino, de modo que la ruta sigue siendo la fuente de verdad y la interfaz se mantiene sincronizada con ella.
En Rutas, en el árbol de Studio, añade una ruta y luego construye su menú en el editor de Rutas: añade un elemento, ponle una etiqueta y elige el Componente que debe abrir.
Una ruta no tiene forma de código fuente .xu; los proyectos de xuda-cli la declaran como un archivo .route.json5. Su clave sencilla prog se compila a routeMenu.menu[].prog_id en el documento de Studio.