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
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.
- 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);
- 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.
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.
Ferramentas necessárias para rodar a aplicação:
node + npm
versão LTS: https://nodejs.org/en/download/- ionic:
npm i -g ionic
- cordova:
npm i -g cordova
obs: o ionic e o cordova são instalados no escopo global (-g).
fork
este repositório pelo GitHub- clone o seu fork:
git clone <url-github-fork>
- acesse o diretorio criado:
cd es-na-palma-da-mao-mobile-vnext
- instale as dependências da aplicação:
npm install
- renomeie o arquivo '.env.example' para '.env':
cp .env.example .env
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.
Com o celular plugado no PC e reconhecido pelo sistema.
npm run build:android
cordova platform add android@7.1.1
cordova prepare android -f
cordova run android
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.