Skip to content

totvs/generator-totvs-dev

Repository files navigation

generator-totvs-dev

NPM version Build Status Dependency Status

Generator for Totvs Web Developers

Instalação

Primeiro, instale os módulos do Yeoman, generator-totvs-dev e Bower usando o npm (estamos assumindo que você já tenha instalado e se familiarizado com node.js e o git).

npm install -g bower
npm install -g yo
npm install -g generator-totvs-dev

Segundo, gere sua nova aplicação usando o generator:

mkdir meu-projeto && cd meu-projeto
yo totvs-dev

Terceiro, baixe as bibliotecas do TOTVS HTML Framework e do Kendo UI que devem ser instalados manualmente por conta das suas licenças comerciais. Os termos de cada licença deve ser respeitado pelos desenvolvedores.

Salve os arquivos na pasta meu-projeto\src\app\js\libs.

O THF foi criado para funcionar independente da plataforma de backend, porém caso você queira executar o projeto para verificar se ele foi corretamente configurado você pode usar um servidor http como o http-server:

npm install -g http-server

É importante destacar que o servidor deve ser iniciado na pasta onde está a página inicial index.html

 cd meu-projeto\src\app\
 http-server

Starting up http-server, serving ./
Available on:
  http://127.0.0.1:8080

No seu navegador, acesse http://127.0.0.1:8080.

Configurações

Caso não sejam instaladas as dependências de forma automática, verifique se sua rede não exige a configuração do proxy para o Bower, caso tenha dúvidas consulte a página oficial sobre o arquivo .bowerrc.

As propriedades que precisam ser informadas no arquivo .bowerrc são "proxy" e "https-proxy".

Após a configuração execute do bower para instalar as dependências manualmente.

bower install

Se tiver dificuldades em instalar o pacote angular-hotkeys configure seu git para que o mesmo use o protocolo https em vez do protocolo git.

git config --global url."https://".insteadOf git://

Lei mais sobre as configurações do git na página oficial.

Generator

Ao executar o generator algumas perguntas devem ser preenchidas antes da aplicação ser gerada.

  1. Your project name: Nome do projeto
  2. Project title: Título para o seu projeto
  3. Project description: Descrição do seu projeto
  4. Current version: Versão do projeto
  5. Repository: Repositório que será hospedado o projeto
  6. Home page: Home page do projeto
  7. Single Page Application: Modelo da aplicação será um SPA (Single Page Application)
  8. Create samples: Exemplos que serão gerados junto com a aplicação
    • CRUD
    • Dashboard
  9. Proxy for install dependencies: Especifique um proxy se estiver em uma rede fechada

Screenshots

CRUD (SPA) SPA

Dashboard (SPA) SPA

Menu (Tab) Menu

CRUD (Tab) Menu

Dashboard (Tab) Menu

Copyright

Copyright © 2016 TOTVS

Licença

MIT License