Qué hace WU CLI
Entiende cómo la CLI prepara un proyecto WU y te acompaña desde la primera app hasta los archivos de producción.
Consulta las versiones, cambios y requisitos en Framework 4.0 y CLI 1.2.
WU CLI es la herramienta de terminal que prepara y desarrolla proyectos WU. Con el comando wu puedes crear la página que reúne tus aplicaciones, añadir una app, iniciar el desarrollo y construir los archivos que vas a publicar.
El trabajo que te ahorra
Una aplicación React y otra Vue tienen sus componentes, dependencias y comandos de compilación. Para mostrarlas juntas también necesitas un shell: la página que reserva sus espacios y decide cuándo aparecen.
La CLI genera esa estructura y guarda la relación entre shell y apps en wu.config.json. La carpeta que los reúne se llama workspace. Desde su raíz puedes instalar las dependencias del proyecto, acceder al desarrollo por un mismo origen HTTP y reunir los builds en dist/.
CLI y framework tienen trabajos distintos
| Herramienta | Dónde la utilizas | Qué hace |
|---|---|---|
@wu-framework/cli |
En la terminal, mediante wu |
Genera archivos, instala dependencias, desarrolla y construye el proyecto. |
wu-framework |
En el código de la aplicación | Carga y monta las apps; coordina eventos, estado, llamadas y permisos. |
La CLI prepara el proyecto que abre el usuario; el runtime sigue coordinando las apps cuando ese proyecto está publicado. Si aún no conoces la relación entre app, shell y runtime, empieza por Qué es WU.
El recorrido habitual
Empieza con una sola app y comprueba que aparece en el shell. Añade más cuando ya puedas reconocer las piezas del proyecto.
| Paso | Comando | Resultado que debes reconocer |
|---|---|---|
| Crear | wu create |
Una carpeta con el shell, la primera microapp y wu.config.json. |
| Instalar | wu install |
Dependencias preparadas para los comandos del proyecto. |
| Desarrollar | wu dev |
El shell y las apps accesibles en el navegador durante el desarrollo. |
| Añadir otra app | wu add <framework> <name> |
Una nueva carpeta de app y su entrada en la configuración. |
| Construir | wu build |
Los archivos de producción reunidos en dist/. |
| Revisar producción | wu serve 4100 |
El contenido de dist/ servido localmente por HTTP. |
Puedes repetir el ciclo añadir → instalar cuando corresponda → desarrollar antes de construir. wu add intenta instalar por defecto; con --no-install aplazas la instalación hasta ejecutar wu install.
wu serve permite revisar lo construido. Para publicarlo, entregas los archivos de dist/ a tu plataforma de hosting; la CLI no incluye un comando deploy.
Hazlo paso a paso
- Tu primera app: prepara el entorno, genera el shell y comprueba una microapp en el navegador.
- Añade otra app: incorpora otro framework y distingue sus archivos de los de la primera app.
- Prepara producción: construye, sirve el resultado y comprueba lo que vas a publicar.
Las plantillas de CLI 1.2.0 declaran wu-framework: ^4.0.0. Consulta Instalación y versiones.
Dónde trabajar dentro del proyecto
| Archivo o directorio | Qué encontrarás allí |
|---|---|
wu.config.json |
La relación entre shell y apps, sus comandos y las opciones del workspace. |
shell/ |
La página anfitriona y su navegación. |
mf-*/ |
Los componentes y dependencias de cada microapp. |
dist/ |
El resultado de wu build, preparado para revisar y publicar. |
Edita las fuentes de shell/ o de la microapp que corresponda. El contenido de dist/ vuelve a generarse en cada build. Configuración explica los campos de wu.config.json; Crear y Añadir detallan las opciones de los generadores.
Cuando necesites consultar un comando
Usa wu --help para ver la ayuda general y wu --version para comprobar la versión. Para revisar un proyecto, wu info muestra la configuración detectada y wu doctor inspecciona su coherencia.
La referencia de comandos reúne argumentos, resultados y límites. Estas son las opciones reconocidas en la versión documentada:
La CLI incluye wu catalog para consultar las versiones generadas y wu upgrade para migrar manifiestos y plantillas existentes. wu update actualiza la CLI; wu upgrade prepara el proyecto; wu install instala sus dependencias. Consulta el recorrido de migración.