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 a instalação do Java

ADB

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

Eventuais problemas com versões do Java

Um problema comum pode estar relacionado com as versões do Java. Para saber a versão corra java -version e javac -version (compilador).

Em Debian/Ubuntu para escolher a versão correta, corra sudo update-alternatives --config javac. Em macOS, por exemplo, export JAVA_HOME=/usr/libexec/java_home -v 1.11.

Edite também a variável JAVA_HOME em conformidade com a versão pretendida.

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=

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

Testar num emulador

Instalar o emulador

[sudo] sdkmanager --install "emulator"

Instalar as plataformas de teste, exemplo:

[sudo] sdkmanager --install "system-images;android-32;google_apis;x86_64"
[sudo] sdkmanager --install "system-images;android-33;google_apis;x86_64"

Criar o dispositivo virtual (AVD), exemplo:

avdmanager create avd -n emulator -k "system-images;android-32;google_apis;x86_64"

Confirmar que ficou instalado

avdmanager list avd

Correr o emulador

cordova emulate android --target=emulator

Plugins necessários

  • ver ficheiro package.json.