com.police.finder

Chama a Polícia!

Aplicação móvel para procurar a autoridade policial próxima de si.

O código está desenhado em Javascript para ser corrido num smartphone. Para tal faz uso da plataforma Apache Cordova.

Requisitos

Apache Cordova

Este projeto faz uso de Apache Cordova para converter código HTML5 e Javascript para uma aplicação de dispositivo móvel, como Android ou iOS. Precisa, portanto, de ter Apache Cordova instalado na sua máquina.

Node JS

O projeto necessita de alguns pacotes npm, sendo que o npm vem instalado com o nodejs. Alguns scripts do projeto também fazem uso do nodejs.

gradle

O gradle é usado para fazer o build dos projetos Apache Cordova

Java

É uma exigência do Apache Cordova

ADB

O ADB é usado para testar a APP no seu telemóvel Android

Como instalar e testar

• Clone este projeto git clone https://github.com/jfoclpf/police-finder
• Entre na pasta recém criada cd police-finder
• Adicione a plataforma. Para Android cordova platform add android.
• Corra cordova build android para construir o projeto na sua máquina. Em Android cria o ficheiro APK na pasta platforms/android/build/outputs/apk

Testar num smartphone

Para testar num smartphone Android precisa de ativar nas configurações do smartphone o Developer options e dentro desse menu precisa de ativar a opção USB debugging.

Depois corra numa linha de comandos

adb devices

para listar os dispositivos Android detectados. Caso o dispositivo seja detetado, corra

cordova run android --device

Para fazer debug no Chrome aceda a chrome://inspect/#devices

Eventuais problemas com Gradle

O gradle é um executor de tarefas de compilação e é instalado aquando de cordova build. Pode dar problemas nesse comando (erro: Could not determine java version from 'x.x.x'). O gradle pode envolver diferentes versões:

• a versão global: gradle -v
• a versão local do project (wrapper): ./platforms/android/gradlew -v

Tal pode dar problemas porque diferentes versões de gradle dependem de diferentes versões de java. Verificar a variável JAVA_HOME com echo $JAVA_HOME. Para resolver o problema mudar esta variável e associá-la a outras versões de java, por exemplo:

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64/ ou
export JAVA_HOME=/usr/lib/jvm/jdk1.8.0_131/ ou
mesmo apagar com export JAVA_HOME=

Plugins necessários

• ver ficheiro package.json.

Contribuições são muito bem-vindas

• respeite a estrutura dos ficheiros
• comente sempre o código (preferencialmente em Inglês), tal ajuda os outros a compreender as suas contribuiçes
• para identações, use sempre 4 espaços (não use 2 espaços, nem tabulaçes, ou seja TAB)

Licença

GNU GPLv3
http://www.gnu.org/licenses/gpl-3.0.en.html
http://choosealicense.com/licenses/gpl-3.0/

Na comunicação social

• Jornal Económico
• Jornal de Notícias
• Diário de Notícias
• Time Out
• Notícias ao Minuto
• Tek Sapo
• Nit
• Turbo