Never Pummel Muskoxen

    com.police.finder

    1.1.2 • Public • Published

    js-standard-style Donate

    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

    1. Clone este projeto git clone https://github.com/jfoclpf/police-finder
    2. Entre na pasta recém criada cd police-finder
    3. Adicione a plataforma. Para Android cordova platform add android.
    4. 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

    Keywords

    none

    Install

    npm i com.police.finder

    DownloadsWeekly Downloads

    5

    Version

    1.1.2

    License

    GPL-3.0

    Unpacked Size

    19.8 MB

    Total Files

    143

    Last publish

    Collaborators

    • jfolpf