Esse repositório contém o código-fonte do aplicativo móvel PRACTICE. Esse aplicativo conta com uma imensa equipe que trabalhou com muito carinho para atender você da melhor forma possível. São quase trinta pessoas em equipes de desenvolvimento, conteúdo, design, mídia, auxílio-gerencial e comunicação!
IMPORTANTE: o aplicativo está disponível para download na Google Play.
O Programa de Ampliação e Consolidação de Tecnologias e Inovação no Contexto Educacional (PRACTICE) é um programa multi-campi da Universidade Federal da Fronteira Sul (UFFS). O aplicativo PRACTICE permite que seus usuários usufruam das tecnologias e conteúdos criados por nós. O objetivo desse aplicativo é fornecer acesso fácil a informações para a comunidade acadêmica de todos os seis campi pertencentes à UFFS. Com um toque, você pode acessar o calendário acadêmico, os horários de ônibus, o cardápio do RU, conversar com a Aura, nossa Assistente Virtual, e muito mais! E claro, inteirar nossos solicitantes sobre suas demandas, tendo o recurso de notificação vinculado ao Mural, nosso sistema de atendimento.
Você precisa ter NodeJS versão >=13.8 instalado no seu sistema. Depois, rode:
npm i framework7-cli cordova -g
Faça um fork deste repositório em seu próprio GitHub e clone seu fork em seu computador:
git clone https://github.com/SEU_USUARIO/app-practice && cd app-practice
Mude para o branch dev e instale todas as dependências:
git checkout dev
npm install
Para testar o projeto localmente, rode:
npm start
O browser abrirá apontando para o endereço http://localhost:8080/ para você acessar o app. Se estiver usando o Chrome, pressione F12 para abrir as Ferramentas de Desenvolvedor e visualizar a página como se fosse um celular.
Para ser possível gerar o APK do aplicativo é necessario instalar o Android SDK, o JDK 8 e também o Gradle. Caso haja mais de uma versão do JDK instalada no computador é necessário selecionar a versão 8 para ser utilizada. Além disso, é necessário configurar as seguintes variaveis de ambiente: JAVA_HOME, ANDROID_HOME e ANDROID_SDK_ROOT.
O Android SDK pode ser instalado tanto manualmente quanto por meio da instalação do Android Studio (sendo esta ultima possívelmente a mais simples). Com o SDK instalado é necessário também aceitar as licenças do Android, caso a instalação do SDK tenha sido feita por meio do Android Studio basta acessar Configurações > SDK Manager > SDK Tools, instalar Google Play Licensing Library e aceitar as licenças.
Por fim, é preciso instalar o Gradle e a instalação deste pode variar de acordo com o sistema operacional utilizado.
Além disso, para gerar o apk com o plugin do fcm adicionado é necessário:
- Garantir que a linha
<widget id="cc.uffs.practice" version="0.4.0" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">do arquivoconfig.xmlpossua o id igual ao nome do pacote criado no firebase. - Caso o pacote criado possua um nome diferente do que esta previamente configurado no arquivo
config.xmlé necessario remover e readicionar a plataforma android por meio do cordova. - Adicionar o arquivo
google-services.jsongerado pelo firebase à pasta/cordova/platforms/android/app/src/google-services.json
Para fazer build (dev) da aplicação, rode:
npm run build-dev
A aplicação pronta para uso estará no diretório www na raiz do respositório. Você também pode fazer um build de produção, rode:
npm run build-prod
Para fazer um build e deploy para a Google Play, você precisa de um ambiente de desenvolvimento Android disponível na máquina. Instale, por exemplo, o Android SDK e afins (Grade, JDK, etc). Para build nesse projeto, você precisa do JDK 1.8 e de uma versão especifica do node (instale o nvm, por exemplo).
Instale o Cordova:
npm install -g cordova
Instale as dependencias:
npm run install-deps-cordova
Faça um build da aplicação:
npm run build-dev-cordova
Faça os testes cabíveis, como instalar em algum dispositivo Android o .apk gerado no processo.
Após gerar o .apk é necessário verificar se a permissão para utilizar a câmera foi adicionada ao arquivo: cordova/platforms/android/app/src/main/AndroidManifest.xml. Para isso basta verificar se o mesmo possui uma linha com o conteúdo: <uses-permission android:name="android.permission.CAMERA" />. Caso não possua, é necessário adicionar esta linha para que o aplicativo consiga acessar a câmera do dispositivo, após isso basta executar o comando novamente para gerar um novo .apk do aplicativo.
Se tudo estiver certo, para fazer deploy (final) na Google Play, rode:
npm run build-prod-cordova
Sua ajuda é muito bem-vinda, independente da forma! Confira o arquivo CONTRIBUTING.md para conhecer todas as formas de contribuir com o projeto. Por exemplo, sugerir uma nova funcionalidade, reportar um problema/bug, ou simplemente utilizar o projeto e comentar sua experiência.
Veja o arquivo ROADMAP.md para ter uma ideia de como o projeto deve evoluir.
Esse projeto é licenciado nos termos da licença open-source MIT e está disponível de graça.
Veja todas as alterações desse projeto no arquivo CHANGELOG.md.
Os ícones e o logo utilizados nesse aplicativo foram feitos por diversos artistas de www.flaticon.com. Icons made by Freepik, Eucalyp, Smashicons, Surang, Monkik, Iconixar, Photo3idea-studio, Ultimatearm, PongsakornRed, Nhor Phai, Payungkead, Mynamepong, Good Ware, Xnimrodx, Srip from www.flaticon.com.