O que a WU CLI faz
Entenda como a CLI prepara um projeto WU e acompanha você desde a primeira app até os arquivos de produção.
Veja versões, mudanças e requisitos em Framework 4.0 e CLI 1.2.
A WU CLI é a ferramenta de terminal que prepara e desenvolve projetos WU. Com o comando wu, você pode criar a página que reúne suas aplicações, adicionar uma app, iniciar o desenvolvimento e construir os arquivos que serão publicados.
O trabalho que ela poupa
Uma aplicação React e outra Vue têm seus componentes, dependências e comandos de compilação. Para mostrá-las juntas, você também precisa de um shell: a página que reserva seus espaços e decide quando aparecem.
A CLI gera essa estrutura e salva a relação entre shell e apps em wu.config.json. A pasta que os reúne se chama workspace. A partir de sua raiz, você pode instalar as dependências do projeto, acessar o desenvolvimento por uma mesma origem HTTP e reunir os builds em dist/.
CLI e framework têm trabalhos diferentes
| Ferramenta | Onde você a utiliza | O que faz |
|---|---|---|
@wu-framework/cli |
No terminal, por meio de wu |
Gera arquivos, instala dependências, desenvolve e constrói o projeto. |
wu-framework |
No código da aplicação | Carrega e monta as apps; coordena eventos, estado, chamadas e permissões. |
A CLI prepara o projeto que o usuário abre; o runtime continua coordenando as apps quando esse projeto está publicado. Se você ainda não conhece a relação entre app, shell e runtime, comece por O que é WU.
O percurso habitual
Comece com uma única app e verifique se ela aparece no shell. Adicione mais quando já conseguir reconhecer as partes do projeto.
| Etapa | Comando | Resultado que você deve reconhecer |
|---|---|---|
| Criar | wu create |
Uma pasta com o shell, a primeira microapp e wu.config.json. |
| Instalar | wu install |
Dependências preparadas para os comandos do projeto. |
| Desenvolver | wu dev |
O shell e as apps acessíveis no navegador durante o desenvolvimento. |
| Adicionar outra app | wu add <framework> <name> |
Uma nova pasta de app e sua entrada na configuração. |
| Construir | wu build |
Os arquivos de produção reunidos em dist/. |
| Revisar a produção | wu serve 4100 |
O conteúdo de dist/ servido localmente por HTTP. |
Você pode repetir o ciclo adicionar → instalar quando aplicável → desenvolver antes de construir. wu add tenta instalar por padrão; com --no-install, você adia a instalação até executar wu install.
wu serve permite revisar o que foi construído. Para publicar, você entrega os arquivos de dist/ à sua plataforma de hospedagem; a CLI não inclui um comando deploy.
Faça passo a passo
- Sua primeira app: prepare o ambiente, gere o shell e verifique uma microapp no navegador.
- Adicione outra app: inclua outro framework e diferencie seus arquivos dos da primeira app.
- Prepare a produção: construa, sirva o resultado e verifique o que será publicado.
Os templates da CLI 1.2.0 declaram wu-framework: ^4.0.0. Consulte Instalação e versões.
Onde trabalhar dentro do projeto
| Arquivo ou diretório | O que você encontrará ali |
|---|---|
wu.config.json |
A relação entre shell e apps, seus comandos e as opções do workspace. |
shell/ |
A página anfitriã e sua navegação. |
mf-*/ |
Os componentes e as dependências de cada microapp. |
dist/ |
O resultado de wu build, preparado para revisar e publicar. |
Edite as fontes de shell/ ou da microapp correspondente. O conteúdo de dist/ é gerado novamente a cada build. Configuração explica os campos de wu.config.json; Criar e Adicionar detalham as opções dos geradores.
Quando precisar consultar um comando
Use wu --help para ver a ajuda geral e wu --version para verificar a versão. Para revisar um projeto, wu info mostra a configuração detectada e wu doctor inspeciona sua coerência.
A referência de comandos reúne argumentos, resultados e limites. Estas são as opções reconhecidas na versão documentada:
A CLI inclui wu catalog para consultar versões geradas e wu upgrade para migrar manifestos e templates existentes. wu update atualiza a CLI; wu upgrade prepara o projeto; wu install instala suas dependências. Consulte o percurso de migração.