davidpvilaca / es-na-palma-da-mao-mobile-vnext

ES na Palma da Mão Mobile

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ES na palma da mão

O ES NA PALMA DA MÃO é um programa do Governo do Estado do Espírito Santo que reúne iniciativas e serviços do Governo em plataforma móvel (aplicativo) e web, com unidade de experiência do cidadão. Por meio do ES NA PALMA DA MÃO, diversos serviços governamentais podem ser acessados através da web e dispositivos móveis (sistemas operacionais iOS e Android) utilizando uma interface comum.

==================================================================================================================================================================

Tabela de Conteúdo

Principais Tecnologias Utilizadas

Essas são as principais ferramentas, frameworks e libraries que dão suporte ao projeto:

TypeScript é uma linguagem para desenvolvimento JavaScript em larga escala. Com TypeScript podemos escrever código utilizando uma estrutura fortemente tipada e ter este código compilado para JavaScript puro. Nem todas as features do ES2105 já são suportados pelos browsers. TypeScript permite desfrutar de todas as novas características da linguagem hoje, covertendo código ES2015 em código equivalente em ES5. Qualquer navegador. Qualquer host.

Angular é um framework estrutural para aplicações web dinâmicas.

Ionic é um framework que visa a criação de aplicações híbridas para dispositivos móveis.

Scripts de build para projetos ionic usando o webpack como tecnologia subjacente.

webpack é um empacotador de módulos (javascript e cia) que cria bundles de assets à partir das dependências(assets) do projeto.

  1. Permite fazer o pré-processamento de arquivos “diferentes” (coffee, es6, ts, sass, less, jade, imagens, etc) que os tornam “utilizáveis” através de função require() ou import(ES2015);
  2. Possibilidade de carregar dependências sob demanda (code splitting), sem precisar colocar tudo num grande e pesado bundle.

SASS é uma poderosa extensão da linguagem CSS que permite uma escrita profissional e completa das folhas de estilo de forma muito mais dinâmica e produtiva.

Visão Geral

Build System

O build system do ES na Palma da Mão usa o npm, ionic-app-scripts e webpack.

ionic-app-scripts usa webpack para tratar as seguintes questões:

  • Transpila código typescript para ES2015
  • Carrega arquivos HTML como módulos
  • Transpila .scss em .css e o adiciona ao DOM
  • Atualiza o browser e recompila se arquivos são alterados
  • Hot module replacement para CSS
  • Gera o bundle da aplicação
  • Carrega todos os módulos

npm:

  • Chamadas às todas a tarefas úteis em tempo de desenvolvimento. Encapsula chamadas ao ionic-app-scripts, além de outras.

Dependências

Ferramentas necessárias para rodar a aplicação:

obs: o ionic e o cordova são instalados no escopo global (-g).

Instalando

  1. fork este repositório pelo GitHub
  2. clone o seu fork: git clone <url-github-fork>
  3. acesse o diretorio criado: cd es-na-palma-da-mao-mobile-vnext
  4. instale as dependências da aplicação: npm install
  5. renomeie o arquivo '.env.example' para '.env': cp .env.example .env

Executando

O ES na Palma da Mão usa ionic-app-scripts para compilar a aplicação e executar o ambiente de desenvolvimento. Depois de instaladas todas as dependências, você deve rodar a aplicação. O comando ionic serve. Isso irá iniciar o build utilizando o ionic, vai gerar um bundle da aplicação, subir um servidor de desenvolvimento e escutar por alterações em todos os arquivos.

Por padrão a aplicação será servida em http://localhost:3000.

Executando no dispovitivo móvel para teste

Com o celular plugado no PC e reconhecido pelo sistema.

  1. npm run build:android
  2. cordova platform add android@7.1.1
  3. cordova prepare android -f
  4. cordova run android

Autenticação

Ambiente sandbox de autenticação

Para acessar a versão completa do ES na palma da mão, é necessário uma conta no Acesso Cidadão. Mas mesmo sem uma conta é possível acessar a maioria dos serviços. Para teste locais esse passo não precisa ser executado.

O ES na palma da mão executado a partir do código fonte usa uma versão sandbox do acesso cidadão, exclusiva para developers. As contas de usuário criadas no sandbox não são válidas no acesso cidadão real, usado pelos cidadãos para acessar os serviços oferecidos pelo Governo do ES.

About

ES na Palma da Mão Mobile

License:Other


Languages

Language:TypeScript 68.3%Language:HTML 16.1%Language:CSS 14.3%Language:JavaScript 1.2%Language:Shell 0.2%