Kalliope-app

The Ionic app code for Kalliope

Installation

NodeJs

First install nodejs. We suggest to use the node version manager

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash

Make sure you are using at least the node v10.9.0:

nvm install 10
nvm use 10
nvm current
>>> v10.9.0

ionic & Cordova

The application is based on Ionic(and cordova)

npm install -g ionic cordova

cordova --version
>>> 8.0.0
ionic --version
>>> 4.1.1

clone the kalliope-app repo

Clone this repo:

git@github.com:kalliope-project/kalliope-app.git

or by using https:

https://github.com/kalliope-project/kalliope-app.git

Install the node dependencies :

cd /pathOfTheProject/kalliope-app/kalliope/
npm install

Start kalliope Core

Make Sure your Kalliope Core is running :

Under your "Kalliope Core" directory:

The API and CORS must be allowed in the kalliope Core "setting.yml" file. Then starts the Kalliope CORE :

kalliope start

run the application on your browser

Under this fresh cloned repo, access the "kalliope" directory and run the ionic server :

ionic serve -b

The application is now running and accessible using your browser : "http://localhost:8100"

In case the application is missing the 'cordova' package to run on the browser you can run :

ionic cordova run browser

Builds/run for mobile device

Android

Requirement

• Java 8 SDK (Note: greater version of java are not supported by ionic yet)

sudo apt-get install openjdk-8-jdk

java -version
>>> openjdk version "1.8.0_181"
>>> OpenJDK Runtime Environment (build 1.8.0_181-8u181-b13-0ubuntu0.18.04.1-b13)
>>> OpenJDK 64-Bit Server VM (build 25.181-b13, mixed mode)

javac -version
>>> javac 1.8.0_181

• Android 8.1 SDK (Oreo)
• Gradle 4.4
• Build Tools
• Android Virtual Device (AVD)

You can install them manually but it is strongly recommended to install Android Studio which brings most of them. "https://developer.android.com/studio/"

Export env variables (add to your .bashrc):

 export ANDROID_HOME=~/Android/Sdk
 export PATH=${PATH}:${ANDROID_HOME}/tools
 export PATH=${PATH}:${ANDROID_HOME}/platform-tools

 export PATH=$PATH:$GRADLE_HOME/bin

Run on your phone

• Install all the cordova android plugin by setting up an ionic platform:

ionic cordova platform add android@7.1.0

Note: You might need to define the JAVA_HOME and gradle wrapper version with:

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
export CORDOVA_ANDROID_GRADLE_DISTRIBUTION_URL=https\://services.gradle.org/distributions/gradle-4.4-all.zip

• Activate the Debugger mode on your Android phone.

• Run the app on Android device directly

ionic cordova run android

Note: running the app with the option -c does not work !

Debug

• You have access to log using Android Studio and Logcat.
• On your AVD console.
• Running Chrome -> Developper Tools -> Remote Device

Release

Create an APK

ionic cordova build android --release

iOS

• TODO