Uma extensão para o Visual Studio Code que automatiza a criação de novos projetos Angular com PO UI, pré-configurados para o ecossistema Protheus.
Funcionalidades Principais ✨
Criação com um Comando: Gere um projeto completo e configurado a partir de um único comando na paleta do VS Code.
Build e Empacotamento .App: Compile e empacote seu projeto Angular em um arquivo .app pronto para deploy no Protheus com um único comando.
Integração Protheus: Instala e configura automaticamente as dependências essenciais como @totvs/protheus-lib-core e @totvs/po-theme.
Estrutura Organizada: Move os templates para arquivos externos, mantendo o código da extensão limpo e facilitando futuras atualizações.
Inicialização Inteligente de Git: A extensão verifica se a pasta de destino já é um repositório Git. O comando git init só é executado se necessário, evitando reinicializações acidentais.
Fluxo de Trabalho Amigável: Acompanhe todo o processo através de notificações de progresso e, ao final, abra o novo projeto em uma nova janela com apenas um clique.
Como Usar
Criar Novo Projeto
Abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P no macOS).
Digite PO UI: Criar Novo Projeto Protheus e pressione Enter.
Informe o nome do seu novo projeto.
Selecione a pasta onde o projeto será criado.
A extensão cuidará de todo o resto!
Build e Empacotar Projeto (.app)
Após desenvolver seu projeto, você pode gerar o pacote .app para deploy no Protheus:
Abra seu projeto Angular no VS Code.
Abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P no macOS).
Digite PO UI: Build .App e pressione Enter.
Aguarde o processo de build e empacotamento.
O arquivo .app será gerado na pasta dist/ do seu projeto.
O que o comando faz:
✅ Executa ng build para compilar o projeto
✅ Localiza automaticamente a pasta de distribuição
✅ Compacta os arquivos usando PowerShell
✅ Renomeia o arquivo para .app (formato esperado pelo Protheus)
✅ Compilação Automática (Novo): Se você tiver a extensão TOTVS Developer Studio instalada e conectada a um servidor, o build tentará compilar automaticamente o arquivo .app gerado no repositório (RPO).
O Que a Extensão Faz? ⚙️
O comando automatiza os seguintes passos para você:
Cria um novo projeto Angular com o Angular CLI.
Inicializa um repositório Git (se ainda não existir).
Adiciona os componentes do PO UI (@po-ui/ng-components).
Adiciona os templates do PO UI (@po-ui/ng-templates).
Instala a Protheus Lib Core (@totvs/protheus-lib-core).
Instala o tema do Protheus (@totvs/po-theme).
Configura o angular.json com os estilos e assets necessários, incluindo o favicon.ico.
Cria arquivos essenciais para a integração, como appConfig.json, interceptors de desenvolvimento e módulos.
Instala todas as dependências do projeto com npm install.
Executa o build e gera o pacote .app pronto para deploy.
Ao final, oferece para abrir o projeto recém-criado em uma nova janela do VS Code.
Pré-requisitos
Antes de usar a extensão, garanta que você tenha as seguintes ferramentas instaladas:
TOTVS Developer Studio for VSCode (Opcional, mas Recomendado): Importante para funcionalidades avançadas como a compilação automática do .app gerado. Sem ela, o arquivo será apenas criado na pasta, mas não compilado para o Protheus.
Licença
Este projeto é distribuído sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
